Cette page explique comment configurer une application tierce avant de créer le data store Microsoft 365.
Configurer l'authentification et les autorisations
Le connecteur Microsoft 365 se connecte en tant qu'utilisateur final à l'aide du flux avec code d'autorisation OAuth 2.0 sur la plate-forme d'identité Microsoft. Toutes les autorisations Microsoft Graph sont déléguées, de sorte que le connecteur ne peut accéder qu'aux données auxquelles l'utilisateur connecté peut déjà accéder. Vous pouvez configurer l'authentification de deux manières :
- OAuth géré parGoogle (OAuth 2.0 (géré par Google), par défaut) : le connecteur utilise une application Microsoft Entra mutualisée queGoogle enregistre et gère. Vous n'enregistrez pas d'application et ne saisissez pas d'ID de locataire, d'ID client ni de code secret du client. Consultez Utiliser OAuth géré par Google.
- Utiliser votre propre application (OAuth 2.0 (Utiliser votre propre application)) : vous enregistrez votre propre application Microsoft Entra, vous lui accordez les autorisations Microsoft Graph pour les actions que vous prévoyez d'activer, puis vous saisissez son ID de locataire, son ID client et son code secret du client dans Gemini Enterprise. Choisissez cette option si votre organisation doit contrôler directement l'application et ses autorisations, si vous avez besoin d'une sortie d'adresse IP statique ou si votre locataire se trouve dans un cloud du gouvernement américain. Consultez Enregistrer une application Microsoft Entra.
Utiliser OAuth géré par Google
Avec OAuth 2.0 (géré par Google), vous ne créez rien dans Microsoft Entra avant de créer le data store. Lorsqu'un utilisateur autorise le connecteur, Microsoft lui demande d'accepter les autorisations Microsoft Graph requises par les actions activées. Pour obtenir la liste complète, consultez Configurer les autorisations de l'API Microsoft.
Certaines de ces autorisations et certaines règles de consentement des locataires nécessitent qu'un administrateur Microsoft Entra donne son consentement au nom de l'organisation. Si les utilisateurs voient un message Approbation de l'administrateur requise lorsqu'ils autorisent le connecteur, un administrateur doit accorder un consentement à l'échelle du locataire pour l'application gérée par Google. Pour en savoir plus, consultez Accorder le consentement administrateur au niveau locataire à une application dans la documentation Microsoft.
Tenez compte des points suivants lorsque vous utilisez OAuth géré par Google :
- L'application gérée par Googleest enregistrée dans le cloud Microsoft commercial. Laissez donc le paramètre Type d'environnement Microsoft 365 défini sur Standard. Pour les locataires de GCC High ou DoD, utilisez OAuth 2.0 (Bring Your Own App).
- La sortie d'adresse IP statique n'est pas disponible, car l'application partagée ne peut pas comporter de liste d'autorisation d'adresses IP par client.
Le reste de cette section ne s'applique qu'à OAuth 2.0 (Bring Your Own App).
Enregistrer une application Microsoft Entra pour le connecteur Microsoft 365
Pour enregistrer Gemini Enterprise en tant qu'application OAuth 2.0 dans Microsoft Entra, procédez comme suit :
Accédez au centre d'administration Microsoft Entra.
Dans le menu de navigation, développez Entra ID, puis sélectionnez App registrations (Enregistrements d'applications).
Sur la page Inscriptions d'applications, cliquez sur Nouvelle inscription.
Sur la page Enregistrer une application, procédez comme suit :
- Dans le champ Nom, saisissez le nom de votre application.
- Dans la section Supported account types (Types de comptes compatibles), sélectionnez Accounts in this organizational directory only (Comptes de ce répertoire organisationnel uniquement).
- Dans la section URI de redirection, procédez comme suit :
- Dans la liste des plates-formes, sélectionnez Web.
- Dans le champ de l'URI de redirection, saisissez
https://vertexaisearch.cloud.google.com/oauth-redirect.
- Cliquez sur S'inscrire. Microsoft Entra crée votre application et affiche sa page de présentation.
Obtenir l'ID client et le code secret du client
Pour obtenir l'ID client, procédez comme suit :
- Dans le menu de navigation de l'application, sélectionnez Vue d'ensemble.
- Copiez l'ID (client) de l'application.
Pour obtenir le code secret du client de l'application, procédez comme suit :
- Dans le menu de navigation de l'application, sélectionnez Certificats et secrets.
- Cliquez sur Nouveau code secret du client.
- Dans le volet du code secret du client, procédez comme suit :
- Dans le champ Description, saisissez une description du secret.
- Dans la liste Expire, sélectionnez une durée de validité.
- Cliquez sur Ajouter.
- Copiez le code secret du client dans la colonne Valeur.
Obtenir l'ID de locataire
Votre ID de locataire se trouve dans le champ ID de locataire de la page de présentation du centre d'administration Microsoft Entra.
Configurer les autorisations de l'API Microsoft
Si vous utilisez OAuth 2.0 (Bring Your Own App), accordez à votre application les autorisations Microsoft Graph déléguées pour les actions que vous prévoyez d'activer. Si vous utilisez OAuth 2.0 (géré par Google), vous n'ajoutez pas ces autorisations vous-même. Les utilisateurs sont invités à les accepter lorsqu'ils autorisent le connecteur.
Les autorisations requises pour chaque action sont listées dans la colonne Autorisations requises des tableaux d'actions compatibles. Chaque connexion nécessite également User.Read et offline_access.
Pour configurer les autorisations d'API requises sur votre propre application, procédez comme suit :
Sur la page de l'application, sélectionnez API permissions (Autorisations des API).
Cliquez sur Ajouter une autorisation.
Sur la page Demander des autorisations d'API, sélectionnez Microsoft Graph, puis Autorisations déléguées.
Recherchez et sélectionnez
User.Read,offline_accesset les autorisations listées pour chaque action que vous prévoyez d'activer.Cliquez sur Ajouter des autorisations.
Clouds souverains et gouvernementaux
Si votre locataire ne se trouve pas dans le cloud Microsoft standard, définissez les deux éléments suivants lorsque vous créez le data store. La connexion via US Government nécessite OAuth 2.0 (Bring Your Own App), avec une application enregistrée dans ce cloud.
Type d'environnement Microsoft 365, dans la section Paramètres d'authentification, sélectionne le point de terminaison de connexion : Standard utilise
login.microsoftonline.comet US Government utiliselogin.microsoftonline.us.Environnement cloud Microsoft 365 : dans la section Options avancées, sélectionnez le point de terminaison Microsoft Graph. Standard/GCC utilise
https://graph.microsoft.com, GCC High utilisehttps://graph.microsoft.uset DoD utilisehttps://dod-graph.microsoft.us.
Dépannage
Cette section décrit les erreurs que vous pouvez rencontrer après avoir configuré l'application Microsoft Entra, ainsi que la manière de les résoudre.
Échec des actions avec l'erreur HTTP 403
Une action qui renvoie une erreur HTTP 403 est généralement due à une autorisation manquante. Vérifiez que l'autorisation requise par l'action a été accordée, que l'autorisation de l'administrateur a été accordée si nécessaire et que la connexion a été réautorisée après l'activation de l'action. Avec OAuth 2.0 (Bring Your Own App), vérifiez également que l'enregistrement de votre application Microsoft Entra accorde l'autorisation. Un jeton d'actualisation existant ne contient que les champs d'application autorisés lors de son émission.
La recherche dans les messages renvoie MailboxNotEnabledForRESTAPI
Cette erreur signifie que la boîte aux lettres n'est pas accessible via Microsoft Graph. Elle se produit lorsque la boîte aux lettres est hébergée sur site dans un déploiement Exchange hybride, lorsqu'elle est inactive ou supprimée de façon réversible, ou en cas d'incohérence au niveau du locataire ou de l'annuaire. Pour résoudre ce problème, assurez-vous que la boîte aux lettres est hébergée dans Exchange Online. Pour en savoir plus, consultez How to fix MailboxNotEnabledForRESTAPI (Résoudre les problèmes liés à MailboxNotEnabledForRESTAPI) dans la documentation Microsoft.