GitHub: Configuring the Interconnected Apps Integration

This article explains how to configure the Interconnected Apps integration for GitHub.

Overview

Interconnected Apps provides you with visibility into third-party plugins connected to sanctioned SaaS applications. To provide Cato with visibility of data within an app, you need to set up an integration with the required application. For more information, see Viewing and Analyzing Interconnected Apps.

To configure the Interconnected Apps integration, you need to:

Configure the integration within the SaaS application
Create the API connector in the Cato Management Application (CMA)

A CASB license is required for Interconnected Apps. For more about purchasing a CASB license, please contact your Cato representative.

Benefits of the GitHub Integration

After creating this connector, you can view detailed information about apps connected to your GitHub environment through Cato, including permissions and usage data (users, last used date).

Configuring the GitHub Integration

To configure the GitHub integration, generate the required information and enter it in the CMA

Prerequisites

GitHub Enterprise license

Step 1: Configure the Integration in the GitHub Developer Center

In the GitHub Developer Center, identify the access token to enter into the CMA.

To configure the GitHub integration:

In the GitHub Developer Center, navigate to Personal access tokens > Tokens (classic).
Click Generate new token > Generate new token (classic).
Set the token expiration date.
We recommend setting the expiration date to the maximum allowable period of 1 year.
Add these scopes:
- Audit_log:
  - read:audit_log
- Org:
  - read:org
Click Generate token and authorize your organization.
Copy and save the Access Token so it can be entered into the CMA.
Click Configure SSO and authorize your organizations
Navigate to Settings > Enterprises.
Click on the name of your enterprise.
The login page of your enterprise is displayed.
Copy and save the last segment of the URL so it can be added into the CMA. For example, in the URL https://github.com/enterprises/cato, copy and save cato.

Step 2: Create the API Connector in the CMA

After you have set up an integration with the required application, add the details in the CMA.

To create the API connector in the CMA:

From the navigation menu, click Resources > Integrations.
Click the Configured Integrations tab.
Click New.

The New Integration panel opens.
Select the SaaS Application you want to add.
In the Capability drop down select Third Party Apps.
Add the details created during step one.
Click Save.
The app is visible on the Integrated Apps table with a Connected status.

After connecting your APIs, you can track the interconnected apps on the Plugins page. Data may take a few minutes to appear.