Skip to main content
Applies to BloodHound Enterprise and CE GitHub App installations provide a higher API rate limit of 15,000 requests per hour compared to 5,000 for Personal Access Tokens(PATs).
This is the recommended authentication method for organizations with 500+ repositories.

​
Install the GitHub App

You can either install the pre-configured SpecterOps GitHub App (recommended) or create your own.
The SpecterOps GitHub App comes pre-configured with the minimum required permissions.
  1. Contact your SpecterOps representative for the GitHub App installation link.
  2. Select the GitHub Organization for installation.
  3. Review the requested permissions and click Install.
  4. Select All repositories or choose specific repositories.
  5. Click Install to complete the installation.

​
Get the Installation Details

  1. Navigate to your Organization Settings > Third-party Access > GitHub Apps.
  2. Find the GitHound App and click Configure.
    GitHub App installation page showing permissions and repository access
  3. The numeric value in the URL is the App Installation ID.
  4. Click App settings to access the Client ID and App ID.
    GitHub App settings showing Client ID and App ID

​
Security Considerations

  • Store the .pem private key securely and never commit it to version control.
  • Rotate keys periodically and revoke old ones.
  • Only install the app on organizations that require collection.
  • Periodically verify the app has only the minimum required permissions.

​
Next Steps

After installing and configuring the GitHub App, proceed to Running the Collector to start collection.