Configure bitbucket.org webhook

Configure Codebeamer

There are 2 things to do in Codebeamer:

1. Create user(s) who has the same username as the pusher(s) in Bitbucket
2. Add the secret token of the webhook to Codebeamer configuration (see below)

Steps to configure secret token in Codebeamer:

• Go to Codebeamer's System Admin page
• Go to Application Configuration
• Add "scc" node if it is not exist in your json (json root level)
• Add "bitbucket" node if it is not exist in your json under "scc" node
• Add "baseUrl": "https://bitbucket.org/" under "bitbucket" node
• Add username: <bitbucket_username> under bitbucket node, where the bitbucket_username is your email address. It is necessary for Bitbucket API calls.
• Add password: <bitbucket_password> under bitbucket node where bitbucket_password is the API token that you have created. It is necessary for Bitbucket API calls. After you save the configuration, the API token will be encrypted.
  

  "bitbucket" : {
    "baseUrl" : "https://bitbucket.org/",
    "password" : "scoped API token",
    "username" : "your-email-ID"
  
  }
  

Configure bitbucket.org webhook

Steps to configure bitbucket.org webhook:

• Navigate to the Settings page of a repository
• Choose Webhooks menu
• Click on Add webhook
• Fill out the fields
  • Title: Title of your choice
  • URL: <codebeamer_url>/rest/scm/bitbucket/<project_id>
    Where codebeamer_url is the url of your codebeamer and project_id is the id of your project where the Bitbucket repository will belong to after the first webhook execution
    Example: https://codebeamer.com/cb/rest/scm/bitbucket/1
• Status: Active; checked (default)
• Check/Uncheck SSL/TLS according to your Codebeamer server SSL configuration
• Triggers: Repository push (Codebeamer supports only push event)
• Click on Save

Creating APP passwords for Bitbucket users

The basic Bitbucket authentication has been changed since 1 March 2022, to improve account security. Therefore, APP passwords are required for Bitbucket users.

To create the passwords, see App passwords.

In the Application Configuration, the password of the user needs to be replaced by the created App password.