Configuration de Microsoft OneDrive

Cette page explique comment configurer une configuration tierce avant de créer le data store OneDrive.

Configurer l'authentification et les autorisations

Vous devez configurer l'authentification et les autorisations dans Microsoft 365. Cette étape est cruciale pour permettre au connecteur d'accéder aux données et de les synchroniser. Le connecteur OneDrive est compatible avec différentes méthodes d'authentification, telles que les identifiants client OAuth ou les jetons d'API.

Enregistrer l'application Microsoft Entra pour le connecteur Microsoft OneDrive

Pour pouvoir créer le connecteur dans Gemini Enterprise, vous devez configurer un enregistrement d'application Entra pour permettre un accès sécurisé à Microsoft OneDrive.

Pour enregistrer Gemini Enterprise en tant qu'application OAuth 2.0 dans Entra, procédez comme suit :

  1. Accédez au centre d'administration Microsoft Entra.
  2. Dans le menu de navigation, développez Entra ID, puis sélectionnez App registrations (Enregistrements d'applications).
  3. Sur la page Inscriptions d'applications, cliquez sur Nouvelle inscription.
  4. Sur la page Enregistrer une application, procédez comme suit :

    1. Dans le champ Nom, saisissez le nom de votre application.
    2. 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).
    3. Dans la section URI de redirection, procédez comme suit :
      1. Dans la liste des plates-formes, sélectionnez Web.
      2. Dans le champ de l'URI de redirection, saisissez https://vertexaisearch.cloud.google.com/console/oauth/default_oauth.html.
    4. Cliquez sur S'inscrire. Microsoft Entra crée votre application et affiche sa page de présentation.
  5. Dans le menu de navigation de l'application, cliquez sur Authentication (Authentification).

  6. Cliquez sur Ajouter un URI de redirection.

  7. Dans le volet de sélection de la plate-forme, procédez comme suit :

    1. Sélectionnez Web.
    2. Dans le champ URI de redirection, saisissez https://vertexaisearch.cloud.google.com/oauth-redirect.
    3. Cliquez sur Configurer.

Ajouter des identifiants fédérés pour l'ingestion de données

