Authentification Microsoft OneDrive et SharePoint

Vue d'ensemble (Overview)

Dans Integration Service, lorsque vous créez une connexion à l'un de nos connecteurs basés sur Microsoft Graph, vous pouvez choisir parmi les options d'authentification suivantes :

• Code d'autorisation OAuth 2.0 : se connecte à l'application publique UiPath.
• Informations d'identification du client OAuth 2.0 : utilise un compte de service.
• Apportez votre propre application OAuth 2.0 : se connecte à une application privée que vous créez.

Remarque : pour plus de détails concernant les différents types d'authentification, reportez-vous au guide des activités Comment se connecter aux activités Microsoft 365 .

Consentement de l’administrateur

Remarque : cette section s'applique uniquement au code d'autorisation OAuth 2.0 et apportez vos propres options d'authentification d'application OAuth 2.0 .

De nombreuses organisations requièrent le consentement d’un administrateur avant de créer une connexion à une application externe. Le workflow de consentement de l'administrateur nécessite qu'un administrateur approuve l'enregistrement de l'application pour des utilisateurs ou des groupes spécifiques avant qu'une connexion ne soit établie. Pour plus de détails, consultez Présentation du workflow de consentement de l'administrateur et Consentement de l'utilisateur et de l'administrateur dans Microsoft Entra ID dans la documentation Microsoft.

Remarque : Integration Service emprunte l'identité de l'utilisateur qui crée la connexion. Les informations d'identification de l'utilisateur offrent l'accès à toutes les mêmes ressources que celles dont il dispose dans l'application donnée. Si vous partagez la connexion, toutes les modifications apportées à Microsoft SharePoint ou OneDrive avec cette connexion seront effectuées au nom de cet utilisateur.

Code d'autorisation OAuth 2.0

Étendues

Le connecteur demande les autorisations ou étendues suivantes : offline_access, Files.Read, Files.Read.All, Files.ReadWrite, Files.ReadWrite.All, Sites.Read.All, Sites.ReadWrite.All, Group.Read.All, Group.ReadWrite.All, profile, openid, email, User.Read.All ou User.Read.

Ajouter la connexion Microsoft OneDrive et SharePoint

Pour créer une connexion à votre instance Microsoft OneDrive et SharePoint, effectuez les étapes suivantes :

1. Sélectionnez Integration Service dans la barre de gauche.
2. Dans la liste Connecteurs , sélectionnez Microsoft OneDrive et SharePoint. Vous pouvez également utiliser la barre de recherche pour affiner le connecteur.
3. Sélectionnez le bouton Se connecter à Microsoft OneDrive et SharePoint (Connect to Microsoft OneDrive and SharePoint) .
4. Vous êtes maintenant redirigé vers la page de connexion.
5. Sélectionnez le type d'authentification Code d'autorisation OAuth 2.0 .
6. Ajoutez les autorisations requises dans le champ Étendue .
7. Sélectionnez un environnement dans la liste déroulante : Office 365 (par défaut), US Government L4 - Domaine du secteur public, US Government L5 - Domaine du secteur public, ou Chine.
   Remarque : pour plus de détails sur les environnements, consultez Points de terminaison racine du service Microsoft Graph et Graph Explorer.
8. Sélectionnez Se connecter et authentifier avec votre adresse e-mail et votre mot de passe Microsoft.

Actualiser les jetons pour les applications OAuth

Les jetons de réactualisation pour les applications OAuth peuvent être invalidés ou révoqués à tout moment par Microsoft. Cela peut se produire pour différentes raisons, telles que les délais d'attente et les révocations. Pour plus de détails, consultez la documentation officielle de Microsoft.

Avertissement : l'invalidation du jeton entraîne des connexions échouées et les automatisations ne peuvent pas s'exécuter sans que les connexions soient corrigées.

Veillez à suivre les bonnes pratiques de Microsoft lors de la création de vos applications OAuth. Pour plus d'informations sur la création d'une application Microsoft OAuth, consultez la documentation Microsoft.

Ce problème affecte non seulement le connecteur OneDrive et SharePoint, mais tous les connecteurs basés sur Microsoft Graph, tels qu'Outlook ou Teams.

Informations d'identification du client OAuth 2.0

Étendues

Étendues minimales pour créer une connexion : User.Read.All ou User.Read, Files.Read.

Ajouter la connexion Microsoft OneDrive et SharePoint

Pour créer une connexion à votre instance Microsoft OneDrive et SharePoint, effectuez les étapes suivantes :

1. Sélectionnez Integration Service dans la barre de gauche.
2. Dans la liste Connecteurs , sélectionnez Microsoft OneDrive et SharePoint. Vous pouvez également utiliser la barre de recherche pour affiner le connecteur.
3. Sélectionnez le bouton Se connecter à Microsoft OneDrive et SharePoint (Connect to Microsoft OneDrive and SharePoint) .
4. Vous êtes maintenant redirigé vers la page de connexion.
5. Sélectionnez le type d'authentification par informations d'identification client OAuth 2.0 .
6. Renseignez et configurez les champs suivants : ID de client (Client ID), Clé secrète du client (Client Secret), ID de locataire (Tenant ID), Environnement (Environment) et Compte (Account) (indiquez le compte utilisé pour emprunter l'identité d'un utilisateur).
7. Sélectionnez Se connecter (Connect).

