Configurazione di Microsoft Outlook

Questa pagina descrive come configurare una configurazione di terze parti prima di creare il datastore di Outlook.

Configurare l'autenticazione e le autorizzazioni

Devi configurare l'autenticazione e le autorizzazioni nel Centro amministrativo Microsoft Entra. Questo passaggio è fondamentale per consentire al connettore di accedere ai dati e sincronizzarli.

Registrare l'app Entra per il connettore Microsoft Outlook

Prima di creare il connettore Microsoft Outlook in Gemini Enterprise, registra un'applicazione Microsoft Entra per consentire l'accesso sicuro.

Per registrare Gemini Enterprise come applicazione OAuth 2.0 in Entra:

1. Vai al Centro amministrativo Microsoft Entra.
2. Nel menu di navigazione, espandi Entra ID e seleziona Registrazioni di app.
3. Nella pagina Registrazioni di app, fai clic su Nuova registrazione.

4. Nella pagina Registra un'applicazione:

   1. Nel campo Nome, inserisci un nome per l'app.
   2. Nella sezione Tipi di account supportati, seleziona Solo account in questa directory dell'organizzazione.
   3. Nella sezione URI di reindirizzamento :
      1. Nell'elenco delle piattaforme, seleziona Web.
      2. Nel campo URI di reindirizzamento, inserisci https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html.
         1. Fai clic su Registra. Microsoft Entra crea l'app e visualizza la pagina di panoramica dell'app.

5. Nel menu di navigazione dell'app, fai clic su Autenticazione.

6. Fai clic su Aggiungi URI di reindirizzamento.

7. Nel riquadro di selezione della piattaforma:

   1. Seleziona Web.
   2. Nel campo URI di reindirizzamento, inserisci https://vertexaisearch.cloud.google.com/oauth-redirect.
   3. Fai clic su Configura.

Aggiungere una credenziale federata per importazione dati

Se utilizzi Acquisizione dei dati come modalità di connessione e Credenziali federate come metodo di autenticazione:

1. Nel menu di navigazione dell'app, fai clic su Certificati e secret.
2. Seleziona la scheda Credenziali federate.
3. Fai clic su Aggiungi credenziale.
4. Seleziona Altro emittente dall'elenco Scenario di credenziali federate.
5. Nel campo Emittente, inserisci https://accounts.google.com.
6. Nel campo Identificatore soggetto, inserisci il valore che ottieni dalla Google Cloud console. Questo valore viene generato durante la creazione del datastore di Microsoft Outlook nella sezione dei dati.
7. Nel campo Nome, inserisci un'etichetta univoca per la credenziale federata.
8. Fai clic su Aggiungi per concedere l'accesso.

Creare una configurazione OAuth 2.0

Per creare una connessione utilizzando il metodo di autenticazione OAuth 2.0, devi ottenere un ID client, un client secret e l'ID tenant dalla pagina di registrazione dell'applicazione Microsoft Entra.

Ottenere l'ID client e il client secret

1. Per ottenere l'ID client:

   1. Nel menu di navigazione dell'app, seleziona Panoramica.
   2. Copia l'ID applicazione (client).

2. Per ottenere il client secret dell'app:

   1. Nel menu di navigazione dell'app, seleziona Certificati e secret.
   2. Fai clic su Nuovo client secret.
   3. Nel riquadro del client secret:
      1. Nel campo Descrizione, inserisci una descrizione per il secret.
      2. Nell'elenco Scade, seleziona una durata di scadenza.
      3. Fai clic su Aggiungi.
   4. Copia il client secret dalla colonna Valore.

Ottenere l'ID tenant

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

Configurare le autorizzazioni API Microsoft

Per configurare le autorizzazioni API richieste per l'app:

1. Nella pagina dell'app, seleziona Autorizzazioni API.

2. Fai clic su Aggiungi autorizzazioni.

3. Nella pagina Richiedi autorizzazioni API, seleziona Microsoft Graph.

