Connettore Microsoft Graph wiki di Azure DevOps

Il connettore Microsoft Graph wiki di Azure DevOps wiki consente all'organizzazione di indicizzare i wiki nell'istanza del servizio Azure DevOps. Dopo aver configurato il connettore, gli utenti finali possono cercare wiki di progetto e wiki di codice da Azure DevOps in Microsoft Search e Microsoft 365 Copilot.

Questo articolo è destinato agli amministratori di Microsoft 365 o a chiunque configuri, eseggi e monitori un connettore Microsoft Graph wiki di Azure DevOps.

Importante

Il connettore Microsoft Graph wiki di Azure DevOps supporta solo il servizio cloud Azure DevOps. Azure DevOps Server 2019, TFS 2018, TFS 2017, TFS 2015 e TFS 2013 non sono supportati da questo connettore.

Funzionalità

• Indicizzare wiki da Azure DevOps
• Abilitare gli utenti finali per porre domande relative a wiki di progetto e wiki di codice.
• Usare la ricerca semantica in Copilot per consentire agli utenti di trovare contenuti pertinenti in base a parole chiave, preferenze personali e connessioni di social networking.

Limitazioni

• Il connettore indicizza solo un'organizzazione ADO per ogni connessione.

Prerequisiti

• È necessario essere l'amministratore della ricerca per il tenant di Microsoft 365 dell'organizzazione.

• Per consentire al connettore di connettersi all'organizzazione di Azure DevOps, è necessario abilitare l'accesso alle applicazioni di terze parti tramite OAuth. Per altre informazioni, vedere la documentazione di Azure DevOps per gestire i criteri di sicurezza .

  

• Account del servizio: per connettersi ad Azure DevOps e consentire al connettore Microsoft Graph di aggiornare regolarmente i wiki, è necessario un account del servizio con le autorizzazioni seguenti concesse.

  Nome autorizzazione	Tipo di autorizzazione	Obbligatorio per
  Visualizzare informazioni a livello di progetto	Autorizzazione progetto	Ricerca per indicizzazione di elementi di lavoro di Azure DevOps. Questa autorizzazione è obbligatoria per i progetti che devono essere indicizzati.

  Importante

  L'account del servizio deve avere il livello di accesso Basic . Per altre informazioni sui livelli di accesso in Azure DevOps, vedere Livelli di accesso supportati.

Introduzione

1. Nome visualizzato

Un nome visualizzato viene usato per identificare ogni citazione in Copilot, consentendo agli utenti di riconoscere facilmente il file o l'elemento associato. Il nome visualizzato indica anche contenuto attendibile. Il nome visualizzato viene usato anche come filtro dell'origine di contenuto. Per questo campo è presente un valore predefinito, ma è possibile personalizzarlo in base a un nome riconosciuto agli utenti dell'organizzazione.

2. Tipo di autenticazione

Per autenticare e sincronizzare wiki da Azure DevOps, scegliere uno dei due metodi supportati:

Importante

• Microsoft Entra ID OAuth è in anteprima e disponibile per selezionare i clienti. Questo è il meccanismo OAuth consigliato .
• Azure DevOps OAuth è il meccanismo di autenticazione legacy su cui non viene investito attivamente.

a. Microsoft Entra ID OAuth (anteprima)

Assicurarsi che l'organizzazione ADO sia connessa a Microsoft Entra

Il connettore Graph di Azure DevOps indicizza solo il contenuto di un'organizzazione ADO connessa con Microsoft Entra del tenant. Per assicurarsi che l'organizzazione ADO sia connessa con Microsoft Entra account, seguire questa procedura.

1. Passare ad Azure DevOps e selezionare l'organizzazione necessaria.
2. Selezionare Organization settings.
3. Nel riquadro di spostamento a sinistra selezionare Microsoft Entra sotto l'intestazione "Generale".
4. Assicurarsi che l'organizzazione sia connessa all'account Microsoft Entra del tenant.

