Git apps
Description
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 user their personal git tokens and have no configuration to do in Brainboard.
When doing Pull Requests, Brainboard sends the information on 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.
Supported git providers
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.
Configure GitHub 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:
:::info 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 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 that 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.
Edit GitHub integration
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.
Delete GitHub integration
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.
Last updated