How to create Github fine-grained token for Hivel Integration?

To integrate GitHub with Hivel using a fine-grained token, follow the steps below. This guide ensures a seamless setup, similar to the OAuth-based process but with specific token-based permissions.

Data Access by Hivel

• Hivel accesses the past 60-90 days of metadata and pull requests from active repositories during the initial sync.

Requirements

• Ensure to log in with an account possessing write permissions to relevant GitHub repositories.

• Write permissions are mandatory for webhook publication, facilitating real-time data sync.

Best Practice

1. Opt for a service account rather than an individual-linked account.

2. Service accounts are typically overseen by the company's admin.

Steps to generate a Fine-Grained Token on GitHub

1. Log in to GitHub with an account that has write permissions for the repositories you want to integrate.

2. Navigate to Settings > Developer settings.

3. Select Personal access tokens > Fine-grained tokens.

4. Click Generate new token.

5. Give the token name, preferably 'Hivel' and set an Expiration date as needed.

6. Under Resource owner, select the organization and repositories you want to include.

7. Grant the following permissions:

   
8. Click Generate token and copy the token immediately. Store it securely.