GitHub
  • 1 Minute To Read
  • Print
  • Share
  • Dark
    Light

GitHub

  • Print
  • Share
  • Dark
    Light

GitHub provides hosting for software development version control using Git, including distributed version control and source code management (SCM) functionality.

Types of Assets Fetched

This adapter fetches the following types of assets:

  • Users


Parameters

  1. GitHub Domain (required, default: https://api.github.com) - The hostname or IP address of the GitHub server.
  2. Organization (required) - The organization for the GitHub account.
  3. Authorization Token (required) - Specify the personal access token that has read access. For details, see
  4. Verify SSL (required, default: False) - Verify the SSL certificate offered by the value supplied in GitHub Domain. For more details, see SSL Trust & CA Settings.
    • If enabled, the SSL certificate offered by the value supplied in GitHub Domain will be verified against the CA database inside of Axonius. If the SSL certificate can not be validated against the CA database inside of Axonius, the connection will fail with an error.
    • If disabled, the SSL certificate offered by the value supplied in GitHub Domain will not be verified against the CA database inside of Axonius.
  5. HTTPS Proxy (optional, default: empty) - A proxy to use when connecting to the value supplied in GitHub Domain.
    • If supplied, Axonius will utilize the proxy when connecting to the value supplied in GitHub Domain.
    • If not supplied, Axonius will connect directly to the value supplied in GitHub Domain.
  6. For details on the common adapter connection parameters and buttons, see Adding a New Adapter Connection.

image.png

APIs

Axonius uses the GitHub API.

Creating the Authorization Token

To create a personal access token:

  1. From GitHub, Go to Settings -> Developer Settings -> Personal access token.
  2. Generate a new token and then give the following read-only permissions:
    • read:packages
    • read:org
    • read:public_key
    • read:user
    • user:email
    • read:enterprise
  3. To use a personal access token with an organization that uses SAML single sign-on (SSO), you must first authorize the token. For details, see GitHub Docs - Authorizing a personal access token for use with SAML single sign-on.
    image.png
Was This Article Helpful?