Étendue de Microsoft Teams

Les activités Microsoft Teams utilisent la plate-forme d’ identité Microsoft pour établir une connexion authentifiée entre UiPath et votre application Microsoft Teams via l’activité Étendue Microsoft ( Microsoft Scope ). Cette connexion permet à un Robot d'appeler l'API Microsoft Graph pour lire et écrire des ressources en votre nom.

Pour établir votre connexion authentifiée, vous devez d'abord enregistrer votre application Microsoft Teams dans votre Azure Active Directory (à l'aide de votre compte Microsoft Office 365 personnel, professionnel et/ou scolaire). Lors de l'enregistrement de votre application, vous attribuez les autorisations de l'API Microsoft Graph qui spécifient les ressources auxquelles un robot peut accéder en votre nom.

Après avoir enregistré votre application Microsoft Teams, Azure Active Directory lui attribue un ID d'application (client) unique que vous saisissez dans l'activité Étendue Microsoft Teams ( Microsoft Teams Scope ). L ' IDApplication est utilisé pour collecter les informations nécessaires sur votre application enregistrée afin d'initier l'authentification.

Remarque : pour en savoir plus sur l'enregistrement de votre application et l'attribution d'autorisations, consultez le Guide de configuration . Ce guide fournit des instructions étape par étape pour configurer votre application Microsoft Teams pour l'automatisation.

Mode de fonctionnement

Les étapes et le diagramme de séquence de messages suivants illustrent le fonctionnement de l'activité, depuis la conception (c'est-à-dire les dépendances d'activité et les propriétés d'entrée/sortie) jusqu'à l'exécution.

1. Terminez les étapes de configuration .
2. Ajoutez l’activité Étendue Microsoft Teams ( Microsoft Teams Scope ) à votre projet.

3. Saisissez des valeurs pour les propriétés Authentification, Entrée(Input) et Non assisté ( Unattended ) (le cas échéant) (le cas échéant).

   
   

   

   
   

Automatisation avec ou sans assistance

L'activité Étendue Microsoft Teams ( Microsoft Teams Scope ) dispose de trois flux d'authentification différents ( TypesAuthentification (AuthenticationTypes) ) parmi lesquels vous pouvez choisir lors de l'ajout de l'activité à votre projet. Votre sélection dépend du type de mode d'automatisation que vous prévoyez d'exécuter (Unattended ou Attended) et des exigences d'authentification de votre application (consultez votre administrateur si vous n'êtes pas sûr des exigences d'authentification qui s'appliquent à votre application).

AuthenticationType	Assisté (Attended)	Non assisté (Unattended)
Jeton interactif	X
IntegratedWindowsAuthentication	X	X
NomUtilisateurEtMotdePasse	X	X

Attention : l'automatisation Unattended ne prend pas en charge l'authentification à plusieurs facteurs. Si votre application nécessite une authentification à plusieurs facteurs, vous pouvez uniquement exécuter une automatisation assistée à l'aide du type d'authentification InteractiveToken .

Jeton interactif

Le type d'authentification InteractiveToken peut être utilisé pour l'automatisation assistée et lorsque l'authentification à plusieurs facteurs (MFA) est requise. Il s'agit de l'option par défaut et de ce que nous utilisons dans nos exemples. Si vous souhaitez « jouer » avec le package d'activités, cette option est facile à configurer et fonctionne bien pour les comptes personnels (en utilisant l'URI de redirection par défaut notée à l'étape 7 de la section Enregistrer votre application du guide de configuration).

Lorsque l’activité Étendue Microsoft Teams ( Microsoft Teams Scope ) est exécutée pour la première fois à l’aide de ce type d’authentification, vous êtes invité à autoriser l’accès aux ressources (auquel vous avez accordé des autorisations lors de l’enregistrement de votre application) via une boîte de dialogue de consentement .

Si vous sélectionnez cette option, les propriétés Nom d'utilisateur ( Username) ,Mot de passe (Password) et Locataire (Tenant) doivent être laissées vides.

Ce type d'authentification suit le flux de code d'autorisation OAuth 2.0.

IntegratedWindowsAuthentication

Le type d’authentification IntegratedWindowsAuthentication peut être utilisé pour l’automatisation assistée et non assistée. Cette option peut s'appliquer aux applications hébergées par Windows exécutées sur des ordinateurs joints à un domaine Windows ou Azure Active Directory.

Vous ne devez sélectionner cette option que si votre application enregistrée est configurée pour prendre en charge l'authentification Windows intégrée (des informations supplémentaires sont disponibles sur GitHub ).

Si vous sélectionnez cette option, les propriétés Nom d'utilisateur ( Username) ,Mot de passe (Password) et Locataire (Tenant) doivent être laissées vides.

