Skip to main content

Netskope Help

Configure GitHub for the Next Generation API Data Protection

To configure GitHub for the Next Generation API Data Protection, follow the instructions below.

Prerequisite

Before configuring GitHub for the Next Generation API Data Protection, review the prerequisites.

  • You require a GitHub Enterprise Cloud edition.

  • A GitHub account who is either a member or owner of your GitHub organization.

Install the Netskope CASB API App in GitHub

To install the Netskope CASB API app in the GitHub organization, follow the steps below:

Note

You should log in as an owner of the GitHub organization.

  1. Log in to www.github.com using your GitHub organization account.

  2. Install the Netskope CASB API app from the following URL: https://github.com/apps/netskope-casb-api.

  3. Click Install.

    Figure 10. Install the Netskope CASB API App in GitHub
    Install the Netskope CASB API App in GitHub


  4. Select the organization name > All repositories and click Install.

    Figure 11. Select GitHub Organization Window
    Select GitHub Organization Window


    Figure 12. Select All Repositories Window
    Select All Repositories Window


    Note

    To know more about the permissions, see Permissions Required for GitHub.

    Keep the installation options unchanged.

Once installed, you should see a successful message at the top of the page. Proceed to configure the GitHub instance in Netskope UI.

Configure GitHub Instance in Netskope UI

To authorize Netskope to access your GitHub instance, follow the steps below:

  1. Log in to the Netskope tenant UI: https://<tenant hostname>.goskope.com and go to Settings > API-enabled Protection > SaaS > Next Gen.

  2. Under Apps, select GitHub and click Setup GitHub Instance.

    The Setup Instance window opens.

  3. Enter the GitHub organization name.

    Note

    The organization name should be the same as the one you installed the Netskope CASB API app on. It is case-sensitive.

  4. Click Grant Access. You will be prompted to log in with your GitHub member or owner username and password, and then click Sign In. When the configuration results page opens, click Close.

Refresh your browser, and you should see a green check icon next to the instance name.

You can receive audit events and standard user behavior analytic alerts in Skope IT. To know more: Next Generation API Data Protection Skope IT Events.

Next, you should configure a Next Generation API Data Protection policy. To do so, see Next Generation API Data Protection Policy Wizard.

(Optional) Uninstall the Netskope CASB API App in GitHub

Note

You can skip this procedure if you continue to use GitHub for the Next Generation API Data Protection.

If you discontinue the integration between GitHub and Next Generation API Data Protection, first, you have to delete the GitHub instance from the Netskope tenant UI. Then, uninstall the Netskope CASB API app from GitHub.

You can uninstall the Netskope CASB API app. To uninstall the app, follow the steps below:

  1. Log in to www.github.com using your GitHub administration username.

  2. On the top-right, click Settings.

    Figure 13. GitHub Settings Window
    GitHub Settings Window


  3. On the left navigation, click Organizations.

  4. Identify the organization where you have installed the GitHub app and click Settings.

  5. On the left navigation, click GitHub Apps.

  6. Identify the GitHub app and click Configure.

  7. Scroll down to the Uninstall <app name> section and click Uninstall.

    Figure 14. Netskope CASB API App Uninstall Window
    Netskope CASB API App Uninstall Window


Once you uninstall the app, Netskope stops receiving any notifications from GitHub.

In this section: