> ## Documentation Index
> Fetch the complete documentation index at: https://docs.backline.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Integration Hub

> Connect your development tools and security scanners to Backline

## 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

<Steps>
  <Step title="Navigate to Integrations">
    Click **Integrations** in the main navigation menu.
  </Step>

  <Step title="Browse Available Integrations">
    View all available integration options displayed as cards.
  </Step>

  <Step title="Select an Integration">
    Click on the Connect button of any integration card to begin the connection process.
  </Step>
</Steps>

## Available Integration Types

### Source Control Management (SCM)

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

* [GitHub](/integrations/github)
* [GitLab](/integrations/gitlab)
* [Bitbucket](/integrations/bitbucket)

### Container Registries

Integrate container registries to scan images for vulnerabilities:

* [Amazon ECR](/integrations/ecr)
* [Azure ACR](/integrations/acr)
* [JFrog Artifactory](/integrations/jfrog)

### Package Registries

Connect package registries to monitor dependencies:

* [npm](/integrations/npm)
* [PyPI](/integrations/pypi)
* [NuGet](/integrations/nuget)
* [JFrog Package Registry](/integrations/jfrog-registry)
* [Nexus](/integrations/nexus)
* [AWS CodeArtifact](/integrations/aws-codeartifact)
* [Google Artifact Registry](/integrations/gar)

### Security Scanners

Import vulnerability from security scanning tools:

* [Aikido](/integrations/aikido)
* [OX Security](/integrations/ox-security)
* [Dependabot via GitHub](/integrations/github)

### Collaboration Tools

Link collaboration platforms for notifications and ticket management:

* [Slack](/integrations/slack)
* [Jira](/integrations/jira)

## Connecting an Integration

When you click **Connect** on an integration card, a dialog will open to guide you through the connection process.

### Integration Dialog

The integration dialog provides all the information and tools needed to connect your integration:

#### Overview Tab

The Overview tab contains:

* **Overview**: Description of the integration, its benefits, and features
* **Connection Instructions**: Step-by-step guidance for connecting the integration

Below the overview, you'll see the connection interface based on the integration type:

**OAuth Integrations**

* Click the **Connect** button to be redirected to the service provider
* Authorize Backline and grant the requested permissions
* You'll be redirected back to Backline with the integration connected

**Application Integrations**

* Click the **Connect** button to be redirected to install the required app
* Follow the installation process on the service provider's platform
* Return to Backline once the app is installed

**Credential-Based Integrations**

* Fill in the required credential fields (API keys, tokens, URLs, etc.)
* Click **Connect** to establish the connection
* Use **Test Connection** to verify the credentials are correct

#### Configuration Tab

<Note>
  The Configuration tab only appears for integrations that have additional, non-mandatory configuration options available.
</Note>

If present, the Configuration tab allows you to:

* Set optional features and preferences
* Customize integration behavior
* Configure advanced settings

## Managing Integrations

### View Integration Status

Each integration card shows its connection status through the action button:

* **"Connect" button**: Integration is not yet connected
* **"Configure" button**: Integration is already connected

### Viewing and Editing Integration Settings

For connected integrations, you can view and manage settings:

<Steps>
  <Step title="Click Configure">
    On a connected integration card, click the **Configure** button.
  </Step>

  <Step title="Review Connection Details">
    View the existing connection details and configuration settings.
  </Step>

  <Step title="Test Connection">
    Use the **Test Connection** button to verify the integration is working properly.
  </Step>

  <Step title="Check Configuration">
    Review all configuration options and make any necessary adjustments.
  </Step>
</Steps>

### Disconnect an Integration

To remove an integration:

<Steps>
  <Step title="Open Integration Menu">
    On the integration card, click the **three dots menu** (⋮) in the corner.
  </Step>

  <Step title="Select Disconnect">
    Click the **Disconnect** option from the menu.
  </Step>

  <Step title="Confirm">
    Confirm that you want to remove the integration.
  </Step>
</Steps>

<Warning>
  Disconnecting an integration will stop data collection from that source. Existing vulnerabilities from that source will remain in Backline but won't be updated.
</Warning>

## Best Practices

<AccordionGroup>
  <Accordion title="Start with SCM">
    Connect your source control management platform first (GitHub, GitLab, or Bitbucket) as it's required for automated remediation features.
  </Accordion>

  <Accordion title="Add Multiple Scanners">
    Connect all your security scanning tools to get a comprehensive view of vulnerabilities across your entire stack.
  </Accordion>

  <Accordion title="Test Connections">
    Always use the **Test Connection** button before saving to ensure your configuration is correct.
  </Accordion>

  <Accordion title="Secure Your Credentials">
    When using API keys or tokens, ensure they have only the minimum required permissions and store them securely.
  </Accordion>
</AccordionGroup>

## 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

<Tip>
  Need help? Each integration's Overview tab contains specific guidance and links to detailed setup instructions.
</Tip>