Connect Bitbucket Cloud
Dexter reads repositories in Bitbucket Cloud to build its code catalog (Knowledge > Code) and to correlate an incident with recent changes. It only reads: it never writes to a repository.
Step 1: Create an access token
Dexter authenticates with a Bitbucket access token. It sends the token as a bearer token, so app passwords and Atlassian API tokens, which use basic authentication, do not work.
Which access token you can create depends on your Bitbucket plan:
| Token | Plan | What Dexter can read |
|---|---|---|
Workspace access token |
Premium |
Every repository in the workspace |
Repository access token |
Any plan |
That one repository |
-
In Bitbucket, open the token page:
-
Workspace token: Workspace settings > Security > Access tokens.
-
Repository token: in the repository, Repository settings > Security > Access tokens.
-
-
Click Create access token.
-
Set Expiry. The default is one week, after which Dexter’s code catalog silently empties. Choose the longest date your workspace allows.
-
Select the read scopes:
-
Workspace token: Repositories: Read and Projects: Read.
-
Repository token: Repositories: Read. Add Pull requests: Read to let Dexter see pull requests.
-
-
Click Create and copy the token. Bitbucket shows it only once.