Creare un'app in Microsoft Entra ID

1. Passare alla portale di Azure e accedere con le credenziali di amministratore per il tenant.
2. Passare a Microsoft Entra ID ->Manage ->Registrazioni app dal riquadro di spostamento e selezionare Nuova registrazione.
3. Specificare un nome per l'app e selezionare Registra.
4. Prendere nota dell'ID applicazione (client). Questo ID viene usato per concedere all'app Microsoft Entra l'accesso ai progetti nell'organizzazione ADO.
5. Aprire autorizzazioni API dal riquadro di spostamento e selezionare Aggiungi un'autorizzazione.
6. Selezionare Azure DevOps e quindi Autorizzazioni delegate.
7. Cercare le autorizzazioni seguenti e selezionare Aggiungi autorizzazioni.
   a. Identità (lettura)
   b. Codice (lettura)
   c. Diritti (lettura)
   d. Progetto e team (lettura)
   e. Grafico (lettura)
   f. MemberEntitlement Management (lettura)
   g. Wiki (lettura)
8. Selezionare Concedi consenso amministratore per [TenantName] e confermare selezionando Sì.
9. Verificare che le autorizzazioni siano nello stato "Concesso".
10. Aprire Autenticazione dal riquadro di spostamento. Selezionare Add a platform e scegliere Web. Aggiungere uno degli URI seguenti in "URI di reindirizzamento":
    • Per M365 Enterprise: https://gcs.office.com/v1.0/admin/oauth/callback
    • Per M365 Government: https://gcsgcc.office.com/v1.0/admin/oauth/callback
11. In Concessione implicita e flussi ibridi controllare l'opzione e ID tokens (used for implicit and hybrid flows) fare clic su Configura.
12. Nel riquadro di spostamento selezionare Certificati e segreti in Gestisci.
13. Selezionare Nuovo segreto client e selezionare un periodo di scadenza per il segreto. Copiare il segreto generato (Valore) e salvarlo perché non viene visualizzato di nuovo.
14. Usare questo segreto client e l'ID applicazione per configurare il connettore.

Concedere all'app Microsoft Entra l'accesso ai progetti nell'organizzazione ADO

È necessario fornire all'app Microsoft Entra l'accesso necessario ai progetti che devono essere indicizzati seguendo questa procedura:

1. Passare ad Azure DevOps e selezionare l'organizzazione necessaria.
2. Selezionare Organization settings.
3. Nel riquadro di spostamento a sinistra selezionare Users sotto l'intestazione "Generale".
4. Selezionare Add users.
5. Copiare l'ID applicazione (client) ottenuto dall'app in "Utenti o entità servizio".
6. Concedere il Basic livello di accesso e selezionare i progetti per consentire l'accesso all'indice. Aggiungere anche al Project Reader gruppo Azure DevOps (o equivalente) per garantire l'accesso. Deselezionare l'opzione per inviare l'invito tramite posta elettronica agli utenti.

Azure DevOps OAuth

Per connettersi all'istanza di Azure DevOps, sono necessari l'ID app dell'organizzazione DevOps di Azure e il segreto client per l'autenticazione OAuth.

Registrare un'app

Registrare un'app in Azure DevOps in modo che l'app Microsoft Search e Microsoft 365 Copilot possano accedere all'istanza. Per registrare l'app, visitare il collegamento per registrare l'applicazione. Per altre informazioni, vedere la documentazione di Azure DevOps su come registrare un'app.

La tabella seguente fornisce indicazioni su come compilare il modulo di registrazione dell'app:

