Configure a Personal Access Token

Create a Fine-grained Personal Access Token for GitHub data collection.

This page covers creating a Fine-grained Personal Access Token (PAT) for GitHub. PATs have a rate limit of 5,000 API requests per hour.

For higher rate limits, see Configure a GitHub App Installation.

Create a Fine-grained Personal Access Token

1. Navigate to Personal Access Tokens

   Navigate to your GitHub Profile > Settings.

   
2. Open Developer Settings

   Go to Developer settings (bottom left).

   
3. Go to Fine-grained Tokens

   Navigate to Personal access tokens > Fine-grained tokens.

   
4. Generate a new token

   Click Generate new token.

   
5. Set resource owner

   Set the Resource owner to your target organization.

6. Configure the access scope

   Under Repository access, select All repositories.

   
7. Configure the repository and org permissions

   Set the following permissions to Read-only:

   Show required permissions

   Repository permissions

   • Actions
   • Administration
   • Contents
   • Environments
   • Metadata
   • Secret scanning alerts
   • Secrets
   • Variables

   Organization permissions

   • Administration
   • Custom organization roles
   • Custom repository roles
   • Members
   • Personal access tokens
   • Personal access token requests
   • Secrets
   • Self-hosted runners
   • Variables
8. Generate the token

   You must save the token value (preferably in a password manager) at this point. You will not be able to recover it later.

   Click Generate token and copy the token value.

   

For organizations with SAML SSO enabled, you must authorize the PAT for SSO access after creating it.

Next Steps

After creating a token, proceed to configure the collector to start collection.