plugBitbucket

The Bitbucket integration connects Interlynk to your Bitbucket workspaces, enabling automated SBOM processing triggered by repository events.


Purpose

  • Automatically ingest SBOMs on push and pull request events from Bitbucket repositories.

  • Map Bitbucket branches to Interlynk environments.

Setup Steps

Interlynk connects to Bitbucket via OAuth.

  1. Navigate to Settings > Organization > Integrations.

  2. Click Bitbucket.

  3. You will be redirected to Bitbucket to authorize the Interlynk application.

  4. Complete the authorization.

  5. After redirect, select the Workspace from the dropdown.

  6. Click Save.

Supported Events

Event
Trigger

repo:push

Code pushed to a branch

pullrequest:created

New pull request opened

pullrequest:fulfilled

Pull request merged

pullrequest:updated

Pull request updated

Required Scopes

Scope
Purpose

Repository read

Access repository contents and metadata

Pull request read

Read pull request details

Webhook read/write

Register and manage webhooks

Security Notes

  • OAuth tokens are encrypted at rest and refreshed automatically.

  • The integration only accesses repositories within the selected workspace.

  • Revoke access from Bitbucket's Personal Settings > App authorizations if needed.

Troubleshooting

Issue
Cause
Resolution

No workspaces visible

OAuth scope too narrow

Re-authorize the Bitbucket integration

Push events not triggering

Webhook not registered on repository

Verify workspace selection and re-save the integration

Token expired and not refreshing

Refresh token revoked

Disconnect and reconnect the Bitbucket integration

Last updated