Configurazione di Microsoft Teams

Anteprima pubblica: la ricerca federata è in anteprima pubblica. Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questa pagina descrive come configurare l'autenticazione e le autorizzazioni prima di creare il datastore Microsoft Teams.

Configurare l'autenticazione e le autorizzazioni

Devi configurare l'autenticazione e le autorizzazioni in Microsoft 365, che è fondamentale per consentire a Gemini Enterprise di accedere ai dati di Microsoft Teams.

Registrazione dell'app Entra per il datastore Microsoft Teams

Prima di creare il datastore Gemini Enterprise, devi configurare una registrazione dell'applicazione Microsoft Entra per consentire l'accesso sicuro a Microsoft Teams.

Per registrare Gemini Enterprise come applicazione OAuth 2.0 in Microsoft Entra:

1. Vai al Centro amministrativo Microsoft Entra.
2. Nel menu, espandi la sezione Entra ID e seleziona Registrazioni di app.
3. Nella pagina Registrazioni di app, seleziona Aggiungi Nuova registrazione.
4. Nella pagina Registra un'applicazione, crea una registrazione dell'app procedendo nel seguente modo:
   1. Nella sezione Nome, inserisci un nome visualizzato per l'applicazione.

      

      Pagina Registra un'applicazione

   2. Nella sezione Tipi di account supportati, seleziona Solo account nella directory dell'organizzazione. Questa opzione limita l'accesso agli utenti all'interno del tenant Microsoft Entra della tua organizzazione, il che è appropriato per un'applicazione aziendale.
   3. Nella sezione URI di reindirizzamento, seleziona Web e inserisci il seguente URL come URL di callback web (o URL di reindirizzamento):
      • https://vertexaisearch.cloud.google.com/oauth-redirect
   4. Fai clic su Registra. Microsoft Entra crea l'app e la visualizza nella pagina Tutte le applicazioni.

Creare una configurazione OAuth 2.0

Per creare una connessione utilizzando il metodo di autenticazione OAuth 2.0, ottieni un ID client, un client secret e un ID tenant dalla pagina di registrazione dell'applicazione Microsoft Entra seguendo questi passaggi.

Ottenere l'ID client e il client secret

Per ottenere l'ID client e il secret dell'app app:

1. Vai al Centro amministrativo Microsoft Entra.
2. Nel menu, espandi la sezione Entra ID e seleziona Registrazioni di app.
3. Nella pagina Registrazioni di app, seleziona Tutte le applicazioni.
4. Apri l'applicazione che hai creato.
5. Nella pagina dell'app, seleziona Certificati e secret.
6. Fai clic su Aggiungi Nuovo client secret.
7. Per ottenere il client secret, nella finestra di dialogo Aggiungi un client secret :
   1. Inserisci una descrizione per il secret.

      

      Finestra di dialogo Aggiungi un client secret

   2. Seleziona una durata di scadenza. Ti consigliamo di selezionare il valore predefinito.
   3. Fai clic su Aggiungi.
   4. Copia il client secret dalla colonna Valore.
8. Per ottenere l'ID client:
   1. Nella pagina dell'app, seleziona Panoramica.
   2. Copia l'ID applicazione (client).

Ottenere l'ID tenant

Puoi trovare l'ID tenant nella casella ID tenant nella pagina di panoramica del Centro amministrativo Microsoft Entra.

Ottieni l'ID tenant

Configurare le autorizzazioni di Microsoft Graph

Per configurare le autorizzazioni di Microsoft Graph richieste per l'app:

1. Vai al Centro amministrativo Microsoft Entra.
2. Nel menu di navigazione, espandi la sezione Entra ID e seleziona Registrazioni di app.
3. Nella pagina Registrazioni di app, seleziona Tutte le applicazioni.
4. Apri l'applicazione che hai creato.
5. Nella pagina dell'app, seleziona Autorizzazioni API.
6. Fai clic su Aggiungi un'autorizzazione.
7. Nella pagina Richiedi autorizzazioni API , seleziona Microsoft Graph e poi Autorizzazioni delegate.

8. Cerca e seleziona le seguenti autorizzazioni per la modalità di connessione. Assicurati che un amministratore conceda il consenso per tutte le autorizzazioni delegate elencate nella tabella seguente. Una volta concesso il consenso, la colonna Stato mostra Concesso con un segno di spunta verde (✓).

   Modalità di connessione	Autorizzazione	Tipo di autorizzazione	Finalità
   Ricerca federata	Chat.Read	Delegato	Consente all'app di leggere tutte le chat.
   	Chat.ReadBasic	Delegato	Consente all'app di leggere le proprietà di base delle chat.
   	ChatMessage.Read	Delegato	Consente all'app di leggere tutti i messaggi di chat uno a uno e di gruppo.
   	Channel.ReadBasic.All	Delegato	Consente all'app di leggere i nomi e le descrizioni dei canali.
   	ChannelMessage.Read.All	Delegato	Consente all'app di leggere i messaggi dei canali utente.
   	Team.ReadBasic.All	Delegato	Consente all'app di leggere i nomi e le descrizioni dei team.
   	User.Read.All	Delegato	Consente all'app di leggere i profili completi di tutti gli utenti.
   Ricerca federata e azioni	Chat.Read	Delegato	Consente all'app di leggere tutte le chat.
   	Chat.ReadBasic	Delegato	Consente all'app di leggere le proprietà di base delle chat.
   	ChatMessage.Read	Delegato	Consente all'app di leggere tutti i messaggi di chat uno a uno e di gruppo.
   	Channel.ReadBasic.All	Delegato	Consente all'app di leggere i nomi e le descrizioni dei canali.
   	ChannelMessage.Read.All	Delegato	Consente all'app di leggere i messaggi dei canali utente.
   	Team.ReadBasic.All	Delegato	Consente all'app di leggere i nomi e le descrizioni dei team.
   	User.Read.All	Delegato	Consente all'app di leggere i profili completi di tutti gli utenti.
   	ChannelMessage.Send	Delegato	Consente all'app di inviare messaggi in qualsiasi canale.
   	ChatMessage.Send	Delegato	Consente all'app di inviare messaggi di chat.

   Nota: se intendi utilizzare il datastore solo per la ricerca e non per eseguire azioni che modificano i contenuti in Microsoft Teams, puoi limitare l'ambito alle autorizzazioni Read.All. Sono necessarie altre autorizzazioni per le azioni che comportano l'aggiornamento dei contenuti in Microsoft Teams.

9. Fai clic su Aggiungi autorizzazioni.

Concedere il consenso amministratore per le autorizzazioni

Per concedere il consenso amministratore per le autorizzazioni:

1. Accedi al Centro amministrativo Microsoft Entra come amministratore globale o dell'applicazione.
2. Nel menu di navigazione, espandi la sezione Entra ID e seleziona Registrazioni di app.
3. Nella pagina Registrazioni di app, seleziona Tutte le applicazioni.
4. Apri l'applicazione che hai creato.
5. Nella pagina dell'app, seleziona Autorizzazioni API.

6. Fai clic sul pulsante Concedi il consenso amministratore per.

   

   Concedi il consenso amministratore

7. Seleziona Sì nella finestra di dialogo per confermare l'azione di consenso.