Connect a VCS

Open Integrations

From your workspace, open Settings and select Integrations.

Connect your VCS

• GitHub Cloud
• GitHub Enterprise
• GitLab
• Bitbucket Cloud

Prerequisites:

• Organization owner access or admin access for the account you plan to connect

Select Install for GitHub, then choose All repositories or Only select repositories. Confirm the permissions and select Install & Authorize.

Prerequisites:

• Admin access to create a GitHub App on your GitHub Enterprise Server instance

Select New App for GitHub Enterprise to begin connecting your self-hosted GitHub instance.

Enter your GitHub Enterprise Server URL and select Verify Host. Enable Skip SSL certificate verification only if your server uses a self-signed certificate.

Select Create Application. You’ll be redirected to your GitHub Enterprise Server to confirm the app name.

After creating the app, you’ll return to Cysmiq. The app is created but not yet installed on any organizations. Select Get started to install the app.

Choose the account or organizations where you want to install the app, then review the permissions and select Install & Authorize.

Prerequisites:

• Group owner access and a personal access token with the api scope

Select Setup for GitLab, then create a GitLab personal access token with the api scope. For help generating a token, see GitLab’s documentation.

Enter your GitLab host, such as https://gitlab.com or your self-managed domain, and the personal access token, then select Save Changes.Enable Skip SSL certificate verification only if your self-managed GitLab uses a self-signed certificate.

Prerequisites:

• Workspace admin access in Bitbucket Cloud
• A workspace access token with the required scopes

Create a workspace access token in Bitbucket Cloud with these scopes:

• Account: Read
• Projects: Read
• Repositories: Read
• Repositories: Write
• Pull requests: Read
• Pull requests: Write
• Webhooks: Read and write

Select Setup for Bitbucket Cloud.

Enter your workspace slug and workspace access token, then select Save Changes.

Verify the connection

• GitHub Cloud
• GitHub Enterprise
• GitLab
• Bitbucket Cloud

After authorization, return to Integrations to confirm GitHub is connected.

Open Assets then Organizations to verify the GitHub organization appears as active.

After authorization, you’ll return to Cysmiq. The GitHub Enterprise integration now shows the connected organization.

Open Assets then Organizations to verify the GitHub Enterprise organization appears as active.

Return to Integrations to confirm GitLab is connected.

Open Assets then Organizations to verify the GitLab group appears as active.

Return to Integrations to confirm Bitbucket Cloud is connected.

Confirm scans are running

• GitHub Cloud
• GitHub Enterprise
• GitLab
• Bitbucket Cloud

Navigate to Scans to confirm that Cysmiq started scanning your repositories.

Navigate to Scans to confirm that Cysmiq started scanning your repositories. Cysmiq queues scans automatically for all repositories in the connected organizations.

Cysmiq queues scans automatically for all repositories in the connected GitLab group.

Cysmiq queues scans automatically for repositories in the connected Bitbucket workspace.