Connecting Bitbucket to Chariot

This guide explains how to connect your Bitbucket organization to Chariot, allowing you to monitor your repositories for security vulnerabilities and sensitive data exposure.

Prerequisites

Before you begin, ensure you have:

• Admin access to your Bitbucket organization
• Permission to create OAuth consumers in Bitbucket
• Access to your Chariot account

Option 1: Install the Chariot Bitbucket App (Recommended)

The easiest way to connect Bitbucket to Chariot is by installing our Bitbucket app:

1. Log into Chariot
2. Navigate to Integrations
3. Find and click on "Bitbucket" in the Source Code Managers section
4. Click the "Install Bitbucket App" button
5. You'll be redirected to Bitbucket to authorize the installation
6. Review and grant the necessary permissions
7. Once approved, you'll be redirected back to Chariot

The app requires the following permissions:

• Read access to repositories
• Read access to pull requests
• Read access to repository webhooks

Option 2: Manual Configuration with OAuth

If you prefer to set up the integration manually or need more granular control, you can use OAuth:

1. Create an OAuth Consumer in Bitbucket:
   • Go to Bitbucket Settings → OAuth consumers
   • Click "Add consumer"
   • Fill in the following details:
     • Name: Chariot
     • Callback URL: https://chariot.praetorian.com/hello
     • Permissions:
       • Repository: Read
       • Pull requests: Read
       • Webhooks: Read
2. After creating the OAuth consumer, you'll receive:
   • A Client ID (Key)
   • A Client Secret
3. In Chariot:
   • Navigate to Integrations
   • Find and click on "Bitbucket"
   • Enter your OAuth token
   • Provide your Bitbucket organization URL (e.g., https://bitbucket.org/your-organization)
   • Click "Connect"

Verifying the Connection

To verify that your connection is working:

1. Navigate to Assets in Chariot
2. Look for repositories from your Bitbucket organization
3. Check the Integrations page to see your connected Bitbucket account

Troubleshooting

Common issues and solutions:

• Unable to Connect: Verify your OAuth token has the correct permissions
• No Repositories Showing: Check that your organization URL is correct
• Authentication Errors: Ensure your OAuth token is valid and hasn't expired

If you continue to experience issues, contact Chariot Support.

Multiple Organizations

You can connect multiple Bitbucket organizations to Chariot. Simply repeat the connection process for each organization you want to monitor.

Managing Your Connection

To manage your Bitbucket connection:

1. Go to Settings → Integrations
2. Find your Bitbucket connection
3. Use the options menu (⋮) to:
   • View connection details
   • Update settings
   • Remove the connection

Additional Resources

• Bitbucket OAuth Documentation
• About Bitbucket Workspace Management
• Creating OAuth Consumers

Need help? Contact our support team for assistance.