Skip to main content

​
Overview

The Integration Hub is your central location for connecting Backline with your existing development and security tools. By integrating with your source control management (SCM) platforms, security scanners, and collaboration tools, Backline can automatically collect vulnerabilities and streamline your remediation workflow.

​
Accessing the Integration Hub

1

Navigate to Integrations

Click Integrations in the main navigation menu.
2

Browse Available Integrations

View all available integration options displayed as cards.
3

Select an Integration

Click on the Connect button of any integration card to begin the connection process.

​
Available Integration Types

​
Source Control Management (SCM)

Connect your code repositories to enable Backline to access your codebase and create remediation pull requests:

​
Container Registries

Integrate container registries to scan images for vulnerabilities:

​
Package Registries

Connect package registries to monitor dependencies:

​
Collaboration Tools

Link collaboration platforms for notifications and ticket management:

​
Connecting an Integration

​
OAuth-Based Integrations

For integrations using OAuth (GitHub, GitLab, Bitbucket, etc.):
1

Click Connect

Select the integration card and click the Connect button.
2

Authorize

You’ll be redirected to the service provider’s authorization page.
3

Grant Permissions

Review and approve the requested permissions.
4

Complete Setup

You’ll be redirected back to Backline with the integration connected.

​
Managing Integrations

​
View Integration Status

Each integration card displays:
  • Connection Status: Connected or Not Connected
  • Configuration Details: Key settings at a glance
  • Last Sync: When data was last updated (for connected integrations)

​
Edit Integration Settings

Most integrations cannot be edited once fully connected. To change settings, disconnect and reconnect the integration.

​
Disconnect an Integration

1

Open Integration

Click on the connected integration card.
2

Find Disconnect Option

Look for the Disconnect button in the integration dialog.
3

Confirm

Confirm that you want to remove the integration.
Disconnecting an integration will stop data collection from that source. Existing vulnerabilities from that source will remain in Backline but won’t be updated.

​
Integration Dialog

When configuring an integration, you’ll see a dialog with two tabs:

​
Overview Tab

  • Description of the integration
  • Benefits and features
  • Requirements and prerequisites
  • Links to relevant documentation

​
Configuration Tab

  • Connection settings and credentials
  • OAuth authorization buttons
  • Test connection functionality
  • Save and cancel options

​
Best Practices

Connect your source control management platform first (GitHub, GitLab, or Bitbucket) as it’s required for automated remediation features.
Connect all your security scanning tools to get a comprehensive view of vulnerabilities across your entire stack.
Always use the Test Connection button before saving to ensure your configuration is correct.
When using API keys or tokens, ensure they have only the minimum required permissions and store them securely.

​
Troubleshooting

​
Connection Failed

If an integration fails to connect:
  1. Verify your credentials are correct
  2. Check that the service is accessible from your network
  3. Ensure you have the necessary permissions in the external service
  4. Review any error messages for specific guidance

​
OAuth Authorization Issues

If OAuth authorization fails:
  1. Clear your browser cache and cookies
  2. Ensure pop-ups are allowed for Backline
  3. Try the authorization process again
  4. Check that your account has admin rights in the external service
Need help? Each integration’s Overview tab contains specific guidance and links to detailed setup instructions.