Connect

This guide walks you through connecting your GitHub Enterprise account to Zluri using a Personal Access Token (classic). This integration enables identity discovery, repository visibility, license tracking (e.g., GitHub Copilot), and more.

Prerequisites

• GitHub Enterprise Admin access
• Access to create a Personal Access Token (classic)
• Enterprise Name
• (Optional) Organization names to limit data to specific orgs
• Admin access to Zluri

Step 1: Generate GitHub Personal Access Token

1. Log in to GitHub Enterprise.

2. Go to Settings → Developer Settings → Personal Access Tokens → Tokens (classic).

3. Click Generate new token (classic).

4. Enter a token name and set an expiration.

5. Under Select Scopes, check:

   • read:enterprise
   • read:org
   • manage_billing:copilot (optional, to access GitHub Copilot license data)

6. Click Generate Token and copy it immediately.
   This token will not be visible again.

Step 2: Find Your GitHub Enterprise Name

1. Click your profile icon in the top-right corner.
2. Go to Settings → Enterprises.
3. Copy the Enterprise Name shown.

Step 3: Connect GitHub Enterprise in Zluri

1. Go to Sources → Integrations → Browse Catalog in Zluri.
2. Search for GitHub Enterprise and click ➕ Connect.

Step 4: Review Required Scopes in Zluri

1. Zluri will show the required scopes.
2. Click the arrow next to each scope to view what it does.
3. Click Continue.

Step 5: Enter Connection Details

1. In the form, enter:

   • API Key (from Step 1)
   • Enterprise Name (from Step 2)
   • Organization Names

     💡

     If the Organization Names field is left empty, Zluri will fetch data for all accessible orgs. If it is filled, Zluri will fetch data only for the listed orgs.

2. Click Connect.

Step 6: Finalize the Setup

1. Enter a connection name and optional description.
2. Click Save.
3. Zluri will validate and start syncing GitHub Enterprise data.

Notes

• The Personal Access Token must be classic (not fine-grained).
• If GitHub Copilot license data is required, make sure manage_billing:copilot is enabled.
• Ensure scopes selected in GitHub match what Zluri requires.
• If token expires or is revoked, you’ll need to regenerate and reconnect.