Bitbucket

Firefly integrates with Bitbucket to connect your infrastructure code repositories with your cloud resources. This integration enables powerful features like tracing cloud resources back to their defining code ("Jump to Code") and automatically creating Pull Requests for newly codified resources and drift remediation.

Prerequisites

• A Bitbucket account with access to your infrastructure repositories.

• Appropriate permissions to create App passwords.

• Repositories containing Terraform, CloudFormation, or other IaC files you want to connect to Firefly.

Setup Procedure

1. Log in to your Bitbucket account.

2. Click on your Avatar on the top right panel, then click on All workspaces.

3. Select the workspace Firefly will be integrated with.

4. Click on the Settings icon on the top right panel (to the left of your Avatar) and select Workspace settings.

5. Please scroll down in the left panel and click on OAuth consumer.

6. Click on the Add consumer to create new integration with Firefly.

   • Select a name for the application.

   • Add description (optional).

   • In the Callback URL, please paste the following URL: https://app.firefly.ai/integrations/bitbucket-integration

   • In the Permission section, please select the following:

     • Account: read

     • Repositories: write and admin

     • Pull requests: Write

     • Webhooks: Read and write Note: All the permissions must be selected for the integration to be successful.

7. Scroll to the bottom of the page and click Save. You will be directed to the OAuth consumers where you can see the newly created consumer.

8. Click on the new consumer to see its details:

   • Please copy the Key and paste it in Firefly's Bitbucket Integration page in the Consumer Key field.

   • Please copy the Secret and paste it in Firefly's Bitbucket Integration page in the Consumer Secret field.

9. After filling in the information, please click the Authorize button in Firefly's Bitbucket Integration page.

10. In the new page that opens, please press Grant Access. Note: You must authorize for the integration to be successful.

11. After authorizing the new application, you will be redirected back to Firefly's application.

12. After the integration is completed, please enter your Bitbucket account email in the Bitbucket Email and the workspace name in the Workspace Name field. Click the Create Integration to check if the workspace exists.

13. When the validation is complete, click on the Next button for webhooks to be installed.

Integrate Bitbucket Data Center

1. Enter the domain for your Bitbucket Data Center instance and paste the app password into the App Password box.

Features Enabled

• Jump to Code: Trace resources in your cloud inventory back to the Bitbucket file and specific line that defines them.

• Automated Pull Requests: When Firefly codifies an unmanaged resource, it can commit the new infrastructure code as a Pull Request.

• IaC Tracking: Firefly maintains awareness of which resources are defined in code and which are not.

• Drift Remediation: Firefly can detect drift between the code and the actual resources and create a Pull Request to fix it.