GitHub
  • 24 Mar 2022
  • 2 Minutes to read
  • Dark
    Light
  • PDF

GitHub

  • Dark
    Light
  • PDF

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 (optional) - The organization for the GitHub account. To connect this adapter, either this setting must be set or the Fetch all organizations for logged user setting on the Advanced Configuration screen.
  3. Authorization Token (optional) - Specify the personal access token that has read access. For details, see Creating the Authorization Token. If you authenticate using GitHub App leave this field blank.
  4. Authenticate using GitHub App - Select to authenticate using the GitHub App.
  5. GitHub App's Identifier - Github app's ID, can be found under the GitHub app's page. Only use if authenticating with GitHub app.
  6. App Key File (pem) - Load the GitHub app's pem key file. You can download this through the GitHub app's page. Only use if authenticating with GitHub App.
  7. Verify SSL (required, default: False) - Select to verify the SSL certificate offered by the value supplied in GitHub Domain. For more details, see SSL Trust & CA Settings.
  8. 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.
  9. For details on the common adapter connection parameters and buttons, see Adding a New Adapter Connection.

Github

Advanced Settings

Note:

Advanced settings can either apply for all connections for this adapter, or you can set different advanced settings and/or different scheduling for a specific connection, refer to ​Advanced Configuration for Adapters

  1. Fetch public organizations for users (required, default: False) - Select whether to fetch the public organizations each user is member of.

    • If disabled, this adapter will not fetch the public organizations each user is a member of. As a result, the fetch time will be shorter.
  2. Fetch all organizations for logged user (required, default: False) - Select whether to fetch all organizations for the logged user. To connect this adapter, either this setting must be set or the Organizations setting on the Connection Configuration screen.

Note:

For details on general advanced settings under the Adapter Configuration tab, see Adapter Advanced Settings.

APIs

Axonius uses the GitHub API.

Creating the Authorization Token

To create a personal access token:

  1. From GitHub, navigate 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

What's Next
First name must have atleast 2 characters. Numbers and special characters are not allowed.
Last name must have atleast 1 characters. Numbers and special characters are not allowed.
Enter a valid email
Enter a valid password
Your profile has been successfully updated.