Onboard a GitHub Enterprise App to SSPM Using OAuth 2.0

Onboard a GitHub Enterprise App to SSPM Using OAuth 2.0

1. Identify the Administrator Account for Granting SSPM Access

   During the onboarding process, SSPM will redirect you to log in to GitHub Enterprise. After you log in, GitHub Enterprise will prompt you to grant SSPM the access it needs to your GitHub Enterprise instance.

   1. Verify that your account has the permissions that SSPM will require.

      Required Permissions: To grant SSPM the access that it requires, you must log in as an Enterprise Owner or Organization Owner. If you want SSPM to scan multiple organizations, the account must have Owner permissions for all the organizations.

      After SSPM establishes the connection, it will perform an initial scan of your GitHub Enterprise instance, and will then run scans at regular intervals. For SSPM to run these scans, the administrator account that you use to establish the initial connection must remain available. For this reason, we recommend that you use a dedicated service account to grant SSPM access. If you delete the service account, the scans will fail and you will need to onboard GitHub Enterprise again.
   2. Sign out of all GitHub Enterprise accounts.

      Signing out of all GitHub Enterprise accounts helps ensure that you sign in under the correct account during the onboarding process. Some browsers can automatically sign you in by using saved credentials. To ensure that the browser does not automatically sign you in to the wrong account, you can turn off any automatic sign-in option or clear your saved credentials. Alternatively, you can prevent the browser from using saved credentials by opening the Cloud Management Console in an incognito window.
2. Connect SSPM to Your GitHub Enterprise Instance

   By adding a GitHub Enterprise app in SSPM, you enable SSPM to connect to your GitHub Enterprise instance.

   1. Log in to Strata Cloud Manager.
   2. Select ManageConfigurationSaaS SecurityPosture SecurityApplicationsAdd Application and click the GitHub Enterprise Beta tile.
   3. On the Posture Security tab, Add New instance.
   4. Log in with Credentials.
   5. Connect.

      SSPM redirects you to the GitHub Enterprise login page.
   6. Enter the credentials for the administrator account that you identified earlier, and log in to GitHub Enterprise.

      GitHub Enterprise displays a consent form that details the access permissions that SSPM requires.
   7. Review the consent form and allow access.