Connecteur pour Microsoft OneDrive

Avec le connecteur Microsoft® OneDrive®, vous pouvez utiliser les commandes dans une chaîne pour gérer les fichiers et les dossiers dans Microsoft OneDrive ou SharePoint®. Par exemple, avec ce connecteur, vous pouvez :

Copier, supprimer et rechercher des fichiers et des dossiers
Téléchargement et chargement de fichiers
Liste des lecteurs disponibles

Note: Ce connecteur est construit par Workiva et se connecte à un système tiers. Bien que notre équipe d'assistance puisse vous aider à configurer ce connecteur dans votre espace de travail, nous ne sommes pas en mesure de dépanner ou d'aider à résoudre des problèmes qui proviennent de l'extérieur de la plateforme Workiva.

Conditions préalables

Pour activer la connexion, le connecteur utilise l'API Microsoft Graph. Pour sécuriser la connexion, le connecteur utilise l'authentification OAuth via une application désignée et enregistrée sur le portail d'enregistrement des applications Microsoft ou Azure® Active Directory®.

Pour configurer le connecteur, vous aurez besoin de :

Une application enregistrée avec le portail d'enregistrement des applications Microsoft ou Azure Active Directory. Enregistrez votre numéro d'identification de la demande
L'identifiant et le secret du client OAuth de l'application Azure
Les champs d'application de l'application Azure, qui correspondent aux commandes que le connecteur exécutera.
Le type et l'ID du lecteur à connecter.

Remarque : vous pouvez utiliser l'outil Graph Explorer de Microsoft ( ) pour récupérer ces données depuis SharePoint.
L'URI de redirection du projet :

Exemple de configuration de Microsoft Azure pour OneDrive

Enregistrement d'une demande

Connectez-vous à votre portail Microsoft Azure : https://azure.microsoft.com/en-us/account/
Accédez à vos services Azure Active Directory sur .
Accédez à la rubrique « Inscriptions aux applications » ( ) à l'adresse , sous « Gérer » (Manage), puis cliquez sur « Inscription à la plateforme de gestion des applications » ( ) et sélectionnez « Nouvelle inscription » (New Registration) à l'adresse .
Indiquez le nom souhaité pour l'application « » : « », puis cliquez sur « » pour vous inscrire sur .

Configurer l'authentification de l'application

