Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il connettore GitLab Issues Server Microsoft 365 Copilot integra i dati dei problemi di GitLab in Microsoft 365. Quando si distribuisce questo connettore, Microsoft 365 Copilot e Microsoft Search possono riscontrare problemi GitLab rilevanti direttamente in app come Teams, Outlook e SharePoint. Questo articolo descrive i passaggi per distribuire e configurare il connettore GitLab Issues Server.
Prerequisiti
Prima di distribuire il connettore, assicurarsi di soddisfare i prerequisiti seguenti:
- Verificare che l'istanza di GitLab sia accessibile tramite API.
- Generare un ID client e un segreto client da GitLab per l'autenticazione.
- Assicurarsi che l'account di autenticazione abbia accesso a repository, problemi, richieste di unione, file di informazioni e pagine wiki.
- Assicurarsi che gli ambiti OAuth di GitLab includano gli ambiti seguenti:
read_api, ,read_repositoryread_user. - Assicurarsi che gli utenti che accedono ai dati GitLab indicizzati dispongano di identità Microsoft Entra ID per il mapping delle autorizzazioni.
- Impostare gli URL di reindirizzamento corretti durante l'installazione dell'autenticazione GitLab:
- Microsoft 365 Enterprise:
https://gcs.office.com/v1.0/admin/oauth/callback - Microsoft 365 Per enti pubblici:
https://gcsgcc.office.com/v1.0/admin/oauth/callback
- Microsoft 365 Enterprise:
- Per le istanze GitLab autogestiti, assicurarsi che:
- Si dispone di GitLab versione 17.7 o successiva.
- L'agente connettore Microsoft Graph versione 3.1.8.0 o successiva è installato in un server con accesso a GitLab.
- L'account di autenticazione dispone di privilegi amministrativi per la ricerca per indicizzazione dell'elenco di controllo di accesso (ACL).
- Per ottenere prestazioni ottimali, modificare i limiti di frequenza di GitLab come consigliato:
- Limiti di frequenza per utenti e IP: deselezionare Abilita limite di frequenza delle richieste API autenticate e Abilita limite di frequenza delle richieste Web autenticate.
- Limiti di frequenza dell'API File: deselezionare Abilita limite di frequenza delle richieste API autenticate.
- Limiti di frequenza delle API deprecati: deselezionare Abilita limite di frequenza delle richieste API autenticate.
- Limiti di frequenza dell'API Utenti: impostare Max requests per 10 minuti per utente su un valore elevato (ad esempio, 100000).
- Limiti di frequenza api e progetti per gruppi: impostare tutti i valori su 0 per disabilitare i limiti.
- Limiti di frequenza dell'API Membri: impostato su 0.
Raccomandazioni relative ai limiti di frequenza
Usare le linee guida nella tabella seguente per scegliere le impostazioni relative al limite di frequenza in base al numero approssimativo di problemi di GitLab.
| Numero approssimativo di elementi | Impostazione consigliata per il limite di frequenza | Tempo di inserimento approssimativo |
|---|---|---|
| Fino a 100.000 | 20.000 richieste/ora | Da ore a un giorno |
| Da 100.000 a 1.000.000 | 25.000 richieste/ora | Da due giorni a una settimana |
| 1.000.000 o più | 25.000 richieste/ora | 1-2 settimane (varia in base al carico dell'ambiente) |
Distribuire il connettore
Per aggiungere il connettore GitLab Issues Server per l'organizzazione:
- Nel riquadro sinistro della interfaccia di amministrazione di Microsoft 365 scegliere Connettori Copilot>.
- Scegliere la scheda Raccolta .
- Nell'elenco dei connettori disponibili scegliere GitLab Issues Server.
Impostare il nome visualizzato
Il nome visualizzato identifica i riferimenti nelle risposte copilot e consente agli utenti di riconoscere l'origine di contenuto associata.
È possibile accettare il nome visualizzato predefinito del server GitLab Issues o personalizzarlo.
Impostare l'URL dell'istanza
Specificare l'URL di base dell'istanza di GitLab Server. L'URL di base è l'URL usato dal connettore per accedere ai dati del problema tramite le API REST GitLab.
Scegliere Graph Connector Agent
Selezionare l'agente connettore Microsoft Graph che gestisce l'inserimento di dati GitLab in Microsoft 365. Per altre informazioni, vedere Agente connettore Microsoft Graph.
Scegliere il tipo di autenticazione
Il connettore GitLab Issues Server supporta OAuth 2.0. Immettere l'ID client e il segreto client di GitLab e quindi scegliere Autorizza.
Eseguire l'implementazione
Per distribuire il connettore a un gruppo di destinatari limitato, scegliere l'interruttore accanto a Implementazione a gruppi di destinatari limitati e specificare utenti o gruppi.
Scegliere Crea per distribuire la connessione. Il connettore GitLab Issues Server avvia immediatamente l'indicizzazione del contenuto.
Per personalizzare la connessione, scegliere Configurazione personalizzata. Per altre informazioni, vedere Personalizzare le impostazioni
Dopo aver creato la connessione, è possibile esaminarne lo stato in Connettori Copilot> nel interfaccia di amministrazione di Microsoft 365.
Personalizzare le impostazioni (facoltativo)
È possibile personalizzare i valori predefiniti per le impostazioni del connettore GitLab Issues Server. Per personalizzare le impostazioni, scegliere Configurazione personalizzata nella pagina del connettore.
Personalizzare le impostazioni utente
Autorizzazioni di accesso
Scegliere se i dati indicizzati sono visibili a:
- Solo gli utenti con accesso a questa origine dati (impostazione predefinita)
- Tutti
Se si sceglie Solo le persone con accesso a questa origine dati, i dati indicizzati vengono visualizzati solo per gli utenti autorizzati. Se si sceglie Tutti, i dati indicizzati vengono visualizzati per tutti gli utenti.
Esegui il mapping delle identità
Eseguire il mapping delle identità utente di GitLab a Microsoft Entra ID. Le opzioni disponibili sono:
- Email: esegue il mapping della posta elettronica di GitLab alle proprietà utente Microsoft Entra ID.
- Accesso: esegue il mapping degli account di accesso di GitLab con Microsoft Entra ID proprietà utente.
- Nome: esegue il mapping del nome GitLab 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.
Personalizzare le impostazioni del contenuto
Nella scheda Dati è possibile verificare i mapping delle proprietà nei dati di esempio per metadati quali contenuto, etichette, descrizione e timestamp.
Filtro contenuto
È possibile configurare un filtro dell'intervallo di tempo per il connettore. L'impostazione predefinita è 365 giorni.
Gestire le proprietà
È possibile aggiungere o rimuovere le proprietà disponibili dall'origine dati, assegnare uno schema alla proprietà (ricercabile, ricercabile, recuperabile o perfezionabile), modificare l'etichetta semantica e aggiungere un alias alla proprietà .
Personalizzare gli intervalli di sincronizzazione
Configurare gli intervalli di sincronizzazione della ricerca per indicizzazione completi e incrementali . Di seguito sono riportati i valori predefiniti:
- Ricerca per indicizzazione incrementale: ogni 15 minuti
- Ricerca per indicizzazione completa: giornaliera
Modificare gli intervalli in base alle esigenze dell'organizzazione.