Connecting Bitbucket
Connect your Bitbucket account to GitSec by installing the GitSec Bitbucket App. This grants GitSec read access to back up your repositories.
- Webhooks can only be added to workspaces where the connected account has admin privileges.
- To enable full webhook support, make sure the account you connect has admin privileges on the relevant workspaces.
- So for the best practice, create an user in your Atlassian and authorize this user with admin privileges for the workspaces which will have Bitbucket App for Gitsec.
Install the Bitbucket App
- In the sidebar, navigate to Repositories > Add Provider.
- Click the Bitbucket card (GitLab is coming soon).
- You will be redirected to Bitbucket to authorize the GitSec app.
- Choose which account to install the app on.
- Click Grant Access to complete the authorization.
The Bitbucket account must have a workspace for the connection of Bitbucket App. If not there will be an error as "No Bitbucket Workspace" through the process.
After installation, you will be redirected back to GitSec. Your connected repositories will appear under Repositories > Bitbucket.
Provider Installations
The Add Provider page also displays a Provider Installations table that shows all Bitbucket app installations associated with your account. Each installation shows:
- Installation ID — The unique identifier for the installation.
- Account — The Bitbucket account.
- Status — Whether the installation is active.
What Permissions Does GitSec Need?
The GitSec Backup App requires read-only access to your repositories. It does not modify your code, branches, or settings.
| Permission | Level | Purpose |
|---|---|---|
| Repository contents | Read | Back up code and commits |
| Pull requests | Read | Back up pull request data |
| Metadata | Read | List and identify repositories |
The Restore App is a separate Bitbucket App that requires write access to create or push to repositories. It is only installed when you need to restore a backup. See Restore Overview for details.
Managing Connected Repositories
Once connected, go to Repositories > Bitbucket to see all your repositories. From there, you can include or exclude individual repositories from backups. See Managing Repositories for more information.
Next Steps
With Bitbucket connected, you're ready to create your first backup.