Accessing source code in GitLab is what allows Foundational to accurately determine data lineage and analyze pending and historical pull requests.
This setup should take about 5 minutes.
Permissions: To create the necessary Webhook, a group / project maintainer access is required.
The integration works by an API token that you'll provide us with.
Start by going to Foundational's connectors page, click on Bitbucket, then add new Bitbucket access key.
API Access Token
The preferred method is to get a Workspace access token.
If not possible - you can use a Repository access token per repository that you'd like to cover.
Guidelines for the token:
Required permissions:
Repositories: Read
Pull Requests: Read
Webhooks: Write (and Read)
Pipelines: Write (and Read)
Give the token a descriptive name (e.g.
foundational-app), this is the name that'll appear in our comments on your pull requests.Consider setting the token with the longest expiry allowed by your policy, it will minimize future service disruptions.
Set the API access token in the relevant field at Foundational.
Fill in the workspace ID. The workspace ID is the first part of the path in your URL after bitbucket. e.g. https://bitbucket.org/foundational-io means that our workspace ID is foundational-io.
Save the configuration.