Integrate GitLab with BoostSecurity¶
BoostSecurity provides an integration with GitLab that will enable you to inventory your GitLab repositories, conveniently provision security scanners onto those repositories, and visualize GitLab data in the Boost dashboard, rewarding you complete visibility into your organization's GitLab activity.
Prerequisites¶
To install the BoostSecurity GitLab integration, prepare the following:
- Create a GitLab Personal Access Token with the
api
scope selected.- It is advised that a protected, non-human GitLab account entity is assigned to this Personal Access Token. Otherwise, the connection between Boost and GitLab can be severed if the associated entity's account is removed during standard offboarding or change management procedures.
- The current version of Boost does not support Group Access Tokens or a Service Account.
- The entity that the Personal Access Token is assigned to will need to have
Owner
permissions for the repositories that are associated with the GitLab groups that are being ingested into Boost.
- It is advised that a protected, non-human GitLab account entity is assigned to this Personal Access Token. Otherwise, the connection between Boost and GitLab can be severed if the associated entity's account is removed during standard offboarding or change management procedures.
Install the BoostSecurity GitLab Integration¶
-
Navigate to the
Integrations page
. -
Click the Install button that is on the GitLab Integration Card underneath the
Available
section. -
A modal will appear, requesting the GitLab Personal Access Token. Provide the Personal Access Token and click Next.
-
Select the GitLab Group you are interested ingesting repositories for into Boost. It is advised that the root group is selected, as that will ingest all subgroups into Boost at once. Once a group is selected, click Complete
Once the installation completes, the BoostSecurity GitLab integration is successfully installed. Continue your BoostSecurity journey, by installing Zero Touch Provisioining.
Edit an installed BoostSecurity GitLab Integration¶
In the event an adjustment needs to be made to an installed GitLab Integration, the following instructions are provided:
-
Navigate to the
Integrations page
. -
Click on the GitLab Integration Card underneath the
Installed
section. -
Click the
Configuration
tab. -
Click the pencil icon associated with the GitLab Integration you wish to edit.
-
Provide a Personal Access Token that has the
api
scope and clickUpdate
.