# Jenkins Integration

Jenkins is a widely used CI/CD automation server that helps teams build, test, and deploy software efficiently.

By integrating Jenkins with Sprinto, you can automatically monitor user access and ensure that only authorised users have access to your CI/CD environment.

This integration helps organisations:

* Track Jenkins user accounts
* Monitor access to Jenkins environments
* Validate role assignments
* Ensure offboarded users do not retain access

Sprinto uses this integration to automate **Access Review** controls and checks.

***

## Prerequisites

Before connecting Jenkins to Sprinto, ensure the following:

* You have **administrator access** to your Jenkins instance.
* Your Jenkins instance is accessible via a **public URL or reachable endpoint**.
* You can generate a **Jenkins API token**.

{% hint style="info" %}

#### Note

The Jenkins integration requires the **People View plugin** to be installed. Sprinto uses this plugin to retrieve user information from Jenkins.

If the plugin is not installed, **user synchronisation will fail and the integration will not function**. Installing the People View plugin is a **mandatory requirement** for this integration.
{% endhint %}

Here is the **same section rewritten without images**, aligned with the **Microsoft Writing Style Guide and Sprinto documentation style**.

***

### Install the PeopleView plugin in Jenkins

Sprinto requires the **PeopleView plugin** to sync users from Jenkins. If this plugin is not installed, **user synchronisation will fail**, and the integration will not work correctly.

Follow these steps to install the plugin.

#### Step 1: Open Jenkins settings

1. Log in to your **Jenkins dashboard**.
2. Click the **Settings** icon in the top-right corner of the page.

<figure><img src="https://3220032727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEsyn5VMU6e0OyGjRtKgx%2Fuploads%2Fom26ws5wRMbEe3AnV1b9%2FScreenshot%202026-03-06%20at%204.35.26%E2%80%AFPM.png?alt=media&#x26;token=d628e529-971b-4caf-a00a-0fd128489bf5" alt="" width="563"><figcaption></figcaption></figure>

#### Step 2: Open the Plugins page

1. On the **Manage Jenkins** page, locate **Plugins** under the **System Configuration** section.
2. Click **Plugins** to open the Jenkins plugin manager.

<figure><img src="https://3220032727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEsyn5VMU6e0OyGjRtKgx%2Fuploads%2FdhCwNqeLeHNH2JF25Vn3%2FScreenshot%202026-03-06%20at%204.35.56%E2%80%AFPM.png?alt=media&#x26;token=39517219-f635-4351-9dcb-0b0ea341ff4c" alt="" width="563"><figcaption></figcaption></figure>

#### Step 3: Search for the PeopleView plugin

1. In the Plugins page, select **Available plugins** from the left sidebar.
2. In the search bar, enter **People View**.

<figure><img src="https://3220032727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEsyn5VMU6e0OyGjRtKgx%2Fuploads%2FONhdSxmbB9UqGhevXZlF%2FScreenshot%202026-03-06%20at%204.40.11%E2%80%AFPM.png?alt=media&#x26;token=8cc7040f-be6c-4df0-8358-3588ff47c985" alt="" width="563"><figcaption></figcaption></figure>

#### Step 4: Install the plugin

1. Locate **People View** in the search results.
2. Select the **checkbox** next to the plugin.
3. Click **Install**.

<figure><img src="https://3220032727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEsyn5VMU6e0OyGjRtKgx%2Fuploads%2FVmAxKdo4gnVwKmJ8B8Fs%2FScreenshot%202026-03-06%20at%204.40.40%E2%80%AFPM.png?alt=media&#x26;token=4b52d73c-8ee9-4c5a-922b-e6cbe5df107d" alt="" width="563"><figcaption></figcaption></figure>

Jenkins begins downloading and installing the plugin.

#### Step 5: Verify installation

1. After installation starts, Jenkins displays the **Download progress** page.
2. Wait until the installation status shows **Success**.
3. After the installation completes, the plugin is ready to use.

<figure><img src="https://3220032727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEsyn5VMU6e0OyGjRtKgx%2Fuploads%2FMlCpu60YlW9oGyQ0dn2F%2FScreenshot%202026-03-06%20at%204.41.24%E2%80%AFPM.png?alt=media&#x26;token=5ed71ddd-3788-4db0-9547-9984526dfc3d" alt="" width="563"><figcaption></figcaption></figure>

You can now proceed with the **Jenkins integration setup in Sprinto**.

***

## Permissions Required

Sprinto requires **read-only access** to retrieve user and role information.

<table><thead><tr><th width="169.90234375">Permission</th><th width="433.92578125">Purpose</th></tr></thead><tbody><tr><td>Full Access: Read</td><td>Allows Sprinto to fetch Jenkins user and role data.</td></tr></tbody></table>

***

## Data Collected by Sprinto

Sprinto retrieves the following information from Jenkins:

* Roles
* Username
* Status
* Primary Email
* 2FA Enabled

