Configure Bitbucket Posting User

Code reviews for your Bitbucket Server repositories will be posted as a "PullRequest" member of your Bitbucket team. In order to post code reviews, the user must be created in your Bitbucket.

Prerequisites

The Bitbucket posting user must be created by an individual on your team with the following administrative permissions:

Create Posting User

Log in to your Bitbucket instance as an admin and create a new user with the username PullRequest. This will be the user that posts comments in your repositories.

Add the PullRequest user to all of the repositories you want code review on. Be sure to grant the user WRITE permission so it's able to post comments.

PullRequest will never write or modify code in your repositories. Read more about how we keep your data secure here.

Apply Bitbucket Access Token

Log in to Bitbucket as the PullRequest user.

This may be easier in another browser or an incognito tab so you can remain logged in as the Bitbucket admin user.

Create a personal access token for the PullRequest user in Bitbucket by opening https://our-bitbucket.internal/plugins/servlet/access-tokens/manage in the browser you were logged into as the PullRequest user.

The access token will need to have Projects READ and Repositories WRITE permissions.

Once generated, copy the personal access token to your clipboard so we can configure the connection to Bitbucket.

Connecting the PullRequest Proxy to Bitbucket

Now, it's time to return to that text file we're editing on the proxy server. Go ahead and set the following keys based on what was configured above.

PROVIDER_TYPE=bitbucket
PROVIDER_BASE_URL=https://our-bitbucket.internal
PROVIDER_USERNAME=PullRequest
PROVIDER_ACCESS_TOKEN=<access_token>

Make sure the PullRequest Username is spelled exactly as the username of the PullRequest user that was created. We highly recommend "PullRequest" (all one word, PascalCase) to maintain communication consistency.

Last updated