Questa pagina descrive come impostare e configurare una configurazione di terze parti prima di creare il datastore di Outlook.
Configura l'autenticazione e le autorizzazioni
Devi configurare l'autenticazione e le autorizzazioni nell'interfaccia di amministrazione di Microsoft Entra. Questo è fondamentale per consentire al connettore di accedere ai dati e sincronizzarli.
Registra 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, segui questi passaggi:
- Vai al centro di amministrazione di Microsoft Entra.
- Nel menu di navigazione, espandi Entra ID e seleziona Registrazioni di app.
- Nella pagina App registrations (Registrazioni app), fai clic su New registration (Nuova registrazione).
Nella pagina Register an application (Registra un'applicazione), segui questi passaggi:
- Nel campo Nome, inserisci un nome per l'app.
- Nella sezione Tipi di account supportati, seleziona Solo account in questa directory dell'organizzazione.
- Nella sezione URI di reindirizzamento, segui questi passaggi:
- Nell'elenco delle piattaforme, seleziona
Web. - Nel campo URI di reindirizzamento, inserisci
https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html.- Fai clic su Register (Registrati). Microsoft Entra crea l'app e visualizza la pagina di riepilogo dell'app.
- Nell'elenco delle piattaforme, seleziona
Nel menu di navigazione dell'app, fai clic su Authentication.
Fai clic su Aggiungi URI di reindirizzamento.
Nel riquadro di selezione della piattaforma, segui questi passaggi:
- Seleziona Web.
- Nel campo URI di reindirizzamento, inserisci
https://vertexaisearch.cloud.google.com/oauth-redirect. - Fai clic su Configura.
Aggiungi le credenziali federate per l'importazione dati
Se utilizzi Acquisizione dei dati come modalità di connessione e Credenziali federate come metodo di autenticazione, segui questi passaggi:
- Nel menu di navigazione dell'app, fai clic su Certificates & secrets (Certificati e secret).
- Seleziona la scheda Credenziali federate.
- Fai clic su Aggiungi credenziale.
- Seleziona Altro emittente dall'elenco Scenario di credenziali federate.
- Nel campo Issuer (Emittente), inserisci
https://accounts.google.com. - Nel campo Identificatore soggetto, inserisci il valore ottenuto dalla consoleGoogle Cloud . Questo valore viene generato durante la creazione del datastore Microsoft Outlook nella sezione dei dati.
- Nel campo Nome, inserisci un'etichetta univoca per la credenziale federata.
- Fai clic su Add (Aggiungi) per concedere l'accesso.
Crea 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.
Ottieni un ID client e un client secret
Per ottenere l'ID client:
- Nel menu di navigazione dell'app, seleziona Panoramica.
- Copia l'ID applicazione (client).
Per ottenere il client secret per l'app:
- Nel menu di navigazione dell'app, seleziona Certificates & secrets (Certificati e secret).
- Fai clic su Nuovo client secret.
- Nel riquadro del client secret, segui questi passaggi:
- Nel campo Descrizione, inserisci una descrizione per il secret.
- Nell'elenco Scadenza, seleziona una durata di scadenza.
- Fai clic su Aggiungi.
- Copia il client secret dalla colonna Value (Valore).
Ottieni l'ID tenant
Puoi trovare l'ID tenant nella casella ID tenant della pagina Panoramica nell'interfaccia di amministrazione di Microsoft Entra.
Configura le autorizzazioni API Microsoft
Per configurare le autorizzazioni API richieste per l'app, segui questi passaggi:
Nella pagina dell'app, seleziona API permissions (Autorizzazioni API).
Fai clic su Aggiungi autorizzazioni.
Nella pagina Request API permissions (Richiedi autorizzazioni API), seleziona Microsoft Graph.
Cerca e seleziona le seguenti autorizzazioni in base alla modalità di connessione:
Modalità di connessione Autorizzazione Purpose Ricerca federata Mail.ReadMail.Read.Shared
Calendars.ReadContacts.Read(Delegato) 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 nel 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 di proprietà come corpo, allegati ed estensioni. Contacts.Read(Applicazione) Consente al datastore di leggere tutti i contatti in tutte le caselle di posta. 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 di posta. Include tutte le proprietà, ad eccezione di body, previewBody, attachments e di eventuali proprietà estese. Mail.ReadBasic.All(Applicazione) Consente al datastore di leggere le proprietà di base della posta in tutte le caselle di posta. Include tutte le proprietà, ad eccezione di body, previewBody, attachments e di eventuali proprietà estese. User.Read(Delegato) 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 della tua organizzazione. User.ReadBasic.All(Applicazione) Consente al datastore di leggere un insieme di base di proprietà del profilo di altri utenti della tua organizzazione. Azioni Mail.Send(Delegato) Consente al datastore di inviare email come utenti dell'organizzazione. Mail.ReadWrite(Delegato) Obbligatorio per le azioni **Aggiungi allegati**, **Crea messaggio**, **Aggiorna messaggio** e **Sposta email**. Calendars.ReadWrite(Delegato) Consente al datastore di creare, leggere, aggiornare ed eliminare eventi nei calendari degli utenti. Contacts.ReadWrite(Delegato) Consente al datastore di creare, leggere, aggiornare ed eliminare i contatti degli utenti. User.Read(Delegato) Consente al datastore di leggere il profilo degli utenti che hanno eseguito l'accesso. Produttività dei file (Excel, Word, PowerPoint) Files.Read.All(Delegato) Sufficiente solo per gli strumenti che leggono i metadati dei file o scaricano i contenuti dei file: elencare i fogli di lavoro Excel, leggere i metadati dei fogli di lavoro 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 la riga successiva). Files.ReadWrite.All(Delegato) Obbligatorio per tutte le operazioni sui contenuti delle cartelle di lavoro di Excel (lettura e scrittura), tra cui recupero di fogli di lavoro, tabelle, righe e singole righe, creazione di fogli di lavoro e tabelle, aggiunta e aggiornamento di righe e aggiunta di colonne chiave. In base al riferimento API Microsoft Graph per questi endpoint (ad esempio, worksheet-list, table-list, tablerow-list), l'autorizzazione delegata accettata è Files.ReadWrite.Files.ReadWrite.Allconcede la stessa funzionalità su tutti i Drive a cui l'utente può accedere. Inoltre, è necessaria per creare documenti Word e PowerPoint in OneDrive dell'utente.User.Read(Delegato) Obbligatorio 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 di elenchi di attività, elenco di attività, recupero di attività). Tasks.ReadWrite(Delegato) Obbligatorio per le operazioni di scrittura: creazione, aggiornamento ed eliminazione di attività negli elenchi di attività di Outlook dell'utente che ha eseguito l'accesso. Utenti e directory (enumerazione delegata) User.ReadBasic.All(Delegato) Obbligatorio per gli strumenti che enumerano o cercano i profili di altri utenti dell'organizzazione (Get User, List Users e strumenti che operano sulle caselle di posta o sui calendari di altri utenti). Fai clic su Aggiungi autorizzazioni.
Risoluzione dei problemi
Questa sezione descrive come risolvere i problemi comuni relativi al connettore Microsoft Outlook.
Risolvi i problemi relativi all'API REST e alla ricerca dei messaggi
Se l'assistente Gemini Enterprise segnala che la ricerca dei 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 di posta è ospitata on-premise (in un deployment Exchange ibrido) e non è stata abilitata per l'accesso all'API REST.
La casella di posta è inattiva o è stata eliminata temporaneamente.
Esiste 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 saperne di più, consulta Come risolvere il problema MailboxNotEnabledForRESTAPI nella documentazione di Microsoft.
Gli utenti visualizzano il messaggio "È necessaria l'approvazione dell'amministratore" quando si connettono
Quando gli utenti si connettono a Microsoft Outlook dall'app web Gemini Enterprise per la prima volta, Microsoft potrebbe mostrare una schermata È necessaria l'approvazione dell'amministratore. Questo accade se Gemini Enterprise richiede autorizzazioni a livello di amministratore o se il tuo tenant Microsoft Entra impedisce agli utenti di autorizzare app di terze parti senza il previo consenso dell'amministratore a livello di tenant.
Per risolvere il problema, un amministratore deve completare la prima autorizzazione. In seguito, gli altri utenti del tuo tenant potranno connettersi senza la schermata di approvazione.
Chiedi a un amministratore di Microsoft Entra ID che può concedere il consenso a livello di tenant di accedere all'app web Gemini Enterprise e connettersi a Microsoft Outlook.
Nella schermata delle autorizzazioni, l'amministratore deve selezionare Consenti per conto dell'organizzazione e poi fare clic su Accetta.
Chiedi agli utenti di connettersi di nuovo.
Per saperne di più, consulta Concedi il consenso dell'amministratore a livello di tenant nella documentazione di Microsoft Entra.