Campi obbligatori	Descrizione	Valore consigliato
Nome dell'azienda	Nome dell'azienda.	Usare un valore appropriato.
Nome applicazione	Valore univoco che identifica l'applicazione che si sta autorizzando.	Microsoft Search.
Sito Web dell'applicazione	URL dell'applicazione che richiede l'accesso all'istanza di Azure DevOps durante l'installazione del connettore. (obbligatorio).	Per Microsoft 365 Enterprise: https:// gcs.office.com/, Per Microsoft 365 Per enti pubblici: https:// gcsgcc.office.com/
URL di callback dell'autorizzazione	URL di callback necessario a cui viene reindirizzato il server di autorizzazione.	Per Microsoft 365 Enterprise: https:// gcs.office.com/v1.0/admin/oauth/callback, For Microsoft 365 Government: https:// gcsgcc.office.com/v1.0/admin/oauth/callback
Ambiti autorizzati	Ambito di accesso per l'applicazione	Selezionare gli ambiti seguenti: Identity (read), Code (read), Entitlements (read), Project and Team (read), Graph (read), Member Entitlement Management (read), Wiki (read).

Importante

Gli ambiti autorizzati selezionati per l'app devono corrispondere esattamente agli ambiti elencati in precedenza. Se sono selezionati più o meno ambiti, l'autorizzazione ha esito negativo.

Durante la registrazione dell'app, si ottengono l'ID app e il segreto client usati per configurare il connettore.

Per revocare l'accesso a qualsiasi app registrata in Azure DevOps, passare a Impostazioni utente nella parte superiore destra dell'istanza di Azure DevOps. Selezionare Profilo e quindi Autorizzazioni nella sezione Sicurezza del riquadro laterale. Passare il puntatore del mouse su un'app OAuth autorizzata per visualizzare il pulsante Revoca nell'angolo dei dettagli dell'app.

3. Selezionare Organizzazione

Il connettore Azure DevOps consente l'indicizzazione di un'organizzazione per ogni connessione. Per connettersi al servizio Azure DevOps, selezionare l'organizzazione corretta nell'elenco delle organizzazioni accessibili all'account del servizio.

4. Distribuire a un pubblico limitato

Distribuire questa connessione in una base di utenti limitata se si vuole convalidarla in Copilot e in altre aree di ricerca prima di espandere l'implementazione a un pubblico più ampio. Per altre informazioni sull'implementazione limitata, vedere Implementazione a fasi.

A questo punto, si è pronti per creare la connessione per i wiki di Azure DevOps. È possibile fare clic su Crea per pubblicare i wiki di connessione e indicizzazione dall'organizzazione Azure DevOps.

Per altre impostazioni, ad esempio autorizzazioni di accesso, regole di inclusione dati, schema, frequenza di ricerca per indicizzazione e così via, sono disponibili impostazioni predefinite basate su ciò che funziona meglio con i dati ADO. Di seguito sono riportati i valori predefiniti:

Utenti	Descrizione
Autorizzazioni di accesso	Solo gli utenti con accesso al contenuto nell'origine dati.
Identità mappa	Identità dell'origine dati mappate tramite ID Microsoft Entra.

Contenuto	Descrizione
Progetti del sito	Tutti i progetti sono indicizzati.
Gestisci proprietà	Per controllare le proprietà predefinite e il relativo schema, vedere contenuto

Sincronizza	Descrizione
Ricerca per indicizzazione incrementale	Frequenza: ogni 15 minuti
Ricerca per indicizzazione completa	Frequenza: ogni giorno

Se si desidera modificare uno di questi valori, è necessario scegliere la "Configurazione personalizzata"

Installazione personalizzata

L'installazione personalizzata è destinata agli amministratori che vogliono modificare i valori predefiniti per le impostazioni elencate nella tabella precedente. Dopo aver fatto clic sull'opzione "Installazione personalizzata", vengono visualizzate altre tre schede: Utenti, Contenuto e Sincronizzazione.

Utenti

Autorizzazioni di accesso

Il connettore Wiki di Azure DevOps supporta le autorizzazioni di ricerca visibili a tutti o solo agli utenti con accesso a questa origine dati. Se si sceglie Tutti, i dati indicizzati vengono visualizzati nei risultati della ricerca per tutti gli utenti. Se si sceglie Solo gli utenti con accesso a questa origine dati, i dati indicizzati vengono visualizzati nei risultati della ricerca per gli utenti che hanno accesso a tale origine.

