Jenkins Integration Setup

Getting Started

BalkanID recommends creating a separate service account for the purposes of this integration, instead of using personal or employee named accounts.

Requirements:

• Username

• Jenkins-URL

• Token

Generating API Token

Jenkins provides an API token for users to authenticate and access its REST API. Follow the steps below to generate an API token for your user account. Make sure an administrator account is used for generating the token.

1. Log in to the Jenkins instance as an administrator.

2. Click on “Manage Jenkins” in the Jenkins dashboard.

3. Click on “Manage Users“.

4. Select the user for whom you want to generate an API token and click on their name to access their user configuration page.

5. Generate a token using the “Add new token” section of the user configuration page.

6. Click on the “Copy” button to copy the token to the clipboard.

7. Save the configurations.

Configure Jenkins within your BalkanID tenant

1. Login to the BalkanID application and switch to the tenant you would like to add your integration to.

2. Head to Integrations > Third Party Applications and click Add Integration, select Jenkins. Set up the Primary Application owner and the Description, if any.

   
3. Jenkins would have been added to the list of applications. Click on the Configure and Integrate button beside the integration name, and configure the fields with the values that were noted prior. It should look like this:

   
4. Once you filled in the information, click Save changes. Your integration is now configured and you will see the status of the integration displayed alongside other integrations on the Integrations page. Integrations are synced daily. When data is available, the integration Status column will read Connected and the integration Message will read Data available.