Microsoft Office 365 Scope

UiPath.MicrosoftOffice365.Activities.Office365ApplicationScope

Description

Utilise la Plateforme d’identités Microsoft pour établir une connexion authentifiée entre UiPath et votre application Microsoft 365. Cette connexion authentifiée permet à un Robot d'appeler l'API Microsoft Graph pour lire et écrire des ressources en votre nom.

Important :

À partir de la version 2.5.5, vous pouvez utiliser les nouvelles activités Microsoft 365 dans l’activité Étendue. Pour savoir comment utiliser les activités Integration Service avec Microsoft 365 Scope, consultez Comment utiliser les activités Microsoft 365 sans connexions Integration Service.

Compatibilité du projet

Windows - Héritage | Windows

Configuration

Astuce :

Cette page explique les paramètres d’authentification disponibles dans l’activité Microsoft 365 Scope. Pour plus de détails concernant chaque option d’authentification, consultez le guide Comment se connecter aux activités Microsoft 365 .

Pour commencer à configurer cette activité, vous devez d’abord sélectionner une méthode de connexion. Selon la méthode sélectionnée, différents champs s’affichent alors dans le panneau Propriétés (Properties).

• Méthode de connexion : sélectionnez la méthode de connexion que vous souhaitez utiliser. Les options disponibles dans le menu déroulant sont :
  • Panneau Propriétés : configurez les détails de connexion dans le panneau Propriétés.
  • Ressource : utilisez du texte Orchestrator ou des ressources d’informations d’identification, ou les deux. Nous vous recommandons d'utiliser cette option.

Méthode de connexion de ressource

Remarque :

Lorsque vous sélectionnez cette option, la plupart des champs d'authentification généralement affichés dans le panneau Propriétés sont masqués, car les informations d'authentification sont stockées à l'intérieur de la ressource.

• Ressources de connexion : parcourez les dossiers Orchestrator pour sélectionner une ressource. Ce champ prend en charge les variables IResource . Sélectionnez le bouton Gérer les ressources pour ouvrir Orchestrator. La liste des ressources disponibles dépend de l’Orchestrator auquel Studio et Robot sont connectés. Vous pouvez utiliser la ressource au moment de la conception. En outre, la ressource peut être de type texte uniquement.

  • Utilisez le bouton Plus pour sélectionner Recharger les ressources si vous avez mis à jour vos ressources dans Orchestrator. Notez que si vous ajoutez une nouvelle ressource dans Orchestrator tout en utilisant Studio Desktop, elle ne sera pas disponible immédiatement dans l’activité Étendue.

• Vérifiez le format de la ressource dans Comment utiliser les activités Microsoft 365 sans connexions Integration Service.

Selon le type d’authentification configuré dans la ressource, vous devez également configurer les champs suivants disponibles dans le panneau Propriétés (Properties) :

Authentification

• Adresse e-mail de l’utilisateur dont l’identité est utilisée (Impersonated User Email Address) : adresse e-mail de l’utilisateur dont l’identité est utilisée. Utilisé pour les méthodes d’authentification ID d’application et Clé secrète (Application ID and Secret) et ID d’application et Certificat (Application ID and Certificate).

Nom d’utilisateur et mot de passe (Unattended)

• Nom d’utilisateur (Username) : nom d’utilisateur de votre compte Microsoft 365. Utilisé pour l’authentification Nom d’utilisateur et Mot de passe (Username and Password).
• Mot de passe (Password) : mot de passe de votre compte Microsoft 365.

Commun

• DélaiAttenteMillisecondes : indique le délai d’attente pour que l’authentification interactive (boîte de dialogue de consentement) se termine avant qu’une erreur ne soit générée. Ce champ ne prend en charge que les entiers et les variables Int32 . La valeur par défaut est 30 000 ms (30 secondes).

Runtime

