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 bitbucket_username is a bitbucket username who has access to the repository. It is necessary for Bitbucket API calls
• Add "password": "<bitbucket_password>" under "bitbucket" node
  Where bitbucket_password is the password for the given bitbucket user. It is necessary for Bitbucket API calls. After you save the configuration the password will be encrypted

Example:

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.