How to integrate additional Github accounts?

To integrate an additional GitHub account into Hivel, particularly a service account to avoid integrating personal repositories, follow these steps:

---

Step 1: Prepare a Service Account

1. Log into the GitHub service account:

   • Use a dedicated service account that has access to the required repositories for Hivel integration.

   • Avoid using personal GitHub accounts to ensure only the intended repositories are accessed.

---

Step 2: Access Developer Settings

1. Click on the Profile Icon in the top-right corner of the GitHub dashboard.

2. Select Settings from the dropdown menu.

3. Scroll down and click on Developer Settings in the sidebar.

---

Step 3: Create a Personal Access Token

1. In Developer Settings, navigate to Personal Access Tokens.

2. Choose Tokens (classic), as the Fine-Grained Tokens are still in beta and may have limitations.

---

Step 4: Configure the Classic Token

1. Click Generate New Token and select Classic Token.

2. Fill out the following details:

   • Token Name: Enter Hivel as the token name.

   • Expiration Date: Set it to no expiration date for uninterrupted integration. (You can revoke this token manually when the engagement ends.)

3. Specify the scopes the token needs to operate effectively with Hivel:

   • repo

     
   • org

     
   • hooks

     

   • user

     
4. Once the configurations are complete, click Generate Token.

---

Step 5: Share the Token with Hivel

1. Copy the generated token immediately, as you won’t be able to view it again.

2. Provide the following details securely to Hivel for the integration:

   • Personal Access Token: Paste the copied token.

   • Username: Provide the service account’s GitHub username.

   • Email: Provide the email associated with the GitHub service account.

---

Step 6: Publish Webhooks

Ensure that the service account has the required permissions to publish webhooks for your repositories. These permissions are critical for enabling Hivel to fetch and analyze development activity data.