GitHub Cloud Pull Richiede connettori Microsoft Graph (anteprima)

I connettori GitHub Cloud Pull Requests di Microsoft Graph consentono all'organizzazione di indicizzare le richieste pull archiviate in GitHub. Dopo aver configurato il connettore e l'indice del contenuto di GitHub, gli utenti possono cercare e recuperare informazioni tramite Microsoft Search e Microsoft 365 Copilot.

Questo articolo è destinato agli amministratori di Microsoft 365 o a tutti coloro che configurano, eseguono o monitorano i connettori di Microsoft Graph per le richieste pull cloud di GitHub.

Funzionalità

• Indicizzare le richieste pull di GitHub.
• Abilitare Microsoft Search e Microsoft 365 Copilot per recuperare i dati di GitHub in modo efficiente.
• Gestire gli elenchi di controllo di accesso di GitHub e le autorizzazioni utente.
• Consentire agli amministratori di personalizzare la frequenza di ricerca per indicizzazione e le preferenze di indicizzazione.

Limitazioni

• Il connettore non supporta l'indicizzazione delle pipeline CI/CD di GitHub oltre l'indicizzazione dello stato.
• Le istanze di GitHub locali o self-hosted non sono attualmente supportate.
• I commenti e le informazioni sui commit non vengono sottoposti a ricerca per indicizzazione.
• Il connettore è progettato per supportare GitHub Enterprise. Gli utenti nei piani Gratuito o Team potrebbero riscontrare funzionalità limitate o un supporto ridotto.

Prerequisiti

Prima di configurare il connettore:

1. Assicurarsi che l'istanza di GitHub sia accessibile tramite API.
2. Configurare l'app GitHub per l'autenticazione.
3. Generare un ID client e un segreto client dall'app GitHub per l'autenticazione. È possibile specificare le organizzazioni e i repository a cui un'app GitHub è autorizzata ad accedere, determinando in modo efficace il contenuto per cui il connettore eseguirà la ricerca per indicizzazione.
4. Verificare che l'account utente usato per l'autenticazione abbia accesso ai repository e alle richieste pull da indicizzare.
5. Verificare che l'app GitHub disponga delle autorizzazioni seguenti configurate per la lettura dei problemi:
   • Autorizzazioni per il repository
     • Amministrazione - Sola lettura
     • Metadati - Sola lettura
     • Richieste pull - Sola lettura
   • Autorizzazioni dell'organizzazione
     • Amministrazione - Sola lettura
     • Membri - Sola lettura
   • Autorizzazioni dell'account
     • indirizzi Email - Sola lettura
6. Assicurarsi che gli utenti che accedono ai dati indicizzati di GitHub abbiano identità di Microsoft Entra ID corrispondenti per il mapping delle autorizzazioni.
7. Per gli utenti gestiti dall'organizzazione che eseguono l'autenticazione tramite Single Sign-On (SSO), l'account deve essere connesso prima di eseguire qualsiasi azione, poiché il flusso di autenticazione GitHub non supporta attualmente l'accesso SSO.

Per iniziare

1. Scegliere il nome visualizzato

Scegliere un nome visualizzato che consenta agli utenti di riconoscere la connessione in una risposta copilot.

2. Eseguire l'autenticazione

• Immettere l'ID client e il segreto client dall'app GitHub.
• Scegliere Autorizza per accedere e concedere l'accesso. È consigliabile usare account utente separati per l'autenticazione OAuth con ogni connessione, in quanto il limite di frequenza di GitHub viene calcolato singolarmente per utente.
• Concedere gli ambiti API necessari.

3. Distribuire a un pubblico limitato

Prima di distribuire il connettore, testare la connessione con una base utente limitata in Copilot e Microsoft Search.

Configurazione personalizzata

L'installazione personalizzata è destinata agli amministratori che vogliono modificare i valori predefiniti per qualsiasi impostazione. Quando si sceglie Configurazione personalizzata, vengono visualizzate altre tre schede: Utenti, Contenuto e Sincronizzazione.

Utenti

Mapping delle identità

Per garantire la corretta imposizione delle autorizzazioni, eseguire il mapping delle identità utente di GitHub a Microsoft Entra ID. Di seguito sono riportate le opzioni seguenti:

• Email: esegue il mapping della posta elettronica di GitHub alle proprietà dell'utente Microsoft Entra ID.
• Accesso: Esegue il mapping degli account di accesso di GitHub con Microsoft Entra ID proprietà utente.
• Nome: Esegue il mapping del nome di GitHub con Microsoft Entra ID proprietà utente.

Se il mapping diretto non riesce, usare espressioni regolari (regex) per trasformare i dati. Ad esempio: [a-zA-Z0-9]+

Per gli account personali, l'accuratezza del mapping può essere influenzata da variazioni nei domini di posta elettronica e nelle singole impostazioni di visibilità della posta elettronica.

Contenuto

In Contenuto è possibile verificare i mapping delle proprietà nei dati di esempio per metadati quali contenuto, etichette, descrizione e timestamp.

Filtro intervallo di tempo

È possibile configurare un filtro intervallo di tempo nella scheda contenuto. L'impostazione predefinita è 365 giorni.

Sincronizza

È possibile configurare ricerche per indicizzazione incrementali e complete. Di seguito sono riportati i valori predefiniti:

• La ricerca per indicizzazione incrementale viene eseguita ogni 15 minuti per impostazione predefinita.
• La ricerca per indicizzazione completa viene eseguita ogni giorno per garantire l'indicizzazione aggiornata.

Impostazioni del firewall (solo per il connettore Azure SQL Microsoft Graph)

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.

Area geografica	Microsoft 365 Enterprise	Microsoft 365 Per enti pubblici
NAM	52.250.92.252/30, 52.224.250.216/30	52.245.230.216/30, 20.141.117.64/30
EUR	20.54.41.208/30, 51.105.159.88/30	ND
APC	52.139.188.212/30, 20.43.146.44/30	ND

La configurazione di una restrizione IP potrebbe causare l'interruzione del funzionamento del connettore e causare errori di ricerca per indicizzazione. Gli amministratori possono risolvere questo problema e riprendere la ricerca per indicizzazione aggiungendo l'indirizzo IP del connettore all'elenco consentiti in base alla tabella precedente.

Passaggi successivi

• Fare clic su Generazione automatica per popolare rapidamente la descrizione della connessione con le impostazioni predefinite consigliate. In questo modo si risparmia tempo e si garantisce la coerenza nella configurazione.
• Esaminare lo stato della connessione nel Centro Amministrazione Microsoft 365.
• Per informazioni sulla configurazione delle app GitHub e sull'autenticazione, vedere la documentazione seguente

Argomento	Collegamento alla documentazione
Come creare/registrare un'app GitHub	Registrazione di un'app GitHub
Come installare un'app GitHub nelle organizzazioni	Installazione di un'app GitHub personalizzata
Come autenticare un'app GitHub per conto di un utente	Informazioni sulla creazione di app GitHub (che agiscono per conto di un utente) Autenticazione con un'app GitHub per conto di un utente

In caso di problemi o se si vuole fornire commenti e suggerimenti, contattare il supporto tecnico di Microsoft Graph.