Skip to main content

Responses are generated using AI and may contain mistakes.

CollectorsCloud Collectors Administration Guide

Prerequisites to Configure GitHub Cloud Collector

Before you configure the GitHub cloud collector you must complete the following prerequisites.

  • Allow access to your GitHub server addresses over SSL.

  • Ensure that you have the GitHub Enterprise account with an enterprise owner role.

  • Generate a personal access (classic) token for the OAuth2 authentication.

  • Ensure that you have the read:audit_log permission for generating the personal access (classic) token.

Generate the Personal Access Token

Use the following steps to obtain a personal access token.

  1. Log in to the GitHub enterprise account.

  2. On your profile page, in the upper right corner, click the profile image, then click Settings.

  3. In the left pane, navigate to Developer Settings, under Personal access tokens, click Tokens (classic).

  4. Select Generate new token, and click Generate new token (classic).

  5. Specify a descriptive name for your token as in the note.

  6. To set token expiration, select the default option, or enter a custom date.

  7. Assign the scope or token permission read:audit_log for the collector to retrieve events. For more information, see Scopes for OAuth apps in the GitHub documentation.

  8. Click Generate new token.

  9. Copy the token, represented by a string of letters and numbers. Use this token to access GitHub API to complete the GitHub collector configuration.

    For more information, refer to the Personal Access Token related information in the GitHub documentation.