Ajouter un compte OneDrive / SharePoint
Connectez un emplacement Microsoft OneDrive for Business ou SharePoint à PlaidCloud Document. Vous inscrivez une application Entra (Azure AD), vous choisissez quelle partie de votre locataire elle peut atteindre, et PlaidCloud l’utilise pour lire et écrire des fichiers.
Choisir un modèle d’accès
Section intitulée « Choisir un modèle d’accès »Déterminez quelle partie de votre locataire Microsoft 365 l’application peut atteindre. C’est le choix le plus important de toute la configuration.
| Modèle | Autorisation d’application Graph | Ce que l’application peut atteindre | À choisir lorsque |
|---|---|---|---|
| Sites sélectionnés (recommandé) | Sites.Selected |
Uniquement les sites précis auxquels vous accordez explicitement l’accès | Un site contient des données sensibles : paie, RH, finance, données de santé |
| Tous les sites | Sites.Read.All (lecture) ou Sites.ReadWrite.All (lecture + écriture) |
Tous les sites du locataire | Aucun site n’est sensible et vous souhaitez la configuration la plus simple |
La plupart des organisations devraient choisir Sites sélectionnés. Si un seul site contient des informations sensibles, un accès à l’ensemble du locataire les expose. Avec Sites.Selected, l’application ne peut rien atteindre tant qu’un administrateur ne lui a pas accordé l’accès à chaque site nommé : les sites auxquels vous n’accordez jamais l’accès restent totalement hors de portée.
Enregistrer l’application dans Azure
Section intitulée « Enregistrer l’application dans Azure »- Connectez-vous au portail Azure et accédez à Microsoft Entra ID → App registrations → + New registration.
- Saisissez un nom (par exemple
PlaidCloud). - Sous Supported account types, choisissez Accounts in this organizational directory only (locataire unique, le cas le plus courant).
- Laissez le champ Redirect URI vide et cliquez sur Register.
- Sur la page de vue d’ensemble, copiez l’Application (client) ID (votre ID client) et le Directory (tenant) ID (votre ID du locataire).
- Accédez à Certificates & secrets → + New client secret, définissez une description et une date d’expiration, cliquez sur Ajouter, puis copiez immédiatement la Valeur du secret : elle ne sera plus affichée.
Accorder l’autorisation d’API
Section intitulée « Accorder l’autorisation d’API »Ajoutez exactement une autorisation Application Microsoft Graph, correspondant au modèle d’accès choisi :
- Sites sélectionnés :
Sites.Selected - Tous les sites :
Sites.Read.All(lecture seule) ouSites.ReadWrite.All(lecture + écriture)
Étapes : API permissions → + Add a permission → Microsoft Graph → Application permissions → ajoutez l’autorisation ci-dessus → Grant admin consent.
Si vous avez choisi Tous les sites, votre configuration est terminée : passez directement à Ajouter le compte dans PlaidCloud. Si vous avez choisi Sites sélectionnés, accordez ensuite à l’application l’accès à chaque site.
Autoriser l’application sur chaque site (modèle Sites sélectionnés)
Section intitulée « Autoriser l’application sur chaque site (modèle Sites sélectionnés) »Sites.Selected n’accorde par lui-même aucun accès à l’application : un administrateur SharePoint ou général doit lui accorder l’accès à chaque site que vous voulez qu’elle atteigne. Aucun écran du centre d’administration ne le permet ; vous utilisez donc deux appels Microsoft Graph dans Graph Explorer. Comme vous accordez l’accès site par site, les sites sensibles ne sont tout simplement jamais accordés.
Configuration unique. Dans Graph Explorer, connecté en tant qu’administrateur SharePoint ou général, ouvrez l’onglet Modify permissions et cliquez sur Consent pour Sites.FullControl.All (c’est cette portée qui vous permet de définir les accès aux sites). Si une requête ultérieure renvoie accessDenied, c’est ce consentement qui manque : déconnectez-vous puis reconnectez-vous après avoir donné votre consentement afin d’actualiser le jeton.
Étape 1 : trouver l’ID du site
Section intitulée « Étape 1 : trouver l’ID du site »Listez les sites de votre locataire (méthode GET) :
GET https://graph.microsoft.com/v1.0/sites?search=*&$select=displayName,webUrl,idOu résolvez directement un site à partir de son URL :
GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/TeamNameCopiez l’id du site dans la réponse ; il a la forme contoso.sharepoint.com,<guid>,<guid>.
Étape 2 : autoriser l’application
Section intitulée « Étape 2 : autoriser l’application »Définissez la méthode sur POST pour la collection permissions de ce site (collez l’id obtenu à l’étape 1) :
POST https://graph.microsoft.com/v1.0/sites/{site-id}/permissionsDans l’onglet Request body, collez le contenu suivant ; définissez roles sur ["read"] ou ["write"] et utilisez l’Application (client) ID de votre application :
{ "roles": ["read"], "grantedToIdentities": [ { "application": { "id": "your-client-id", "displayName": "PlaidCloud" } } ]}Exécutez la requête. En cas de succès, elle renvoie un objet d’autorisation avec un id et vos roles. Répétez l’étape 2 pour chaque site que PlaidCloud doit atteindre. Pour vérifier les accès accordés par un site :
GET https://graph.microsoft.com/v1.0/sites/{site-id}/permissionsAjouter le compte dans PlaidCloud
Section intitulée « Ajouter le compte dans PlaidCloud »- Connectez-vous à PlaidCloud et sélectionnez l’espace de travail dans lequel le compte sera créé.
- Accédez à
Document→Manage→ Nouveau compte. - Choisissez OneDrive comme Service.
- Saisissez un nom et une description, puis choisissez un Modèle de sécurité (laissez
Privateen cas de doute). - Sous Identifiants d’authentification, collez l’ID client, le Secret client et l’ID de locataire OneDrive issus de l’inscription de l’application.
- Dans URL du site SharePoint, collez l’URL d’un site auquel l’application a obtenu l’accès (par exemple
https://contoso.sharepoint.com/sites/TeamName). La liste Lecteur/Site affiche alors les bibliothèques de documents de ce site : choisissez celle qui servira de racine au compte. Le Chemin de départ est alors renseigné. - Sélectionnez Enregistrer.
Créer le compte avec un assistant IA
Section intitulée « Créer le compte avec un assistant IA »Un assistant IA connecté via le connecteur MCP PlaidCloud peut créer ou mettre à jour le compte pour vous avec l’outil document_account_upsert, une fois que vous avez terminé les étapes Azure ci-dessus. Fournissez-lui les valeurs issues de l’inscription de l’application :
| Champ du compte | Valeur |
|---|---|
service_type |
onedrive |
public_key |
ID d’application (client) |
private_key |
Secret client |
tenant_id |
ID d’annuaire (locataire) |
start_path |
ID du lecteur, éventuellement suivi de /folder |
Les identifiants sont en écriture seule : document_account_describe les masque. L’outil est disponible dans votre propre session MCP connectée, et non pour les étapes de workflow ni pour les agents intégrés à l’application.