4. Cerca e seleziona le seguenti autorizzazioni in base alla modalità di connessione:

   Modalità di connessione	Autorizzazione	Scopo
   Ricerca federata	Mail.Read Mail.Read.Shared Calendars.Read Contacts.Read	(Delegata) Consente al datastore di leggere la casella di posta dell'utente che ha eseguito l'accesso, la posta delle caselle di posta condivise, gli eventi di calendario e i contatti.
   Acquisizione dei dati	Calendars.Read	(Applicazione) Consente al datastore di leggere gli eventi di tutti i calendari.
   	Calendars.ReadBasic.All	(Applicazione) Consente al datastore di leggere gli eventi di tutti i calendari, ad eccezione delle proprietà come corpo, allegati ed estensioni.
   	Contacts.Read	(Applicazione) Consente al datastore di leggere tutti i contatti in tutte le caselle postali.
   	Mail.Read	(Applicazione) Consente al datastore di leggere la posta in tutte le caselle postali.
   	Mail.ReadBasic	(Applicazione) Consente al datastore di leggere le proprietà di base della posta in tutte le caselle postali. Include tutte le proprietà ad eccezione di corpo, previewBody, allegati e qualsiasi proprietà estesa.
   	Mail.ReadBasic.All	(Applicazione) Consente al datastore di leggere le proprietà di base della posta in tutte le caselle postali. Include tutte le proprietà ad eccezione di corpo, previewBody, allegati e qualsiasi proprietà estesa.
   	User.Read	(Delegata) Consente al datastore di leggere il profilo degli utenti che hanno eseguito l'accesso.
   	User.Read.All	(Applicazione) Consente al datastore di leggere l'insieme completo di proprietà del profilo, report e gestori di altri utenti dell'organizzazione.
   	User.ReadBasic.All	(Applicazione) Consente al datastore di leggere un insieme di base di proprietà del profilo di altri utenti dell'organizzazione.
   Azioni	Mail.Send	(Delegata) Consente al datastore di inviare email come utenti dell'organizzazione.
   	Calendars.ReadWrite	(Delegata) Consente al datastore di creare, leggere, aggiornare ed eliminare gli eventi nei calendari degli utenti.
   	Contacts.ReadWrite	(Delegata) Consente al datastore di creare, leggere, aggiornare ed eliminare i contatti degli utenti.
   	User.Read	(Delegata) Consente al datastore di leggere il profilo degli utenti che hanno eseguito l'accesso.
   Produttività dei file (Excel, Word, PowerPoint)	Files.Read.All	(Delegata) Sufficiente solo per gli strumenti che leggono i metadati dei file o scaricano i contenuti dei file: elencare le cartelle di lavoro di Excel, leggere i metadati delle cartelle di lavoro di Excel e convertire i documenti Word (.docx) o PowerPoint (.pptx) in PDF. Non sufficiente per le operazioni sui contenuti delle cartelle di lavoro di Excel (vedi riga successiva).
   	Files.ReadWrite.All	(Delegata) Obbligatoria per tutte le operazioni sui contenuti delle cartelle di lavoro di Excel (lettura e scrittura), inclusi ottenere fogli di lavoro, ottenere tabelle, ottenere righe, ottenere riga, creare fogli di lavoro e tabelle, aggiungere e aggiornare righe e aggiungere colonne chiave. In base al riferimento dell'API Microsoft Graph per questi endpoint (ad esempio, worksheet-list, table-list, tablerow-list), l'autorizzazione delegata accettata è Files.ReadWrite. Files.ReadWrite.All concede la stessa funzionalità in tutti i Drive a cui l'utente può accedere. Obbligatoria anche per la creazione di documenti Word e PowerPoint in OneDrive dell'utente.
   	User.Read	(Delegata) Obbligatoria per risolvere la posizione di OneDrive dell'utente che ha eseguito l'accesso per le operazioni sui file.
   Attività (elenchi di cose da fare e attività di Outlook)	Tasks.Read	(Delegata) Obbligatoria per le operazioni di lettura sugli elenchi di attività e sulle attività di Outlook dell'utente che ha eseguito l'accesso (elenco degli elenchi di attività, elenco delle attività, ottenere attività).
   	Tasks.ReadWrite	(Delegata) Obbligatoria per le operazioni di scrittura: creazione, aggiornamento ed eliminazione delle attività negli elenchi di attività di Outlook dell'utente che ha eseguito l'accesso.
   Utenti e directory (enumerazione delegata)	User.ReadBasic.All	(Delegata) Obbligatoria per gli strumenti che enumerano o cercano i profili di altri utenti dell'organizzazione (Get User, List Users e strumenti che operano sulle caselle postali o sui calendari di altri utenti).

