Authentification

Cette page répertorie les problèmes d'authentification que vous pouvez rencontrer lors de l'utilisation du package d'activités Microsoft 365.

Quel type d’authentification dois-je utiliser dans l’activité Étendue Microsoft 365 (Microsoft 365 Scope)

Vue d'ensemble (Overview)

Tout d’abord, assurez-vous de consulter les ressources suivantes :

1. Lisez la documentation relative à l’activité Étendue Microsoft 365 ( Microsoft 365 Scope ), qui comprend des informations sur les types d’authentification disponibles.
2. Pour savoir comment enregistrer votre application personnalisée dans Azure AD et définir les autorisations de l'API Graph, consultez la page Configuration (Setup).
3. La liste des appels API Graph provenant des activités Microsoft 365 est disponible sur la page Références techniques (Technical References).
4. Pour en savoir plus sur l'utilisation de UiPathStudioO365App pour InteractiveToken (c'est-à-dire OAuthApplication=UiPath), voir :
   • UiPathStudioO365App sur Microsoft Azure Marketplace
   • Configuration d'Azure AD pour l'automatisation d'Outlook 365.
5. Consultez les autorisations d'API requises pour les cartes Utiliser une application (Use application) sur la page Cartes Microsoft 365 et Google Workspace - Autorisations et étendues des API (Microsoft 365 and Google Workspace Cards - API permissions and scopes).

Étendue à des boîtes aux lettres spécifiques

Lorsque vous utilisez ce type d'authentification, l'application a accès à toutes les boîtes aux lettres de votre locataire. En effet, l'autorisation de l'API d'application Mail.Read représente « Lire les e-mails dans toutes les boîtes aux lettres » et Mail.ReadWrite « Lire et écrire les e-mails dans toutes les boîtes aux lettres ».

Il est possible d'étendre les autorisations de l'application à des boîtes aux lettres spécifiques, de sorte que l'application n'ait accès qu'aux boîtes aux lettres spécifiées : Étendue des autorisations d'application par rapport à des boîtes aux lettres spécifiques Exchange Online.

Étendue à des sites spécifiques

Utilisez l'autorisation d'application Sites.Selected pour permettre à l'application d'accéder uniquement à des collections de sites SharePoint spécifiques plutôt qu'à toutes.

L'authentification avec le nom d'utilisateur et le mot de passe échoue

Paramètres manquants : client_assertion ou client_secret

Problème : l'authentification avec nom d'utilisateur et mot de passe échoue. Le message d'erreur qui s'affiche est le suivant :

Important : « Un problème de configuration empêche l'authentification. Consultez le message d'erreur du serveur pour plus de détails. Vous pouvez modifier la configuration dans le portail d'enregistrement de l'application. Voir https://aka.ms/msal-net-invalid-client pour plus de détails. Exception d'origine : AADSTS7000218 : le corps de la requête doit contenir le paramètre suivant : 'client_assertion' ou 'client_secret'."

Solution : vérifiez que le champ de configuration Autoriser les flux clients publics est activé dans votre application enregistrée.

L'application n'est pas configurée en tant qu'application mutualisée

Problème : vous recevez le message d'erreur suivant :

Important : « L'application [...] n'est pas configurée en tant qu'application mutualisée. L'utilisation du point de terminaison /common n'est pas prise en charge pour les applications créées après le 15/10/2018. Utilisez un point de terminaison spécifique au locataire ou configurez l'application pour qu'elle soit multi-locataire. »

Solutions :

• Définissez une valeur pour le paramètre Locataire (Tenant).
• Configurez l'application pour qu'elle soit mutualisée.

L'authentification fonctionne, mais l'utilisateur ne peut pas lire les e-mails d'une boîte aux lettres partagée

Problème: lors de l'utilisation d'un compte partagé sur les activités Microsoft 365, sur le compte personnel de l'utilisateur, il est possible de récupérer le courrier, mais lorsque vous essayez de lire les e-mails d'un compte partagé, une erreur Accès refusé (Accès refusé) apparaît.

Solution: vérifiez si l'application dispose de l'autorisation API Mail.Read.Shared (déléguée) définie. Cette autorisation permet à l'application de lire le courrier auquel un utilisateur peut accéder, y compris son propre courrier et celui qu'il partage.

Erreur : l'utilisateur ou l'administrateur n'a pas autorisé l'utilisation de l'application

Problème : vous recevez le message d'erreur suivant :

Important : « L'utilisateur ou l'administrateur n'a pas autorisé l'utilisation de l'application avec l'ID [...] nommé [...]. »

Solution : veillez à suivre les étapes du lien qui suit pour accorder le consentement de l'administrateur.

IntegratedWindowsAuthentication (IWA) ne fonctionne pas dans les versions 1.4.0 et v1.5.0

Problème : IntegratedWindowsAuthentication (IWA) fonctionnait avec UiPath.MicrosoftOffice.365.Activitiesv1.3.1, mais ne fonctionne pas avec UiPath.MicrosoftOffice.365.Activities v1.4.0 et v1.5.0.

Solution : utilisez UiPath.MicrosoftOffice.365.Activities dans une version égale ou supérieure à la version 1.6.0.

Authentification ApplicationIdAndSecret dans v1.4.0 et v1.5.0

Problème : lors de l'utilisation de UiPath.MicrosoftOffice.365.Activities v1.4.0 ou v1.5.0, l'activité Étendue (Scope) échoue même lorsque les paramètres obligatoires, c'est-à-dire ID d'application et Clé secrète, sont correctement définis.

Si le paramètre Locataire n'est pas défini, vous pouvez obtenir l'une des erreurs suivantes :

Important :

• « Le jeton ne contient aucune autorisation ou les autorisations ne peuvent pas être comprises. » (Multi-locataire)
• « L'application avec l'identifiant [...] est introuvable dans le répertoire 'microsoft.com'. Cela peut se produire si l'application n'a pas été installée par l'administrateur du locataire ou autorisée par un utilisateur du locataire. Vous avez peut-être envoyé votre demande d’authentification au mauvais locataire. » (locataire unique)

Solution : définissez une valeur pour le paramètre Locataire.

Une autre option consiste à mettre à niveau vers UiPath.MicrosoftOffice.365.Activities version >= 1.6.0. À partir de la version 1.6.0, Locataire (Tenant) est un paramètre obligatoire.

Requêtes graphiques d’API dans Microsoft 365 Scope

Vous pouvez effectuer des requêtes d’API Graph dans l’activité Étendue Microsoft 365. Cela est possible lors de l'utilisation d'un objet ParentScope dans une activité Invoke Code .

Remarque : cela est possible pour les projets Windows hérités .NET 4.6.1. Il échoue pour les projets Windows .NET5 (message d'erreur « Impossible de charger le fichier ou l'assembly 'Microsoft.Graph, Version=3.32.0.0' »).

Voir ci-dessous un exemple avec Studio v2021.10 (Windows-Legacy) et UiPath.MicrosoftOffice.365.Activities v1.11.1 :

Téléchargez l'exemple