Distribuire il connettore GitHub Server Issues Microsoft 365 Copilot

Il connettore GitHub Server Issues Microsoft 365 Copilot integra i dati dei problemi di GitHub in Microsoft 365. Questo articolo descrive i passaggi per distribuire e personalizzare il connettore GitHub Server Issues.

Per informazioni avanzate sulla configurazione di GitHub, vedere Configurare il servizio GitHub per l'inserimento del connettore.

Prerequisiti

Prima di distribuire il connettore GitHub Server Issues, assicurarsi che l'ambiente GitHub sia configurato nell'organizzazione. La tabella seguente riepiloga i passaggi per configurare l'ambiente GitHub e distribuire il connettore:

Prima di distribuire il connettore, assicurarsi di soddisfare i prerequisiti seguenti:

• L'utente è un amministratore di Microsoft 365.
• L'istanza di GitHub Enterprise Server è accessibile tramite API.
• Viene creata e installata un'app GitHub per l'autenticazione.
• Microsoft Graph Connector Agent viene installato in un dispositivo con accesso all'istanza di GitHub (versione 3.1.11.0 o successiva).
• Gli utenti che accedono ai dati indicizzati di GitHub hanno identità Microsoft Entra ID corrispondenti per il mapping delle autorizzazioni.

Distribuire il connettore

Per aggiungere il connettore GitHub Server Issues per l'organizzazione:

1. Nel riquadro sinistro della interfaccia di amministrazione di Microsoft 365 scegliere Connettori Copilot>.
2. Passare alla scheda Connettori e nel riquadro sinistro scegliere Raccolta.
3. Nell'elenco dei connettori disponibili scegliere Problemi del server GitHub.

Impostare il nome visualizzato

Il nome visualizzato viene usato per identificare i riferimenti nelle risposte copilot per consentire agli utenti di riconoscere il file o l'elemento associato. È possibile accettare il nome visualizzato predefinito dei problemi del server GitHub o personalizzare il valore per usare un nome visualizzato riconosciuto dagli utenti dell'organizzazione.

Per altre informazioni, vedere Migliorare l'individuazione copilot del contenuto del connettore.

Impostare l'URL dell'istanza

Immettere l'URL dell'istanza di GitHub Enterprise Server. Questo URL è il dominio radice del server GitHub interno. Ad esempio: https://github.<your-domain>.com

Scegliere il tipo di autenticazione

Il connettore supporta i tipi di autenticazione seguenti:

• App GitHub (per conto dell'utente): consigliata per la maggior parte degli scenari. Immettere l'ID client e il segreto client dall'app GitHub e autorizzare l'accesso.
• App GitHub (installazione):usare una chiave privata generata dall'app GitHub. Immettere l'ID client e il nome dell'organizzazione e caricare la chiave privata. Si noti che questo tipo di autenticazione è attualmente in anteprima. Per usare questo tipo di autenticazione, contattare il supporto tecnico Microsoft.

Per informazioni su come creare un'app GitHub, vedere Usare un'app GitHub personalizzata per l'autenticazione.

Eseguire l'implementazione

Per eseguire l'implementazione a un gruppo di destinatari limitato, scegliere l'interruttore accanto a Implementazione a gruppi di destinatari limitati e specificare gli utenti e i gruppi a cui distribuire il connettore. Per altre informazioni, vedere Implementazione temporanea per i connettori Copilot.

Scegliere Crea per distribuire la connessione. Il connettore Copilot per i problemi del server GitHub avvia immediatamente l'indicizzazione del contenuto.

Nella tabella seguente sono elencati i valori predefiniti impostati quando si distribuisce il connettore.

Per personalizzare questi valori, scegliere Configurazione personalizzata. Per altre informazioni, vedere Personalizzare le impostazioni.

Dopo aver creato la connessione, è possibile esaminare lo stato nella sezione Connettori del interfaccia di amministrazione di Microsoft 365.

Personalizzare le impostazioni (facoltativo)

È possibile personalizzare i valori predefiniti per le impostazioni del connettore GitHub Server Issues. Per personalizzare le impostazioni, nella pagina del connettore nell'interfaccia di amministrazione scegliere Configurazione personalizzata.

Personalizzare le impostazioni utente

Autorizzazioni di accesso

Configurare le autorizzazioni di accesso per assicurarsi che solo gli utenti autorizzati possano visualizzare i problemi di GitHub in Copilot e Microsoft Search.

Mapping delle identità

Per assicurarsi che le autorizzazioni vengano applicate correttamente, eseguire il mapping delle identità utente di GitHub a Microsoft Entra ID. Scegliere una delle opzioni seguenti per il mapping:

• Email: esegue il mapping della posta elettronica di GitHub alle proprietà dell'utente Microsoft Entra ID.
• Login: 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 altre informazioni, vedere Mapping delle identità Microsoft Entra.

Se l'amministratore dell'organizzazione imposta le autorizzazioni predefinite per i membri per limitare l'accesso al repository, il connettore rispetta questa impostazione. Gli utenti non possono visualizzare i repository dell'organizzazione a meno che non vengano aggiunti in modo esplicito come collaboratori.

Per le aziende che usano il modello BYOU (anziché Enterprise Managed Users), ogni utente deve abilitare l'autorizzazione per condividere il campo di identità utente specifico necessario per il mapping nelle impostazioni dell'account GitHub per consentire il mapping delle identità.

Personalizzare le impostazioni del contenuto

Filtro contenuto

È possibile configurare un filtro dell'intervallo di tempo per il connettore. L'impostazione predefinita è 365 giorni.

Gestire le proprietà

Verificare i mapping delle proprietà nei dati di esempio per metadati quali contenuto, etichette, descrizione e timestamp.

Personalizzare gli intervalli di sincronizzazione

È possibile configurare ricerche per indicizzazione incrementali e complete. Tuttavia, è consigliabile solo negli ambienti tra foreste.

• La ricerca per indicizzazione incrementale viene eseguita ogni 15 minuti.
• La ricerca per indicizzazione completa viene eseguita ogni giorno.

Per altre informazioni, vedere Linee guida per le impostazioni di sincronizzazione.

Contenuto correlato

• Panoramica del connettore GitHub Server Issues
• Risolvere i problemi relativi al connettore GitHub Server Issues
• Configurare i connettori Copilot nel interfaccia di amministrazione di Microsoft 365