Questa pagina descrive come configurare un'applicazione di terze parti prima di creare il datastore Microsoft 365.
Configura l'autenticazione e le autorizzazioni
Il connettore Microsoft 365 accede come utente finale utilizzando il flusso del codice di autorizzazione OAuth 2.0 sulla piattaforma di identità Microsoft. Tutte le autorizzazioni di Microsoft Graph sono delegate, quindi il connettore può accedere solo ai dati a cui l'utente che ha eseguito l'accesso può già accedere. Puoi configurare l'autenticazione in uno dei seguenti modi:
- OAuth gestito daGoogle (OAuth 2.0 (gestito da Google), predefinito): il connettore utilizza un'applicazione Microsoft Entra multi-tenant che Google registra e gestisce. Non devi registrare un'applicazione o inserire un ID tenant, un ID client o un client secret. Consulta Utilizza OAuth gestito da Google.
- Bring your own app (OAuth 2.0 (Bring Your Own App)): registri la tua applicazione Microsoft Entra, le concedi le autorizzazioni Microsoft Graph per le azioni che prevedi di attivare e inserisci il relativo ID tenant, ID client e client secret in Gemini Enterprise. Scegli questa opzione se la tua organizzazione deve controllare direttamente l'applicazione e le relative autorizzazioni, se hai bisogno di un IP statico in uscita o se il tuo tenant si trova in un cloud US Government. Consulta Registra un'app Microsoft Entra.
Utilizza OAuth gestito da Google
Con OAuth 2.0 (gestito da Google), non crei nulla in Microsoft Entra prima di creare il datastore. Quando un utente autorizza il connettore, Microsoft gli chiede di acconsentire alle autorizzazioni di Microsoft Graph necessarie per le azioni attivate. Per l'elenco completo, consulta Configura le autorizzazioni API Microsoft.
Alcune di queste autorizzazioni e alcune policy di consenso del tenant richiedono il consenso di un amministratore di Microsoft Entra per conto dell'organizzazione. Se gli utenti visualizzano il messaggio È necessaria l'approvazione dell'amministratore quando autorizzano il connettore, un amministratore deve concedere il consenso a livello di tenant all'applicazione gestita da Google. Per saperne di più, consulta Concedere il consenso dell'amministratore a livello di tenant a un'applicazione nella documentazione di Microsoft.
Quando utilizzi OAuth gestito da Google, tieni presente quanto segue:
- L'applicazione gestita da Googleè registrata nel cloud Microsoft commerciale, quindi lascia l'opzione Tipo di ambiente Microsoft 365 impostata su Standard. Per i tenant in GCC High o DoD, utilizza OAuth 2.0 (Bring Your Own App).
- L'IP statico in uscita non è disponibile perché l'applicazione condivisa non può contenere una lista consentita di IP per cliente.
Il resto di questa sezione si applica solo a OAuth 2.0 (Bring Your Own App).
Registra un'app Microsoft Entra per il connettore Microsoft 365
Per registrare Gemini Enterprise come applicazione OAuth 2.0 in Microsoft Entra, segui questi passaggi:
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/oauth-redirect.
- Fai clic su Register (Registrati). Microsoft Entra crea l'app e visualizza la pagina di riepilogo dell'app.
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 nella pagina Panoramica dell'interfaccia di amministrazione di Microsoft Entra.
Configura le autorizzazioni API Microsoft
Se utilizzi OAuth 2.0 (Bring Your Own App), concedi alla tua app le autorizzazioni Microsoft Graph delegate per le azioni che prevedi di attivare. Se utilizzi OAuth 2.0 (gestito da Google), non devi aggiungere queste autorizzazioni manualmente; agli utenti viene chiesto di acconsentire quando autorizzano il connettore.
Le autorizzazioni necessarie per ogni azione sono elencate nella colonna Autorizzazioni richieste delle tabelle delle azioni supportate. Ogni connessione richiede anche User.Read e offline_access.
Per configurare le autorizzazioni API richieste nella tua app, segui questi passaggi:
Nella pagina dell'app, seleziona Autorizzazioni API.
Fai clic su Aggiungi un'autorizzazione.
Nella pagina Richiedi autorizzazioni API, seleziona Microsoft Graph, quindi seleziona Autorizzazioni delegate.
Cerca e seleziona
User.Read,offline_accesse le autorizzazioni elencate per ogni azione che prevedi di attivare.Fai clic su Aggiungi autorizzazioni.
Cloud sovereign e governativi
Se il tuo tenant non si trova nel cloud Microsoft standard, imposta entrambi i seguenti valori quando crei il datastore. L'accesso tramite US Government richiede OAuth 2.0 (Bring Your Own App), con un'app registrata in quel cloud.
Tipo di ambiente Microsoft 365, nella sezione Impostazioni di autenticazione, seleziona l'endpoint di accesso: Standard utilizza
login.microsoftonline.come US Government utilizzalogin.microsoftonline.us.Ambiente cloud Microsoft 365, nella sezione Opzioni avanzate, seleziona l'endpoint Microsoft Graph: Standard/GCC utilizza
https://graph.microsoft.com, GCC High utilizzahttps://graph.microsoft.use DoD utilizzahttps://dod-graph.microsoft.us.
Risoluzione dei problemi
Questa sezione descrive gli errori che potresti riscontrare dopo aver configurato l'applicazione Microsoft Entra e come risolverli.
Azioni non riuscite con HTTP 403
Un'azione che restituisce l'errore HTTP 403 di solito non dispone di un'autorizzazione. Verifica che l'autorizzazione richiesta dall'azione sia stata concessa, che il consenso dell'amministratore sia stato concesso dove richiesto e che la connessione sia stata riautorizzata dopo l'attivazione dell'azione. Con OAuth 2.0 (Bring Your Own App), verifica anche che la registrazione dell'app Microsoft Entra conceda l'autorizzazione. Un token di aggiornamento esistente contiene solo gli ambiti per cui è stato dato il consenso al momento dell'emissione.
La ricerca nella posta restituisce MailboxNotEnabledForRESTAPI
Questo errore indica che la casella di posta non è raggiungibile tramite Microsoft Graph. Si verifica quando la casella di posta è ospitata on-premise in un'implementazione di Exchange ibrida, quando la casella di posta è inattiva o eliminata temporaneamente o quando si verifica una mancata corrispondenza del tenant o della directory. Per risolvere il problema, assicurati che la casella di posta sia ospitata in Exchange Online. Per saperne di più, consulta Come risolvere il problema MailboxNotEnabledForRESTAPI nella documentazione di Microsoft.