Configure username and password

This page provides information regarding setting up your Jenkins instance to use username and password credentials for communication with your Bitbucket repository.

Create an app password in Bitbucket Cloud

1. Log in to Bitbucket Cloud.

2. Click Settings () in the top-right corner of the page and select Personal Settings. Your Personal Settings page opens.

3. Under Access Management in the left sidebar, select App passwords.

   Open

   

4. Click Create app password.

5. In the Label field, enter a name. We recommend including information about where the password is used.

6. Select the permissions the App password needs. You should have read/write or admin access.

7. Click Create. The New app password dialog opens.

   Open

   

8. Copy the generated password. You will not be able to view the password again once you close the dialog. This is the password you will use when configuring Jenkins.

Jenkins configuration

There are different methods for accessing the Jenkins Credentials Provider page. This section describes how to add a new username and password to Jenkins through a Jenkins job and through global credentials.

Credentials Provider through a Jenkins job

1. Log into your Jenkins instance.

2. Add or select the job you want to associate with your Bitbucket repository.

3. Once you are in the job, click Configure from the left menu.

4. When the Configuration page opens, select the Source Code Management tab.

5. Select the Git option.

   Open

   

6. In the Repository URL field, enter the URL for the Bitbucket repository Jenkins will integrate with.

7. Click Add to open the Jenkins Credentials Provider dialog.

8. Select Username with password from the Kind pulldown list.

   Open

   

9. Provide the following information:
   Scope - leave this at the default Global credentials setting.
   Username - the Bitbucket username associated with the repository set in the Repository URL field.
   Password - the app password for the Bitbucket username associated with the repository.
   Treat username as secret (optional)- select to mask the username in the build log.
   ID (optional) - set this to help better identify this specific configuration. If left blank, Jenkins generates an ID.
   Description (optional) - add a description to help differentiate between credentials.

10. Click Add.

11. In the Credentials field, select the credentials you just created from the list.

    Open

    

12. Click Save.

Credentials Provider through global credentials

1. Log in to your Jenkins instance with your administrator credentials.

2. From the Jenkins dashboard, click on Manage Jenkins in the left sidebar.

3. Scroll down to the Security section and click Credentials.

4. Click (global) under the Domain column from an existing credentials entry or under the Domains column for an entry in the Stores scoped to Jenkins section to proceed to the Global credentials (unrestricted) page.

5. Click Add Credentials.

6. In the Kind dropdown, select Username with password.

7. Provide the following information:
   Scope - leave this at the default Global credentials setting.
   Username - the Bitbucket username associated with the repository set in the Repository URL field.
   Password - the app password for the Bitbucket username associated with the repository.
   Treat username as secret (optional)- select to mask the username in the build log.
   ID (optional) - set this to help better identify this specific configuration. If left blank, Jenkins generates an ID.
   Description (optional) - add a description to help differentiate between credentials.

8. Click Create.

9. When configuring a Jenkins job that requires Bitbucket Cloud access, select the credentials from the Credentials dropdown menu.