1. Open a browser and log in to BitBucket.
2. Browse to your avatar, then click on Personal Settings.
3. Click on the menu item under Access Management labeled App passwords.
4. On the resulting page, click on Create App Password
5. Enter a name in the label for you to remember what this connection is.
6. Check the following boxes
- Team Membership > Read
- Repositories > Read
- Issues > Write & Read
7. The result should look something like this:
8. Click Create
9. Copy the resulting App Password to your clipboard.
10. In a 2nd browser window, open Nucleus and browse to Project Administration > Connectors.
11. Under the Issue Trackers section, click the BitBucket icon.
12. In the Setup BitBucket Connector popup, complete the following fields:
- BitBucket URL: Enter the URL to the API of your BitBucket server or cloud instance
- Note: If you are using the Nucleus tunnel, please skip the rest of this document and start at the beginning of this resource: Setting up a Connector through the Nucleus Tunnel
- Project: Enter the project name for which this connector is set up. For example, rampant/demo
- Application Password: Enter the password which was generated in the BitBucket console (the one copied to your clipboard)
13. Click the "Save Connection" button and wait for the Success message.
14. Click the "Verify Connection" button. You will be a message to notify you that the connection test was successful. Your connector is now set up properly.
15. Optional: Select a user from the Default Assignee dropdown menu in order to have that user be the default user when manually assigning issues so you don't have to select from the dropdown every time.
16. Close the popup window.
Please Note: Only users which are on the repo's team will be able to have tickets assigned to them. BitBucket does not allow for users which are not on the team but assigned to the repo to be accessed through the API.