Nota

Aggiornamenti ai gruppi che controllano le autorizzazioni di accesso vengono sincronizzati solo in ricerche per indicizzazione complete. Le ricerche per indicizzazione incrementali non supportano l'elaborazione degli aggiornamenti alle autorizzazioni.

Contenuto

Scegliere i progetti

In questo passaggio si specifica l'ambito dei dati da indicizzare usando il connettore Microsoft Graph wiki di Azure DevOps. È quindi possibile scegliere la connessione per indicizzare l'intera organizzazione o progetti specifici all'interno dell'organizzazione selezionata.

Se si sceglie di indicizzare l'intera organizzazione, i wiki in tutti i progetti dell'organizzazione vengono indicizzati. I nuovi progetti e wiki vengono indicizzati durante la ricerca per indicizzazione successiva dopo che sono stati creati.

Se si sceglie di indicizzare singoli progetti, vengono indicizzati solo i wiki nei progetti selezionati.

Gestisci proprietà

In questo caso, è possibile aggiungere o rimuovere le proprietà disponibili dall'origine dati di Azure DevOps, assegnare uno schema alla proprietà (definire se una proprietà è ricercabile, ricercabile, recuperabile o perfezionabile), modificare l'etichetta semantica e aggiungere un alias alla proprietà. Di seguito sono elencate le proprietà selezionate per impostazione predefinita.

Source, proprietà	Etichetta	Descrizione	Schema
Autori	Autori	Assegnare un nome a tutte le persone che hanno partecipato o collaborato all'elemento nell'origine dati	Recuperare
CommitId
Contenuto	Contenuto	Corpo del contenuto del wiki	Ricerca
GitItemPath
IconUrl	IconUrl	URL dell'icona che rappresenta il wiki	Recuperare
isParentPage
LastPublishedAuthorEmail	Autore ultima modifica		Recuperare
LastPublishedDate	Data e ora dell'ultima modifica	Data e ora dell'ultima modifica dell'elemento nell'origine dati	Riprovare
Organizzazione			Recuperare
Percorso
Project			Recuperare
ProjectId			Recuperare
RemoteURL	URL	URL del wiki nell'origine dati	Recuperare
Titolo	Titolo	Titolo della pagina wiki	Ricerca, Recupero
Versione			Recuperare
WikiId			Recuperare
WikiIdentifier			Recuperare
WikiType

Anteprima dei dati

Usare il pulsante dei risultati dell'anteprima per verificare i valori di esempio delle proprietà selezionate.

Sincronizza

L'intervallo di aggiornamento determina la frequenza con cui i dati vengono sincronizzati tra l'origine dati e l'indice del connettore Graph. Esistono due tipi di intervalli di aggiornamento: ricerca per indicizzazione completa e ricerca per indicizzazione incrementale. Per altre informazioni, vedere Impostazioni di aggiornamento.

È possibile modificare i valori predefiniti dell'intervallo di aggiornamento da qui, se si vuole.

Configurare la pagina dei risultati della ricerca

Dopo aver pubblicato la connessione, è necessario personalizzare la pagina dei risultati della ricerca con tipi di risultati e verticali. Per informazioni sulla personalizzazione dei risultati della ricerca, vedere come gestire i tipi di risultati e verticali.

È anche possibile usare il layout dei risultati di esempio per il connettore Microsoft Graph wiki di Azure DevOps. È sufficiente copiare e incollare il JSON del layout dei risultati per iniziare.

Risoluzione dei problemi

Dopo aver pubblicato la connessione, è possibile esaminare lo stato nella scheda Origini datinell'interfaccia di amministrazione. Per informazioni su come eseguire aggiornamenti ed eliminazioni, vedere Gestire il connettore. È possibile trovare i passaggi per la risoluzione dei problemi più comuni qui.

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