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. 

   Scroll Down to OAuth consumers, then click Add Consumer.
   

   

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

   • Click on “Save”
     

4. 

   Expand the newly created “ZillaConnector” and copy the following

   1. Key → Client ID (in Zilla)

   2. Secret → Client Secret (in Zilla)

   3. The workspace name (required in Zilla for Bitbucket config) can be seen in the URL. ( ex. tomfzilla ) 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, groups and repositories' permissions can be seen in the Accounts tab while repositories can be seen on the Resource tab.

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