Atlassian Bitbucket Integration

Authentication through OAuth 2.0

Kindor supports OAuth 2.0 to connect to Atlassian Bitbucket. The following document explains the steps to follow to perform this connection.

Kindor will connect to your Bitbucket organization through an OAuth app that you will need to create in your Atlassian Account.

To ensure optimal access to your Bitbucket organization's repositories metadata, we recommend creating a dedicated user account for Kindor. This user will be used for the execution of the OAuth flow, as explained later. It's worth noting that access tokens inherit their privileges from the user account under which they are generated, and thus, Kindor will never ask for the user's credentials.

Please consider that for each new repository introduced within your Bitbucket organization, it's imperative to grant privileges to this user. This allows Kindor to effectively monitor these new repositories, access their metadata, and generate insights. Kindor will only analyze the repositories it has access to.

The management of this user's privileges rests with you. You have the authority to adjust access to repositories within your Bitbucket organization as needed. Essentially, you can control Kindor's access to your Bitbucket organization by modifying this user's privileges. For example, if your Bitbucket organization encompasses repositories that you don’t want monitored, Kindor won't access data unless the user account created has appropriate read permissions for these repositories.

Create an OAuth Consumer

• On the top right section of your Atlassian Bitbucket home page, select Workspace settings

• Select OAuth consumers on the left menu and Add consumer

• Fill the following fields:

  • Name: Kindor AI

  • Callback URL: https://oauth.kindor.co

  • Enable This is a private consumer checkbox

• Check the following permissions and Save the configuration:

• After saving the configuration, a Key and Secret will be generated, please share that information with Kindor

  
  

• Kindor will send you an URL after receiving the Key and Secret

  
  

• Open the URL and authorize the installation of the OAuth App that you created in your Atlassian Bitbucket account