5. Fai clic su Aggiungi autorizzazioni.

Nota: se intendi utilizzare il datastore solo per la ricerca e non eseguire alcuna azione, puoi limitare gli ambiti a Mail.Read, Calendars.Read e Contacts.Read. Gli altri ambiti sono necessari per eseguire le azioni menzionate in Azioni supportate.

Nota: Per le azioni di produttività dei file su Excel, Word e PowerPoint, concedi Files.ReadWrite.All se prevedi di utilizzare qualsiasi operazione sui contenuti delle cartelle di lavoro di Excel (fogli di lavoro, tabelle, righe). In base ai riferimenti dell'API Microsoft Graph worksheet-list, table-list e tablerow-list, l'autorizzazione delegata accettata per questi endpoint è Files.ReadWrite, quindi Files.Read.All da sola non è sufficiente. Files.Read.All è sufficiente solo per elencare le cartelle di lavoro di Excel, leggere i metadati delle cartelle di lavoro di Excel e la conversione in PDF di Word o PowerPoint. I tenant che saltano l'ambito obbligatorio visualizzeranno errori HTTP 403 accessDenied. Per le operazioni basate su driveItem (conversione in PDF di Word/PowerPoint, elenco delle cartelle di lavoro di Excel, lettura dei metadati delle cartelle di lavoro di Excel), Microsoft Graph documenta anche Sites.Read.All o Sites.ReadWrite.All come alternative accettate (vedi driveItem-get e driveItem-get-content-format).

Nota: gli strumenti per le attività di Outlook richiedono Tasks.Read (leggi elenchi di attività e attività) o Tasks.ReadWrite (crea, aggiorna, elimina attività). Gli strumenti di ricerca utente (Get User, List Users e strumenti che operano sulle caselle postali o sui calendari di altri utenti) richiedono almeno User.ReadBasic.All. I tenant che saltano questi ambiti visualizzeranno HTTP 403 notAllowed sugli strumenti per le attività e HTTP 403 Authorization_RequestDenied sugli strumenti di ricerca utente. I tenant che necessitano di un accesso utente con privilegi più elevati possono sostituire User.Read.All o Directory.Read.All.

Nota: dopo aver aggiunto le autorizzazioni dell'applicazione, devi concedere il consenso dell'amministratore per il tuo tenant. Per maggiori informazioni, vedi Concedere il consenso dell'amministratore a livello di tenant.

Risoluzione dei problemi

Risolvere i problemi relativi all'API REST e alla ricerca di messaggi

Se l'assistente di Gemini Enterprise segnala che la ricerca di messaggi non funziona o che l'API REST non è abilitata per la casella di posta di un utente (corrispondente a un errore MailboxNotEnabledForRESTAPI di Microsoft Graph), puoi risolvere il problema nel tuo ambiente Microsoft.

Questo errore si verifica per i seguenti motivi:

• La casella postale è ospitata on-premise (in un deployment di Exchange ibrido) e non è stata abilitata per l'accesso all'API REST.

• La casella di posta è inattiva o è stata eliminata temporaneamente.

• Si verifica una mancata corrispondenza tra tenant o directory.

Per risolvere il problema, assicurati che la casella di posta sia ospitata in Exchange Online o configura l'accesso all'API REST per le caselle di posta ibride. Per maggiori informazioni, vedi Come correggere MailboxNotEnabledForRESTAPI nella documentazione di Microsoft.