Jenkins

Configuring the Veza integration for Jenkins

Overview

The Veza integration for Jenkins enables the discovery of Users and Roles, and permissions. One configured, Veza uses Jenkins APIs to populate the Authorization Graph with entities and metadata. The integration supports project-based Matrix Authorization and role-based access controls.

To enable the integration:

Jenkins Setup

Create a user and API token for the Veza integration:

  1. Create a Jenkins user for the integration. Log in to Jenkins and go to Dashboard → Manage Jenkins → Users → Create User. Enter the name, password, and email-address and save your changes.

  2. Assign them a role with the Overall Read permission under Manage Jenkins > Manage and Assign Roles.

  3. Get an API token for the user. Browse to your Jenkins instance, log in and go to (Your Username) > Configure > API Token.

  4. Click Add New Token. Give the token a name and save the value.

Veza Setup

Add the integration to Veza:

  1. Browse to your Veza instance and log in.

  2. Go to Integrations.

  3. Click Add Integration. Select Jenkins as the integration to add. Click Next.

  4. Complete the required fields:

    • Jenkins Token: the token you created for the integrations.

    • URL: URL of the Jenkins environment. Ensure the URL ends with a /.

    • Username: Integration user name.

  5. Click Save to enable the integration.

Supported Entities

ID and Name are collected for both users and roles. Veza discovers and processes all permissions found in Jenkins.

Jenkins User

A Jenkins User represents an account with specific permissions and roles within the Jenkins automation server. This entity is subject to access control with varying levels of permissions, such as read, write, and execute, on different Jenkins resources.

Jenkins Role

A Jenkins Role is a set of capabilities assigned to a Jenkins User or group of users within Jenkins.

Last updated