Git apps
Last updated
Last updated
Git app integration is a mechanism that allows you to control access to repositories and users from your git provider and not inside Brainboard.
Which means that with this integration, users don't use their personal git tokens.
When doing Pull Requests, Brainboard sends the information on behalf of the user creating the PR to be able to track who does what. Refer to Pull Requests page for more information about how it works.
Here are the supported git providers that provide git app integrations:
GitHub.
Azure DevOps (coming soon).
If you use another git provider (Gitlab, Azure DevOps and Bitbucket), please refer to this page for integration.
To create integration between Brainboard and GitHub:
Go to the Git apps settings page.
Click on Add GitHub integration button:
You'll be redirected to the GitHub website, where you can choose the organization for which you want to configure access:
After selecting the organization, you are prompted to specify the repositories:
N.B: Brainboard requires read-write access to be able to do pull requests.
After selecting the repositories, you'll be automatically redirected to Brainboard Git app settings page. Now the button should have changed to View GitHub integration.
Brainboard Enterprise SSO users: If your organization uses Brainboard Enterprise SSO for authentication, the redirection to Brainboard app will fail after selecting the repositories. In this case, please contact our support to update your GitHub installation_id.
Once your GitHub integration is configured, please create a personal GitHub token in the personal git tokens settings page to be able to use GitHub features in Brainboard.
To edit the GitHub integration:
Go to the Git apps settings page.
Either click on View GitHub integration button:
Or click on the three dots located in the top-right, then click on Edit integration:
You'll be redirected to the GitHub website, where you can edit the integration with Brainboard.
To delete integration with GitHub:
Go to the Git apps settings page.
Click on the three dots located in the top-right, then click on Delete integration:
You'll be redirected to the GitHub website, where you can delete the integration with Brainboard.
The update will be immediate, and you will no longer be able to do pull requests.
