Skip to main content

Integrate your first repositories

To get started with automated secrets detection and remediation, you need to add a Version Control System (VCS) integration.

tip

If you want to try GitGuardian Internal Monitoring out on a test repository, go ahead and clone our sample_secrets repo. It contains 8 unique secrets our detection engine will find during the scans.

Integrate with GitHub#

When installing the GitGuardian GitHub App, choose whether you want to monitor all your repositories or a selection of repositories. This can be changed later from your GitHub account.

Once installed, GitGuardian will also give you the option to add or remove repositories from the monitored perimeter directly from your workspace.

Integrate with GitLab#

When integrating GitGuardian with GitLab, you can choose to monitor an entire instance or certain groups only. In both cases, you will need to generate a personal access token with admin permissions for the chosen perimeter.

Once installed, GitGuardian will also give you the option to add or remove repositories from the monitored perimeter directly from your workspace.

Step 1. Create a personal access token#

  1. Go to your User Settings on GitLab
  2. View the Access Tokens section
  3. Choose a name (for example “gitguardian-secrets-scanning”)
  4. IMPORTANT: Select the API scope

If you need to, visit the GitLab documentation for more details on how to create personal access tokens.

Step 2. Configure your GitLab integration via a system hook or a group hook#

Integrate with Bitbucket#