Bitbucket

This page outlines the process of configuring and using the Bitbucket API through Zilla to sync groups, permissions, and users.

Steps to Create a Bitbucket Connector

1. Log into Bitbucket and navigate to the settings page of the Bitbucket Workspace you want to sync.
   
   

2. Open

   

   Scroll Down to OAuth consumers, then click Add Consumer.
   
   

   Open

   

3. Enter the following:

   • Name: ZillaConnector

   • Callback URL: https://app.zillasecurity.com/api/auth/callback/bitbucket

   • Check Permissions Account: Read

   • Check Permissions Workspace Membership: Read

   • Check Permissions Repositories: Read and Admin

   • Click on “Save”
     
     

4. Expand the newly created “ZillaConnector” and copy the following and save for the next step:

   1. Key (mapped to Client ID in Zilla)

   2. Secret (mapped to Client Secret in Zilla)

   3. The Workspace name which can be found in the URL, for example tomfzilla in the image below OR click on the Workspace Settings option on the side panel and copy the workspace ID.

5. Copy these values into Zilla’s Bitbucket config.

6. Zilla’s Bitbucket instance syncs users, groups, repositories and repositories' permissions.

7. Users direct assignments either to the workspace or the repository can be seen in the Accounts tab while group direct assignments will be seen in Groups tab and repositories can be seen on the Resource tab.

8. Sample screenshots of the Accounts tab, Groups tab and Resource tab.