• Ressources de connexion du runtime : parcourez pour sélectionner une ressource. Ce champ permet de sélectionner une autre ressource pour l'exécution. Utilisez le bouton Plus pour sélectionner Chemin relatif et entrez le chemin complet de la ressource Orchestrator contenant les détails de connexion. Nous vous recommandons d’utiliser une ressource d’informations d’identification dans ce champ, mais vous pouvez également utiliser une ressource de texte. La valeur JSON doit être définie dans le champ du mot de passe pour les ressources dʹidentifiants. Cette valeur est facultative et, si elle est laissée vide, les valeurs du moment de la conception seront utilisées au moment de l’exécution.

Méthode de connexion du panneau Propriétés

Remarque :

Lorsque vous sélectionnez cette option, vous devez configurer les champs d’authentification disponibles dans le panneau Propriétés .

Tout d’abord, configurez les champs suivants :

• Connexions – sélectionnez un compte dans la liste. Vous pouvez ajouter, supprimer et choisir les connexions à utiliser.
• ÉtenduesAuthentification
  • Consultez la section de l’assistant Utilisation des étendues d’authentification ci-dessous.

Utilisation de l'assistant Étendues d'authentification (Authentication Scopes)

Remarque :

Cet assistant remplace le paramètre Services disponible dans les versions précédentes de ce package. L’assistant Étendues de l’authentification est disponible lorsque vous utilisez l’authentification par jeton interactif .

L'activité Étendue (Scope) intègre un sélecteur universel d'autorisations, offrant une image claire de toutes les étendues d'authentification utilisées, dont les activités ont besoin pour fonctionner correctement.

Toutes les activités enfant incluses dans l’activité Microsoft 365 Scope sont automatiquement détectées en tant que portées requises.

Si aucune étendue n'est sélectionnée manuellement dans l'assistant Étendues, la fonction de détection automatique sera appliquée par défaut au moment de l'exécution et il ne sera pas nécessaire de configurer l'assistant. Toutes les étendues minimales requises seront sélectionnées lors de l'exécution.

Vous pouvez également ajouter manuellement une étendue après avoir ajouté une activité enfant à l’activité Microsoft 365 Scope.

Ensuite, vous devez sélectionner le Type d’authentification (Authentication Type) dans le panneau Propriétés (Properties) et configurer les champs requis pour votre méthode d’authentification favorite. Les sections ci-dessous répertorient les champs disponibles dans chaque menu.

Authentification

• Type d’authentification (Authentication Type) : type d’authentification requis pour votre application enregistrée. Sélectionnez l’une des cinq options : Jeton interactif (Interactive token), Authentification Windows intégrée (IWA) (Integrated Windows Authentication (IWA)), Nom d’utilisateur et mot de passe (Username and Password), ID d’application et Clé secrète (Application ID and Secret) ou ID d’application et Certificat (Application ID and Certificate). La valeur par défaut est Jeton interactif (Interactive token).

• Environnement (Environment) : environnement. Soit Azure Global, soit des Clouds nationaux qui sont des environnements uniques et distincts d’Azure Global. Sélectionnez l’une des cinq options : par défaut, Global, China, Germany or USGovernment. La valeur par défaut est Global.

• ID d'application (Application ID) : l'ID d'application (client) unique attribué par Azure Active Directory lorsque vous avez enregistré votre application lors de la configuration. L'ID d'application (client) représente une instance d'une application Microsoft 365.

• Locataire (Tenant) : l'ID d'annuaire (locataire) unique attribué par Azure Active Directory lorsque vous avez enregistré votre application lors de la configuration. Requis pour les applications mutualisées et l'authentification Windows intégrée. L'ID d'annuaire (locataire) se trouve dans la page de vue d'ensemble de votre application enregistrée (sous l' ID d'application (client)).

• Emplacement du magasin de données de connexion : une liste déroulante qui spécifie l'emplacement de stockage de la réponse du jeton. Les valeurs de propriété disponibles sont Disque local, Orchestrator ou Ne jamais stocker.

  • Disque local : les jetons de connexion sont stockés dans un dossier local sur la machine. La même connexion peut être utilisée dans plusieurs processus sur une même machine.
  • Orchestrator : les jetons de connexion sont stockés dans Orchestrator sous forme de ressources dans un dossier spécifié. La même connexion peut être utilisée dans plusieurs processus sur plusieurs machines tant qu'elle a accès au dossier Orchestrator spécifié.
  • Ne jamais stocker : les jetons de connexion ne sont jamais stockés.
  Remarque :

  La solution de stockage O365 est différente de celle de GSuite en raison de limitations techniques. O365 stocke tous les comptes dans un seul fichier dans Orchestrator, tandis que GSuite stocke un fichier par compte.

