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.


NOTE
Axonius uses the GitHub API


Adapter Parameters

  1. GitHub Domain(required, default: https://api.github.com) - The hostname of the GitHub server
  2. Organization(required) - The organization for the GitHub account.
  3. Authorization Token - Enter the personal access token that has read access. (See permission instructions below)
  4. Verify SSL(required, default: False) - Verify the SSL certificate offered by the host supplied in GitHub Domain. For more details, see SSL Trust & CA Settings.
    • If enabled, the SSL certificate offered by the host will be verified against the CA database inside of Axonius. If it fails validation, the connection will fail with an error.
    • If disabled, the SSL certificate offered by the host will not be verified against the CA database inside of Axonius.
  5. HTTPS Proxy(optional, default: empty) - A proxy to use when connecting to GitHub Domain.
    • If supplied, Axonius will utilize the proxy when connecting to the host defined for this connection.
    • If not supplied, Axonius will connect directly to the host defined for this connection.
  6. Choose Instance(required, default: 'Master') - The Axonius node to utilize when connecting to GitHub Domain. For more details, see Connecting Additional Axonius Nodes.
  7. Connection Label (optional, default: empty) - An optional label to help distinguish between multiple connections for the same adapter. This label will be concatenated to the relevant Adapter Name in the Device/User Profile page and the full text will be visible when hovering over the Adapters column in the Devices/Users pages.
    • If supplied, the label will be appended to the adapter name.
    • If not supplied, only the adapter name will be displayed.


Creating the Authorization Token

To create a personal access token go to GitHub -> Settings -> Developer Settings -> Personal access token, Generate a new one and then give the necessary read-only permissions (Instructions can be found here)
Permissions required for adapter:  
  • read:packages
  • read:org
  • read:public_key
  • read:user
  • user:email
  • read:enterprise





Was this article helpful?