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.

Attention : À partir de la version 2.5.5, vous pouvez utiliser les nouvelles activités Microsoft 365 dans l’activité Étendue (Scope). 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 (Connection method) : sélectionnez la méthode de connexion que vous souhaitez utiliser. Les options disponibles dans le menu déroulant sont les suivantes :
  • Panneau Propriétés (Properties) : configurez les détails de connexion dans le panneau Propriétés (Properties).
  • Ressource : utilise les ressources d’identification Orchestrator. 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 (Properties) sont masqués, car les informations d’authentification sont stockées à l’intérieur de la ressource.

• Ressources de connexion ( Connection assets ) : 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 (Manage Assets ) pour ouvrir Orchestrator. La liste des ressources disponibles dépend de l'Orchestrator auquel votre Studio et votre Robot sont connectés.
  • Utilisez le bouton Plus pour sélectionner Recharger les ressources ( Reload Assets ) si vous avez mis à jour vos ressources dans Orchestrator. Notez que si vous ajoutez une nouvelle ressource dans Orchestrator alors que vous utilisez Studio Desktop, elle ne sera pas immédiatement disponible dans l’activité Étendue (Scope).

• Consultez le format de ressource dans la section Comment utiliser les activités Microsoft 365 sans connexion 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 (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).

Runtime

• Ressources de connexion du runtime ( Runtime connection assets ) : recherchez pour sélectionner une ressource. Ce champ vous permet de sélectionner une ressource différente pour l'exécution. Utilisez le bouton Plus pour sélectionner Chemin relatif ( Relative path ) et entrez le chemin d'accès complet de la ressource Orchestrator contenant les détails de connexion.

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 (Properties).

Tout d’abord, configurez les champs suivants :

• Connexions ( Connections) - Sélectionnez un compte dans la liste. Vous pouvez ajouter, supprimer et choisir les connexions à utiliser.
• Étendues d'authentification ( Authentication Scopes ) : consultez la section de l' assistant Utilisation des étendues d'authentification (Using the Authentication Scopes ) 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 (Authentication Scopes) 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)).
• 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ée dans les scénarios Unattended (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)).

Jeton interactif

Remarque : il s'agit de la même méthode d'authentification prise en charge dans Integration Service, soit via l'application UiPath publique, soit via une application personnalisée privée (méthode Fournissez votre propre application).

Pour plus de détails, consultez Jeton interactif.

• ApplicationOAuth - indique l'application (client) à utiliser. Ce champ prend uniquement en charge 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é (Custom) : 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 (Application ID). Consultez Comment créer une application pour les connexions Microsoft 365 Scope.

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 ( Certificate Password ) - Un mot de passe facultatif qui peut être requis pour utiliser le certificat, en tant que Secure String.

Application ID and Secret (Unattended)

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

• Clé secrète de l'application (Application Secret) - Chaîne secrète utilisée par l'application pour fournir son identité.
• Clé secrète de l'application sécurisée (Secure Application Secret) - La clé secrète de l'application (cliente), sous la forme d'un SecureString.

Nom d’utilisateur et mot de passe (Unattended)

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

Attention : 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 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).
• ContinuerSurErreur (ContinueOnError) - indique s'il faut poursuivre l'exécution des activités restantes, même si l'activité actuelle a échoué.

Résolution des problèmes

Si vous rencontrez des problèmes avec l'authentification, consultez Dépannage - Authentification.