Apportez votre propre application OAuth 2.0

Vue d'ensemble (Overview)

Pour savoir comment créer une application, consultez la documentation officielle de Microsoft : Enregistrer une application avec la plate-forme d'identité Microsoft (Register an application with the Microsoft identity platform).

Remarque : Il s'agit d'une fonctionnalité avancée qui requiert des privilèges d'administrateur dans l'application cible. Travaillez avec votre administrateur informatique pour configurer votre application avec succès.

Prérequis

Lorsque vous créez votre propre application à utiliser avec Integration Service, assurez-vous de répondre aux exigences suivantes :

1. Configurez l'application en tant qu'application multi-locataires ou à locataire unique .
2. Configurer une application Web .
3. Configurez un URI de redirection Web . L'URI de redirection (ou URL de rappel) pour votre application OAuth 2.0 est fourni dans l'écran d'authentification lors de la création d'une connexion : https://cloud.uipath.com/provisioning_/callback.
4. Vous devez configurer des autorisations déléguées. Pour plus d’informations, consultez la section Autorisations dans la documentation officielle de Microsoft.
5. Générez une clé secrète de client pour votre application.

Attention : L'avantage d'utiliser votre application privée OAuth réside dans le fait que vous pouvez personnaliser les autorisations en fonction de vos besoins réels. Pour savoir quelles étendues sont requises pour chaque activité dans le package Microsoft 365 , reportez-vous à la section Utiliser des étendues et consultez la documentation des activités .

Le connecteur utilise l'API Microsoft Graph. Reportez-vous à la page de référence des autorisations Microsoft Graph pour plus de détails sur toutes les autorisations.

Après avoir créé votre application, utilisez son ID de client (Client ID) et sa clé secrète de client (Client Secret) pour créer une connexion avec les connecteurs Microsoft.

Étendues

• Étendues minimales pour créer une connexion : openid, offline_access, User.Read.All ou User.Read, Files.Read.
• Liste minimale des étendues requises pour les déclencheurs OneDrive :
  • openid, offline_access, User.Read.All ou User.Read, Sites.Read.All – pour les événements sur les sites SharePoint.
  • Group.Read.All – pour les événements sur les groupes et les calendriers.
  • Files.Read.All : pour tous les types d'événements restants.

Ajouter la connexion Microsoft OneDrive et SharePoint

Pour créer une connexion à votre instance Microsoft OneDrive et SharePoint, effectuez les étapes suivantes :

1. Sélectionnez Integration Service dans la barre de gauche.
2. Dans la liste Connecteurs , sélectionnez Microsoft OneDrive et SharePoint. Vous pouvez également utiliser la barre de recherche pour affiner le connecteur.
3. Sélectionnez le bouton Se connecter à Microsoft OneDrive et SharePoint (Connect to Microsoft OneDrive and SharePoint) .
4. Vous êtes maintenant redirigé vers la page de connexion.
5. Sélectionnez le type d'authentification d'application Apporter votre propre OAuth 2.0 (Bring your Own OAuth 2.0) .
6. Renseignez et configurez les champs suivants : ID de client (Client ID), Clé secrète du client (Client Secret), Étendue (Scope), ID de locataire (Tenant ID) et Environnement (Environment).
   Remarque :

   • Pour Étendue (Scope), ajoutez les autorisations dont vous pourriez avoir besoin pour interagir avec différentes activités. Consultez la documentation des activités pour connaître les étendues requises.
   • Si vous utilisez une application multilocataire, conservez la valeur par défaut pour l' ID de locataire (common). Si vous utilisez une application à locataire unique, récupérez l' ID de locataire à partir d'Azure. Reportez-vous à Comment trouver votre ID de locataire Microsoft Train.
7. Sélectionnez Se connecter (Connect).

Actualiser les jetons pour les applications OAuth

Les jetons de réactualisation pour les applications OAuth peuvent être invalidés ou révoqués à tout moment par Microsoft. Cela peut se produire pour différentes raisons, telles que les délais d'attente et les révocations. Pour plus de détails, consultez la documentation officielle de Microsoft.

Avertissement : l'invalidation du jeton entraîne des connexions échouées et les automatisations ne peuvent pas s'exécuter sans que les connexions soient corrigées.

Veillez à suivre les bonnes pratiques de Microsoft lors de la création de vos applications OAuth. Pour plus d'informations sur la création d'une application Microsoft OAuth, consultez la documentation Microsoft.

Ce problème affecte non seulement le connecteur OneDrive et SharePoint, mais tous les connecteurs basés sur Microsoft Graph, tels qu'Outlook ou Teams.