This data is used only to monitor access compliance.

***

## Connect Jenkins to Sprinto

### Step 1: Navigate to Integrations

1. Log in to the Sprinto dashboard.
2. Go to **Settings → Integrations**.
3. Under the **All** tab, search for **Jenkins**.
4. Click **Connect** next to Jenkins.

<figure><img src="https://3220032727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEsyn5VMU6e0OyGjRtKgx%2Fuploads%2FW2cO6fQOlBsF3W6fC2pJ%2FScreenshot%202026-03-05%20at%2015.07.26.png?alt=media&#x26;token=9b67b970-e867-4128-b240-7bc21d18724c" alt="" width="563"><figcaption></figcaption></figure>

A connection drawer opens showing:

* Number of controls automated
* Number of checks automated
* Required permissions
* Data used by Sprinto

Review the details and click **Next**.

<figure><img src="https://3220032727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEsyn5VMU6e0OyGjRtKgx%2Fuploads%2F67X3GEidurK2VQZKv18O%2FScreenshot%202026-03-05%20at%2015.08.15.png?alt=media&#x26;token=632fcdc9-4a7e-488b-8d66-0d24f7ba7308" alt="" width="375"><figcaption></figcaption></figure>

***

## Generate Jenkins API Token

Sprinto connects to Jenkins using an API token.

Follow these steps to generate the token.

1. Log in to your **Jenkins dashboard**.
2. Click your **profile icon**.
3. Navigate to **Profile → Configure**.
4. Locate the **API Token** section.
5. Click **Add API Token**.
6. Enter a name for the token\
   Example: `Sprinto Access`
7. Click **Generate**.
8. Copy the generated token and store it securely.

Return to Sprinto after generating the token.

***

## Connect Jenkins Account

After generating the API token:

1. Select the checkbox confirming that you have the credentials.
2. Click **Connect Jenkins**.

<figure><img src="https://3220032727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEsyn5VMU6e0OyGjRtKgx%2Fuploads%2FDveqY1LwsqdOSHYl3wNZ%2FScreenshot%202026-03-05%20at%2015.08.54.png?alt=media&#x26;token=c8a7cf8b-da5e-4fc3-9d3c-1badf4fa4101" alt="" width="375"><figcaption></figcaption></figure>

A configuration screen appears where you must enter:

* **Username**
* **API Token**
* **Jenkins URL**

#### Field Details

<table><thead><tr><th width="157.55078125">Field</th><th width="315.17578125">Description</th></tr></thead><tbody><tr><td>Username</td><td>Jenkins account username</td></tr><tr><td>API Token</td><td>API token generated in Jenkins</td></tr><tr><td>Jenkins URL</td><td>Base URL of your Jenkins instance</td></tr></tbody></table>

***

## Complete the Integration

1. Enter the required details.
2. Click **Connect Jenkins**.

<figure><img src="https://3220032727-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FEsyn5VMU6e0OyGjRtKgx%2Fuploads%2F7noAQfNrrfR6gcVmLZI5%2FScreenshot%202026-03-05%20at%2015.09.36.png?alt=media&#x26;token=c6f749fa-59e4-4a74-a20f-4a86afa16421" alt="" width="375"><figcaption></figcaption></figure>

Once validated:

* The integration becomes active.
* Jenkins will be available as a **critical system for access monitoring**.

***

## Post Connection Flow

Once the Jenkins integration is successfully connected, Sprinto automatically begins syncing user access data.

The integration feeds Jenkins access information into Sprinto’s **Platform Control Framework (PCF)**, which powers automated access monitoring and compliance checks.

Sprinto uses this data to:

* Detect users with access to Jenkins
* Validate role assignments
* Identify unauthorised or excessive access
* Flag offboarded users who still retain access

This data is automatically mapped to relevant **Access Review controls and checks**, eliminating the need to manually configure Jenkins as a critical system.

***

## What Sprinto Monitors

Sprinto automatically validates:

<table><thead><tr><th width="215.73828125">Check</th><th width="489.90625">Description</th></tr></thead><tbody><tr><td>Valid user access</td><td>Ensures only authorised users have access</td></tr><tr><td>Offboarding validation</td><td>Ensures offboarded users no longer have Jenkins access</td></tr><tr><td>Role assignment checks</td><td>Verifies access aligns with defined roles</td></tr></tbody></table>

***

## Sync Behaviour

* Initial sync may take **up to 24 hours**.
* Integration status will show **Active** once connected.
* Access review checks begin running automatically.

***

## Troubleshooting

#### Invalid API Token

Ensure the token:

* Was generated correctly
* Has not expired or been revoked

***

#### Connection Failed

Verify that:

* Jenkins URL is correct
* Jenkins instance is reachable
* Username and API token are valid

***

#### No Users Detected

Confirm that:

* The account used has admin access
* User information is accessible through the Jenkins API