• Chemin du dossier Orchestrator - Le dossier Orchestrator dans lequel les opérations sont effectuées. Laissez ce champ vide si les dossiers modernes ne sont pas activés. Pour plus de détails, consultez À propos des dossiers dans le guide Orchestrator.

• Adresse e-mail de l’utilisateur dont l’identité est utilisée : adresse e-mail de l’utilisateur dont l’identité est utilisée. Utilisé dans les scénarios Unattended pour les méthodes d’authentification ID d’application et Clé secrète et ID d’application et Certificat .

Jeton interactif

Remarque :

Il s'agit de la même méthode d'authentification prise en charge par Integration Service via l' application publique UiPath ou la méthode Fournissez votre propre application .

Pour plus de détails, consultez Jeton interactif.

• ApplicationOAuth - indique l'application (client) à utiliser. Ce champ ne prend en charge que les variables OAuthApplication. Sélectionnez l'une des options suivantes :
  • UiPath : par défaut. Lorsque vous souhaitez utiliser l’application créée par UiPath (Inscription de l’application publique UiPath) (UiPath Public App registration)). Si cette option est sélectionnée, les champs IDApplication (ApplicationID) et Locataire (Tenant) fournis dans la section Authentification (Authentication) seront ignorés.
  • Personnalisé : lorsque vous souhaitez créer votre propre application avec des autorisations spécifiques. Dans ce cas, vous devez définir une valeur pour le champ ID d’application . Cochez l’ option Enregistrement d’application OAuth personnalisée - Apportez votre propre application (BYOA).
• Utiliser le courtier : définissez cette option sur Vrai pour utiliser le courtage Windows Authentication Manager (WAM) pour l'authentification interactive. Cette option offre une expérience d’authentification plus intégrée sous Windows.
• UtilisateurOAuth2 : l'e-mail de l'utilisateur qui se connectera via le jeton interactif.

ID d’application et Certificat (Unattended)

Pour plus de détails, consultez ID d’application et Certificat.

• Certificat en base 64 (Certificate As Base64) : représentation en base 64 du certificat.
• Mot de passe du certificat : un mot de passe facultatif qui peut être nécessaire pour utiliser le certificat, sous la forme d'un Secure String.

Application ID and Secret (Unattended)

Pour en savoir plus, consultez ID d’application et Clé secrète.

• Application Secret - The secret string that the application uses to provide its identity.
• Secure Application Secret - The Application (client) secret, as a SecureString.

Nom d’utilisateur et mot de passe (Unattended)

Pour plus de détails, consultez Nom d’utilisateur et mot de passe.

Important :

Microsoft a rendu obsolète l’authentification de base pour Exchange en ligne. Cela a un impact sur certaines de nos activités, telles que les fonctionnalités Microsoft Office365. Nous vous recommandons d'utiliser le protocole OAuth dans les activités qui le prennent en charge.

• Mot de passe (Password) : mot de passe de votre compte Microsoft 365.
• MotDePasseSécurisé : le mot de passe de votre compte Microsoft 365, sous la forme d'un fichier SecureString.
• Nom d’utilisateur (Username) : nom d’utilisateur de votre compte Microsoft 365.

Commun

• DélaiAttenteMillisecondes (TimeoutMS) : indique le délai d’attente (en millisecondes) pour que l’authentification interactive (boîte de dialogue de consentement) se termine avant qu’une erreur ne soit générée. Ce champ ne prend en charge que les entiers et les variables Int32. La valeur par défaut est de 30 000 ms (30 secondes) (non indiquée).
• ContinueOnError - If set, continue executing the remaining activities even if the current activity has failed.

Résolution des problèmes

Si vous rencontrez des problèmes avec l’authentification, consultez Résolution des problèmes - Authentification.