Connectez-vous à votre portail Microsoft Azure : https://azure.microsoft.com/en-us/account/
Accédez à vos services Azure Active Directory sur .
Accédez à la rubrique « Inscriptions aux applications » de l' , à l'adresse , sous « Gérer ».
Accédez à « Authentification » ( ) dans le panneau « Gérer » mis à jour.
Dans la section « Types de comptes pris en charge », sélectionnez « Comptes » dans n'importe quel annuaire d'entreprise (n'importe quel locataire Microsoft Entra ID – multitenant) .
Dans la section « Ajouter une plateforme », sélectionnez « Web ».
Dans le champ « Redirect URI » ( ) , saisissez l'URL de rappel valide indiquée ci-dessus.
Veillez à cocher la case « MultiTenant » dans la section « Types de comptes pris en charge » .

Note : Comme le connecteur OneDrive nécessite l'activation de l'option MultiTenant, il incombe aux administrateurs Azure de s'assurer que les applications sont correctement configurées pour être conformes aux normes de sécurité. Cette option, lorsqu'elle est correctement utilisée avec la sécurité Azure, n'ouvre pas l'application à tout le monde. Vous trouverez ci-dessous des suggestions de mesures supplémentaires à prendre.

Consultez la documentation de Microsoft sur l' , disponible à l'adresse , concernant la configuration multi-locataires.
Activez les paramètres de sécurité au niveau de l'application, en suivant les instructions de Microsoft disponibles à l'adresse pour limiter l'accès à votre application à un groupe d'utilisateurs .
Attribuez/autorisez l'accès des utilisateurs à l'application en suivant les instructions de Microsoft disponibles à l'adresse , notamment celles concernant l'attribution de l'application aux utilisateurs et aux groupes .

Configuration des certificats et des secrets

Connectez-vous à votre portail Microsoft Azure : https://azure.microsoft.com/en-us/account/
Accédez à vos services Azure Active Directory sur .
Accédez à la rubrique « Inscriptions aux applications » ( ) à l'adresse , sous « Gestion des applications » ( ) à l'adresse .
Accédez à la rubrique « Certificats » ( ) dans le panneau « Gérer » ( ) mis à jour .
Cliquez sur « New Client Secret » ( er une nouvelle clé secrète de client) dans le panneau central.
Après avoir fourni une brève description de l' et ainsi que la date d'expiration , un « Client Secret » s'affichera. Ce document doit être conservé à des fins de sécurité et pour être importé dans le connecteur Microsoft OneDrive.

Configuration des autorisations de l'API

Connectez-vous à votre portail Microsoft Azure : https://azure.microsoft.com/en-us/account/
Accédez à vos services Azure Active Directory sur .
Accédez à la rubrique « Inscriptions aux applications » ( ) à l'adresse , sous « Gestion des applications » ( ) à l'adresse .
Accédez à la section « Autorisations API » de ( ) dans le panneau de gestion « » ( ) mis à jour.
Cliquez sur « » (Gérer les autorisations), puis ajoutez une autorisation « » dans le panneau central.
Sélectionnez « » (Microsoft Graph) dans la rubrique « » (API Microsoft) .
Sélectionnez « Autorisations de délégué d' » ( ) comme type de demande d' ( Request Type) .
Parmi la liste des autorisations dont vous aurez besoin :
User.Read , tout ce qui se trouve sous FILES et OpenId.offline_access .
Cliquez sur « » (Autorisation de gestion des subventions) .
Définir le niveau d'accès requis par le connecteur. Les espaces de noms
suivants sont pris en charge par le connecteur Microsoft OneDrive :
- Fichiers.LectureÉcriture.Sélectionné
- Fichiers.LectureÉcriture.DossierDeL'Application
- Files.ReadWrite.All
- Fichiers.LectureÉcriture
- Files.Read.Selected
- Files.Read.All
- Files.Read
- accès hors ligne

Au minimum, une portée « offline_access » est requise.

Pourquoi les méthodes Files.Read.All et Files.ReadWrite.All sont-elles nécessaires ?

Le connecteur Workiva OneDrive communique avec votre environnement Microsoft via l'API Microsoft Graph à l'aide des autorisations déléguées OAuth ; cela signifie que le connecteur s'authentifie et agit au nom d'un utilisateur authentifié.

Pourquoi Sites.Selected ne peut pas être utilisé

Sites.Selected est une autorisation spécifique à SharePoint conçue pour les flux d'accès au niveau de l'application (application uniquement) ; elle n'est pas compatible avec le modèle d'autorisation déléguée utilisé par le connecteur Workiva. Il limite également l'accès aux seuls sites SharePoint pré-approuvés, ce qui empêche le connecteur d'effectuer des opérations dynamiques basées sur le chemin d'accès, telles que la recherche, la copie d'éléments et la suppression d'éléments.

Permettre la sécurité

Connectez-vous à votre portail Microsoft Azure : https://azure.microsoft.com/en-us/account/
Accédez à vos services Azure Active Directory sur .
Cliquez sur , puis sur « Applications d'entreprise » , sous , puis sur « Gérer » .
Sélectionnez votre demande dans la liste pour lancer le processus de modification. Si votre application n'apparaît pas par défaut dans la liste, cliquez sur « » (Toutes les applications) , puis sur « Manage » (Gérer) sous « » (Gérer).
Cliquez sur « Propriétés d' » ( Properties) , puis sous « Gestion des » ( Manage) .
Dans l'écran « Propriétés d' » ( Properties) , configurez les propriétés suivantes pour permettre l'utilisation de l'accès à l'API créé ci-dessus :

La connexion des utilisateurs est-elle activée ? = Oui

Une attribution d'utilisateur est-elle requise ? = Oui

(Facultatif) Visible par les utilisateurs ? = Non
Cliquez sur « » (Utilisateurs et groupes) , puis sous « » (Gérer) .
Vous pouvez désormais utiliser les procédures standard d'Azure AD pour ajouter vos utilisateurs selon vos besoins. Voici
la liste des utilisateurs autorisés à utiliser OneDrive et disposant d'une licence Microsoft OneDrive valide.

Configurer le connecteur Microsoft OneDrive

Note : pour que le connecteur puisse être utilisé dans les chaînes de votre organisation, un admin de sécurité de l’org. doit d’abord l’activer à partir de Configuration.

Depuis , dans « Chain Builder » , cliquez sur « » « Connections » compare_arrows , puis sur « » « Create » en haut à droite.
Sous « » (Connecteurs) > « Connection » (Connexion) , sélectionnez « » (Microsoft OneDrive) et « CloudRunner » (par défaut).
Sous Informations de base, entrez un nom et une description uniques pour aider à identifier le connecteur.
Sous OAuth, entrez l'ID et le secret du client OAuth pour l'application Azure du connecteur.
Pour déterminer le niveau d'accès du connecteur, entrez dans la portée d'authentification de l'application Azure .
Au minimum, le champ « offline_access » est obligatoire.
Pour autoriser la connexion et les informations d'identification OAuth, cliquez sur Connect.

Sous Propriétés, entrez les détails de la connexion :

Propriété	Détails
Type d'entraînement	Sélectionnez le type de lecteur auquel vous souhaitez vous connecter (lecteur, groupe, utilisateur ou site). Pour accéder à votre propre lecteur utilisateur, sélectionnez « » > « Utilisateur actuel (Moi) » > « ».
ID du type de lecteur	Saisissez l'ID du lecteur auquel vous souhaitez vous connecter, en fonction de Type de lecteur. Par exemple, si le type de lecteur ( ) est « Utilisateur », saisissez l'identifiant de l'utilisateur ; s'il s'agit de « Site », saisissez l'identifiant du site.

Remarque : Vous pouvez utiliser l'outil Graph Explorer de Microsoft ( ) pour récupérer ces données depuis SharePoint.

Sélectionnez les environnements à utiliser avec la connexion et cliquez sur enregistrer.
Pour tester la connexion, créez et exécutez une chaîne avec la commande Download File du connecteur et vérifiez qu'elle renvoie une sortie valide.

Dépannage

Si la connexion à Microsoft OneDrive ou SharePoint échoue :

Vérifiez que les informations d'identification OAuth de l'application Azure du connecteur sont présentes, correctes et valides. Les identifiants OAuth ont une date d'expiration définie, et il se peut que le certificat ait expiré. Si c'est le cas, vous devrez créer un nouveau certificat et entrer le nouveau secret client dans le connecteur. Pour plus d'informations sur la création d'un nouveau secret, consultez la page «
Configuration des certificats et des secrets » à l'adresse .
Vérifier le type de lecteur et l'identifiant saisi pour le connecteur. Vous pouvez utiliser l'outil « Graph Explorer » de Microsoft ( ) pour récupérer ces données depuis SharePoint.
Vérifier l'URI de redirection du projet :

Portail de support Workiva