Étendue de Microsoft Teams

Les activités Microsoft Teams utilisent la Plateforme d’identités Microsoft pour établir une connexion authentifiée entre UiPath et votre application Microsoft Teams via l'activité Étendue Microsoft . 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 indiquent 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 identifiant d’application (client) unique que vous saisissez dans l’activité 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 à votre projet.

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

   

Automatisation avec ou sans assistance

L'activité Étendue Microsoft Teams dispose de trois flux d'authentification différents (TypesAuthentification) que vous pouvez choisir lorsque vous ajoutez l'activité à votre projet. Votre sélection dépend du type de mode d'automatisation que vous prévoyez d'exécuter et des exigences d'authentification de votre application (consultez votre administrateur si vous ne savez pas quelles exigences d'authentification s'appliquent à votre application).

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

Important :

L'automatisation Unattended ne prend pas en charge l'authentification multifacteur. Si votre application nécessite une authentification multifacteur, vous ne pouvez exécuter une automatisation attended qu'à l'aide du type d'authentification InteractiveToken .

Jeton interactif

Le type d’authentification Jeton interactif peut être utilisé dans le cadre de l’automatisation Attended et lorsqu’une authentification multifacteur (MFA) est requise. Il s'agit de l'option par défaut et de celle 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 .

Lorsque l'activité Étendue Microsoft Teams 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 via une boîte de dialogue de consentement .

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

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

IntegratedWindowsAuthentication

The IntegratedWindowsAuthentication authentication type can be used for both attended and unattended automation. This option can apply to Windows hosted applications running on computers joined to a Windows domain or 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 peuvent être trouvées sur GitHub).

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

UsernameAndPassword

The UsernameAndPassword authentication type can be used for both attended (when mutli-factor authentication is not required) and unattended automation.

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 sur votre application. Par exemple, les applications utilisant ce flux ne pourront pas connecter un utilisateur qui doit effectuer une authentification multifacteur (accès conditionnel). Cela ne permettra pas non plus à votre application de bénéficier de l’authentification unique. L’authentification via nom d’utilisateur/mot de passe va à l’encontre des principes d’authentification moderne et n’est fournie que pour des raisons d’héritage (des informations supplémentaires sont disponibles sur GitHub).

If you select this option, the Username and Password properties are required and the Tenant property is optional for single-tenant applications (required for multi-tenant applications).

Remarque :

The ApplicationID property is required when selecting the UsernameAndPassword AuthenticationType. You can register your Microsoft Office 365 Application using your personal, work, and/or school account.

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 unique (client) attribué par Azure Active Directory lorsque vous avez enregistré votre application lors de la Configuration.

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'annuaire 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 : Jeton interactif Intégré Authentification Windows NomUtilisateurEtMotDePasse
Remarques	Pour plus d'informations sur ces options et celle à sélectionner, consultez la section Automatisation Unattended et Attended ci-dessus.

Locataire

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

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 des valeurs pour ces propriétés, veillez à ce que la propriété TypeAuthentification soit définie sur NomUtilisateurEtMotDePasse. 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	No (required if AuthenticationType is 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 AuthentificationType est UsernameAndPassword) et le Mot de passe est 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	No (required if AuthenticationType is UsernameAndPassword)
Valeur par défaut	Vide
Valeurs autorisées	Saisissez une variable String ou String .
Remarques	S/O