Configurare il servizio GitHub per l'inserimento del connettore richieste pull di GitHub Server

Questo articolo fornisce informazioni sui passaggi di configurazione che gli amministratori di GitHub devono completare per consentire all'organizzazione di distribuire il connettore GitHub Server Pull Requests. Se configurato, il connettore indicizza i dati delle richieste pull da GitHub Enterprise Server in modo che gli utenti possano cercare, riepilogare e recuperare informazioni sulle richieste pull in Microsoft Search, Microsoft 365 Copilot e Ricerca Copilot.

Questo articolo si applica al connettore GitHub Server Pull Requests. Per informazioni su come distribuire il connettore, vedere Distribuire il connettore richieste pull di GitHub Server.

Impostare l'elenco di controllo:

L'elenco di controllo seguente elenca i passaggi necessari per configurare l'ambiente GitHub Server e configurare i prerequisiti del connettore.

Identificare il nome dell'organizzazione

Determinare quale organizzazione di GitHub Enterprise Server verrà usata dal connettore per l'inserimento delle richieste pull. Il connettore indicizza solo il contenuto accessibile all'app GitHub installata nell'organizzazione selezionata.

Verificare l'accesso API all'istanza di GitHub di destinazione

Verificare che l'istanza di GitHub Enterprise Server sia raggiungibile tramite API. Il connettore richiede l'accesso API per recuperare i metadati della richiesta pull. Verificare quanto segue:

• L'istanza di GitHub è accessibile tramite HTTPS.
• Le restrizioni del firewall o della rete consentono richieste API in ingresso/in uscita.
• Il dispositivo host dell'agente connettore Graph può raggiungere il dominio GitHub Enterprise Server.

Identificare le regole di mapping Microsoft Entra ID

Definire le regole di mapping Microsoft Entra ID. Il mapping delle identità garantisce la corretta imposizione delle autorizzazioni quando gli utenti accedono ai dati di richiesta pull in Copilot ed esperienze di ricerca.

Le strategie di mapping supportate includono:

• Email: corrisponde agli indirizzi di posta elettronica di GitHub alle proprietà Microsoft Entra ID.
• Login: Esegue il mapping dei nomi utente di GitHub agli attributi Microsoft Entra ID.
• Nome: Usa il nome del profilo GitHub per il mapping.

Se le identità non corrispondono direttamente, è possibile usare espressioni regolari (regex) per normalizzare i dati. Ad esempio: [a-zA-Z0-9]+

Gli utenti devono condividere gli attributi di identità di GitHub necessari, in particolare negli ambienti Bring Your Own User (BYOU).

Accedere all'account GitHub

Se l'organizzazione usa l'accesso Single Sign-On (SSO), accedere a GitHub prima di configurare il connettore. Attualmente, il connettore GitHub Server Pull Requests non supporta il completamento dei flussi di autenticazione che si basano sull'accesso SSO durante la configurazione del connettore.

Usare un'app GitHub personalizzata per l'autenticazione

Per un'esperienza di configurazione più semplificata, usare l'app GitHub gestita da Microsoft.

È anche possibile scegliere di usare la propria app GitHub per l'autenticazione. Se si sceglie questa opzione, seguire la procedura descritta nell'elenco di controllo seguente per completare l'installazione.

Creare e configurare l'app GitHub

Verificare di avere le autorizzazioni appropriate assegnate per configurare il servizio GitHub. Per altre informazioni, vedere Ruoli in un'organizzazione.

Per creare un'app GitHub da usare con il connettore GitHub Server Pull Requests:

1. In GitHub selezionare la foto del profilo in alto a destra, selezionare Organizzazioni e scegliere l'organizzazione da cui il connettore deve eseguire il pull dei dati.

   

2. Nella pagina panoramica dell'organizzazione selezionare Impostazioni.

   

3. Nella barra laterale sinistra scorrere verso il basso fino a Impostazioni sviluppatore e selezionare App GitHub.

   

4. Selezionare Nuova app GitHub.

   