Si vous utilisez Ingestion de données comme mode de connexion et Identifiants fédérés comme méthode d'authentification, procédez comme suit :

  1. Dans le menu de navigation de l'application, cliquez sur Certificats et codes secrets.
  2. Sélectionnez l'onglet Identifiants fédérés.
  3. Cliquez sur Ajouter un identifiant.
  4. Sélectionnez Other issuer (Autre émetteur) dans la liste Federated credential scenario (Scénario d'identifiants fédérés).
  5. Dans le champ Émetteur, saisissez https://accounts.google.com.
  6. Dans le champ Identifiant de l'objet, saisissez la valeur que vous obtenez à partir de la console Google Cloud . Cette valeur est générée lors de la création du data store Microsoft OneDrive dans la section "Données".
  7. Dans le champ Nom, saisissez un libellé unique pour l'identifiant fédéré.
  8. Cliquez sur Add (Ajouter) pour accorder l'accès.

Créer une configuration OAuth 2.0

Pour créer une connexion à l'aide de la méthode d'authentification OAuth 2.0, vous devez obtenir un ID client, un code secret du client et votre ID de locataire sur la page d'enregistrement de l'application Microsoft Entra.

Obtenir l'ID client et le code secret du client

  1. Pour obtenir l'ID client, procédez comme suit :

    1. Dans le menu de navigation de l'application, sélectionnez Vue d'ensemble.
    2. Copiez l'ID (client) de l'application.
  2. Pour obtenir le code secret du client de l'application, procédez comme suit :

    1. Dans le menu de navigation de l'application, sélectionnez Certificats et secrets.
    2. Cliquez sur New client secret (Nouveau code secret du client).
    3. Dans le volet du code secret du client, procédez comme suit :
      1. Dans le champ Description, saisissez une description du secret.
      2. Dans la liste Expire, sélectionnez une durée de validité.
      3. Cliquez sur Ajouter.
    4. Copiez le code secret du client dans la colonne Valeur.

Obtenir l'ID du 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

Pour configurer les autorisations d'API requises pour l'application, procédez comme suit :

  1. Accédez à la page de l'application.
  2. Dans le menu de navigation de l'application, sélectionnez Autorisations des API.

  3. Cliquez sur Ajouter des autorisations.

  4. Dans le volet Demander des autorisations d'API, sélectionnez Microsoft Graph.

  5. Recherchez et sélectionnez les autorisations suivantes en fonction de votre mode de connexion :

Mode de connexion Type Scope (Portée) Purpose
Recherche fédérée Délégué Files.Read.All Permet au data store de lire tous les fichiers auxquels l'utilisateur peut accéder.
Délégué Sites.Read.All Permet au data store de lire les documents et de lister les éléments de toutes les collections de sites auxquelles l'utilisateur a accès.
Délégué User.Read.All Permet au data store de résoudre les emplacements Drive des utilisateurs pour la découverte de contenu.
Ingestion de données Application Files.Read.All Permet au data store de lire et de synchroniser des fichiers dans l'organisation sans qu'un utilisateur soit connecté.
Application Group.Read.All Permet au data store de lire les propriétés et les appartenances de tous les groupes.
Application GroupMember.Read.All Permet au data store de lire les appartenances de tous les groupes pour gérer la synchronisation du contrôle des accès (LCA).
Délégué User.Read Permet au data store de lire le profil et les informations de base sur l'entreprise des utilisateurs connectés.
Application Sites.FullControl.All Permet de contrôler entièrement toutes les collections de sites.
Application Sites.Selected Permet d'accéder à un sous-ensemble spécifique de collections de sites.
Identifiants fédérés uniquement User.Read.All Permet au data store de lire les profils utilisateur.
Délégué User.ReadBasic.All Permet de lire un ensemble de base de propriétés de profil pour les utilisateurs de l'organisation.
Actions Délégué Files.ReadWrite.AppFolder Permet au data store de lire, créer, mettre à jour et supprimer des fichiers dans le dossier Microsoft OneDrive.
Délégué Files.ReadWrite Permet au data store de lire, télécharger, créer, importer, modifier et supprimer les fichiers auxquels l'utilisateur a accès.
Délégué Files.ReadWrite.All Permet au data store de lire et de mettre à jour les fichiers sur tous les Drive auxquels l'utilisateur a accès. Obligatoire pour les actions de mutation de fichiers et de dossiers (copier, déplacer, renommer, partager, mettre à jour les propriétés) qui s'appliquent aux fichiers stockés dans des disques autres que le Microsoft OneDrive de l'utilisateur.
  1. Cliquez sur Ajouter des autorisations.
  2. Accordez le consentement administrateur. Pour savoir comment accorder l'autorisation, consultez Accorder le consentement administrateur au niveau locataire à une application dans la documentation Microsoft Entra.

Dépannage

Cette section explique comment résoudre les problèmes courants liés au connecteur Microsoft OneDrive.

Les utilisateurs voient le message "Approbation de l'administrateur requise" lorsqu'ils se connectent

Lorsque les utilisateurs se connectent à Microsoft OneDrive depuis l'application Web Gemini Enterprise pour la première fois, Microsoft peut afficher un écran Approbation de l'administrateur requise. Cela se produit si Gemini Enterprise demande des autorisations de niveau administrateur ou si votre locataire Microsoft Entra interdit aux utilisateurs d'autoriser des applications tierces sans le consentement préalable de l'administrateur à l'échelle du locataire.

Pour résoudre ce problème, un administrateur doit effectuer la première autorisation. Ensuite, les autres utilisateurs de votre locataire pourront se connecter sans l'écran d'approbation.

  1. Demandez à un administrateur Microsoft Entra ID qui peut accorder un consentement à l'échelle du locataire de se connecter à l'application Web Gemini Enterprise et de se connecter à Microsoft OneDrive.

  2. Sur l'écran des autorisations, demandez à l'administrateur de sélectionner Consentement pour le compte de votre organisation, puis de cliquer sur Accepter.

  3. Demandez aux utilisateurs de se reconnecter.

Pour en savoir plus, consultez Accorder le consentement administrateur au niveau locataire dans la documentation Microsoft Entra.