UsernameAndPassword

Le type d’authentification UsernameAndPassword peut être utilisé à la fois pour l’automatisation assistée (lorsque l’authentification à plusieurs facteurs n’est pas requise) et l’automatisation non assistée.

Bien que cela ne soit pas recommandé par Microsoft, vous pouvez utiliser ce type d'authentification dans les applications clientes publiques. L'utilisation de ce type d'authentification impose des contraintes à votre application. Par exemple, les applications utilisant ce flux ne pourront pas connecter un utilisateur qui doit effectuer une authentification à plusieurs facteurs (accès conditionnel). Cela ne permettra pas non plus à votre application de bénéficier de l’authentification unique. L'authentification avec nom d'utilisateur/mot de passe va à l'encontre des principes de l'authentification moderne et n'est fournie qu'à des fins héritées (des informations supplémentaires sont disponibles sur GitHub ).

Si vous sélectionnez cette option, les propriétés Nom d'utilisateur ( Username ) et Mot de passe (Password) sont requises et la propriété Locataire (Tenant) est facultative pour les applications à locataire unique (obligatoire pour les applications à locataires multiples).

Remarque : la propriété IDApplication est requise lors de la sélection de UsernameAndPassword AuthenticationType. Vous pouvez enregistrer votre application Microsoft Office 365 à l’aide de votre compte personnel, professionnel et/ou scolaire.

Propriétés

Les valeurs des propriétés suivantes sont spécifiées lors de l'ajout de cette activité à votre projet dans UiPath Studio.

Commun

DisplayName

Le nom complet de l’activité.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Oui (Yes)
Valeur par défaut	Étendue de Microsoft Teams
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	S/O

Authentification

ApplicationID

L'ID d'application (client) unique attribué par Azure Active Directory lorsque vous avez enregistré votre application lors de l' installation.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Oui (Yes)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	L'ID d'application (client) représente une instance d'une application Microsoft Teams. Une même organisation peut avoir plusieurs ID d'application (client) pour son compte Microsoft Office 365. Chaque ID d'application (client) contient ses propres autorisations et exigences d'authentification. Par exemple, vous et votre collègue pouvez tous les deux enregistrer une application Microsoft Teams dans l'Azure Active Directory de votre entreprise et générer votre propre ID d'application (client).

AuthenticationType

Le type d'authentification requis pour votre application enregistrée.

Attributs	Détails (Details)
Saisie de texte	Sélection déroulante
Requis	Oui (Yes)
Valeur par défaut	Jeton interactif
Valeurs autorisées	Sélectionnez l'une des trois options : InteractifJetonAuthentificationWindowsIntégréeNomUtilisateurEtMotDePasse _ _
Remarques	Pour plus d'informations sur ces options et savoir laquelle sélectionner, consultez la section Automatisation assistée et non assistée ci-dessus.

Locataire

L'ID d'annuaire (locataire) unique attribué par Azure Active Directory lorsque vous avez enregistré votre application pendant .

Attributs	Détails (Details)
Saisie de texte	String
Requis	Non (requis pour les applications mutualisées)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	L'ID (locataire) d'annuaire se trouve dans la page d'aperçu de votre application enregistrée (sous l'ID d'application (client)).

Jeton interactif

ApplicationOAuth

Indique l’application (client) à utiliser.

Attributs	Détails (Details)
Saisie de texte	enum
Requis	Non (No)
Valeur par défaut	Personnalisé
Valeurs autorisées	Personnalisé, UiPath
Remarques	Si « UiPath » est sélectionné, IDApplication et Locataire sont ignorés.

Nom d’utilisateur et mot de passe (Unattended)

Ces propriétés s'appliquent uniquement lorsque vous exécutez une automatisation Unattended. Lorsque vous spécifiez les valeurs de ces propriétés, assurez-vous que la propriété TypeAuthentification est définie sur UsernameAndPassword. Pour plus d'informations, consultez la section Nom d'utilisateur et mot de passe ci-dessus.

Mot de passe (Password)

Mot de passe de votre compte Microsoft Office 365.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Non (requis si TypeAuthentification a la valeur UsernameAndPassword)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	S/O

MotDePasseSécurisé

Mot de passe de votre compte Microsoft Office 365.

Attributs	Détails (Details)
Saisie de texte	SecureString
Requis	Non (requis si TypeAuthentification a la valeur UsernameAndPassword) et le mot de passe a la valeur Null.
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable SecureString ou SecureString .
Remarques	S/O

Nom d'utilisateur (Username)

Le nom d'utilisateur de votre compte Microsoft Office 365.

Attributs	Détails (Details)
Saisie de texte	String
Requis	Non (requis si TypeAuthentification a la valeur UsernameAndPassword)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	S/O