5. Configurare l'app:

   • Nome dell'app GitHub: immettere il nome desiderato.
   • URL della home page: copiare l'URL dalla barra degli indirizzi del browser.
   • URL di callback:
     • Per Microsoft 365 per le aziende: https://gcs.office.com/v1.0/admin/oauth/callback
     • Per Microsoft 365 Per enti pubblici: https://gcsgcc.office.com/v1.0/admin/oauth/callback

   

6. Deselezionare l'opzione Webhook .

7. Impostare le autorizzazioni seguenti:

   Autorizzazioni per il repository

   • Contenuto - Sola lettura
   • Metadati - Sola lettura
   • Amministrazione - Sola lettura

   Autorizzazioni dell'organizzazione

   • Membri - Sola lettura
   • Amministrazione - Sola lettura

   Autorizzazioni dell'account

   • indirizzi Email - Sola lettura

8. In Dove può essere installata questa app GitHub selezionare Qualsiasi account e quindi selezionare Crea app GitHub.

Creare le credenziali per l'app GitHub

• Nella pagina Generale dell'app GitHub selezionare Genera un nuovo segreto client per generare e copiare il segreto client.

  

Installare l'app GitHub

1. Nella pagina Generale dell'app GitHub selezionare Installa app.

   

2. Selezionare l'organizzazione in cui si vuole installare l'app.

Modificare il limite di frequenza delle API di GitHub Server

Quando si inserisce grandi volumi di dati di GitHub, ad esempio richieste pull, problemi o file di conoscenze, la configurazione del limite di frequenza delle API nell'ambiente GitHub Server influisce direttamente sulla velocità con cui viene completato il processo di inserimento. GitHub Server applica un limite api predefinito di 15.000 richieste autenticate all'ora per utente o token. Questo limite supporta set di dati più piccoli, ma può rallentare l'inserimento quando vengono elaborati centinaia di migliaia o milioni di elementi.

Se l'organizzazione deve aumentare la velocità effettiva, è possibile aumentare il limite di velocità dell'API. I limiti più elevati consentono al connettore di recuperare gli elementi più rapidamente, ma aumentano anche il carico sull'infrastruttura di GitHub Server. Prima di aggiornare le impostazioni relative ai limiti di frequenza, verificare che l'ambiente disponga di capacità cpu, I/O di archiviazione e larghezza di banda di rete adeguati per supportare l'aumento del volume delle richieste. Dopo aver aggiornato il limite, monitorare le prestazioni del sistema per garantire l'inserimento stabile a una velocità effettiva più elevata.

Consigli per l'impostazione del limite di frequenza

Usare le indicazioni riportate nella tabella seguente per scegliere un'impostazione di limite di frequenza appropriata in base al numero approssimativo di richieste pull nell'ambiente GitHub.

Aggiornare l'impostazione relativa al limite di frequenza delle API

Per aumentare il limite di richieste API:

1. Accedere all'istanza di GitHub Server con un account amministratore.
2. Nell'angolo in alto a destra selezionare Amministratore sito per accedere alla modalità di amministrazione. Per altre informazioni, vedere Configurazione dei limiti di frequenza.
3. Nel riquadro sinistro selezionare Console di gestione (o Amministrazione Console, a seconda della versione in uso).
4. Aprire la scheda Limitazione frequenza .
5. Verificare che sia selezionata l'opzione Abilita limitazione della frequenza delle API HTTP .
6. In Richieste API (all'ora) - Autenticato immettere il valore del limite di frequenza ,ad esempio 30000.
7. Selezionare Salva impostazioni.

Configurare le impostazioni del firewall

Per una maggiore sicurezza, è possibile configurare le regole del firewall IP per il server o il database Azure SQL. Per altre informazioni, vedere Regole del firewall IP.

Aggiungere gli intervalli IP client seguenti nelle impostazioni del firewall.

Le restrizioni IP possono causare l'interruzione del funzionamento del connettore e causare errori di ricerca per indicizzazione. Per risolvere questo problema, aggiungere l'indirizzo IP del connettore all'elenco consentiti.

Passaggio successivo