Authentification Microsoft Teams

Ce document explique comment authentifier Microsoft Teams auprès d’ UiPath Integration Service à l’aide d’OAuth 2.0. Le connecteur Microsoft Teams prend en charge l’authentification OAuth basée sur l’utilisateur, avec la prise en charge facultative d’applications OAuth personnalisées et de scénarios activés par le bot.

Vue d'ensemble (Overview)

Le tableau suivant résume les options d'authentification prises en charge ainsi que leurs conditions préalables.

Scénario d'authentification	Description	Prérequis
OAuth géré par UiPath (code d'autorisation)	Utilise une application gérée par UiPath	Compte Microsoft Teams, possibilité d’accorder le consentement
Apporter votre propre application OAuth (BYOA)	Utilise une application Azure AD gérée par le client	Application Azure AD, ID de client, clé secrète du client, ID de locataire, consentement de l'administrateur

Authentification OAuth 2.0

Inclure le bot

The Include Bot option determines whether the connection includes Microsoft Teams bot-based access in addition to user-delegated OAuth permissions. Selecting this option enables sending messages as Uipath notification with your connection.

Paramètre	Comportement
Non (Par défaut)	OAuth délégué à l'utilisateur uniquement
Oui (Yes)	Active la fonctionnalité de bot Microsoft Teams

Remarque :

• L'authentification des bots nécessite un bot Microsoft Teams enregistré dans Azure.
• La prise en charge de bot n’est pas requise pour la plupart des activités Microsoft Teams.
• Utilisez cette option uniquement si votre automatisation nécessite explicitement des capacités de bot.

Configuration de l’application OAuth Apps (BYOA)

Si vous sélectionnez Apporter votre propre application OAuth, configurez votre application Azure AD comme suit.

Paramètres d’application Azure

Paramètre	Valeur (Value)
Flux OAuth	Code d'autorisation
URL de redirection/rappel	https://{baseURL}/provisioning_/callback(par exemple,https://cloud.uipath.com/provisioning_/callback pour Automation Cloud).
Types de compte pris en charge	Locataire unique ou multi-locataire
API	Microsoft Graph

ID de locataire

Type d'application	ID de locataire
Multi-tenant	common
Locataire unique	ID de locataire Azure

Remarque :

UiPath prend en charge les applications à locataire unique et multi-locataires.

Étendues et autorisations

Les étendues contrôlent les actions qu’UiPath peut effectuer dans Microsoft Teams. Les étendues peuvent être configurées lors de la création de la connexion.

Étendues obligatoires

Les étendues suivantes sont obligatoires et ne doivent pas être supprimées. Ils sont nécessaires pour une connexion réussie.

Portée	Objectif
openid	Authentification de l'utilisateur et génération de jeton d'identification
offline_access	Permet l’émission d’un jeton d’actualisation
User.Read	Lit le profil de l’utilisateur connecté

Remarque :

La suppression de toute étendue obligatoire entraînera l'échec de l'authentification de la connexion ou du runtime.

Toutes les étendues

Les étendues suivantes activent les scénarios d’automatisation Microsoft Teams courants.

Portée	Use case	Activité ou événement
openid	En utilisant cette autorisation, une application peut recevoir un identificateur unique pour l'utilisateur sous la forme de la sous-demande. L'autorisation donne également à l'application l'accès au point de terminaison UserInfo . L'étendue openid peut être utilisée au point de terminaison du jeton de la plate-forme d'identités Microsoft pour acquérir les jetons d'identification. L’application peut utiliser ces jetons pour l’authentification	S/O
offline_access	Requis pour recevoir un jeton d’actualisation dans le point de terminaison de la demande d’authentification. Lorsque vous échangez un code d’autorisation dans le flux de code d’autorisation OAuth 2.0 sans étendue hors ligne/accès, vous ne recevrez pas le jeton d’actualisation provenant du point de terminaison /token.	S/O
profile	Récupération du profil de l'utilisateur actuel tel que le nom, le nom d'utilisateur, l'e-mail, etc., afin qu'il puisse être utilisé par défaut/utilisateur authentifié lors de la création de la connexion et dans certaines activités	S/O
email	Permet à l'application de lire toutes les adresses e-mail principales de vos utilisateurs, pour envoyer des messages ou les inviter à un canal	Envoyer un message de chat individuel, inviter un membre à rejoindre un canal, inviter un utilisateur à rejoindre l'équipe
User.Read	Permet aux utilisateurs de se connecter à l'application et permet à l'application de lire le profil des utilisateurs connectés. Elle permet également à l'application de lire les informations de base de l'entreprise sur les utilisateurs connectés	Obtenir l'enregistrement → Je
Team.Create	Créez une équipe pour inviter et impliquer les utilisateurs respectifs	Insérer un enregistrement → Équipes
Team.ReadBasic.All	Récupérer la liste des équipes à sélectionner dans les activités, telles que l'envoi d'un message de canal, etc.	Créer un canal, Répertorier tous les canaux, Envoyer un message de chat, Envoyer un message de chat individuel, Inviter un membre à rejoindre un canal, Répondre à un message de canal, Envoyer un message de canal, Obtenir l'équipe par nom
TeamMember.ReadWrite.All	Ajouter un membre à une équipe au nom de l'utilisateur connecté Récupérer la liste des membres d'une équipe	Répertorier tous les membres de l'équipe, Inviter l'utilisateur à rejoindre l'équipe, Obtenir l'équipe par nom, Insérer un enregistrement → membres de l'équipe, Répertorier tous les enregistrements → membres de l'équipe
Channel.Create	Créer un canal (standard/privé) pour inviter et engager les utilisateurs respectifs de l'équipe	Créer le canal
Channel.ReadBasic.All	Récupérer la liste des canaux d'une équipe à sélectionner dans les activités telles que l'envoi d'un message de canal, etc.	Obtenir le canal par nom, Inviter un membre à rejoindre un canal, Répertorier tous les canaux, Répertorier le canal par nom, Répondre au message de canal, Envoyer un message de canal
ChannelMember.ReadWrite.All	Ajouter un membre à un canal pour le compte de l'utilisateur connecté Récupérer la liste des membres impliqués dans un canal	Inviter un membre à rejoindre un canal, répertorier tous les enregistrements → membres des canaux en équipes
ChannelMessage.Send	Envoyer un message dans un canal. Répondez également à un message dans un fil de discussion, si nécessaire.	Répondre au message de canal, envoyer un message de canal
ChannelMessage.Read.All	Permet à l'application de lire tous les messages du canal dans Microsoft Teams, sans utilisateur connecté Également utilisé pour déclencher des événements chaque fois qu'un message est publié dans le canal ou chaque fois qu'un mot-clé est mentionné dans le canal	Répondre au message de canal, Répertorier tous les messages de canal, Répertorier tous les enregistrements → Messages des canaux en équipes, Lorsqu'un message publié sur le canal (Future), Lorsqu'un mot-clé ou nom d'utilisateur est mentionné dans le canal (Futeur)
Chat.ReadWrite	Permet à l'application de lire et d'envoyer vos 1:1 Permet à l'application de lire et d'envoyer des messages de chat de groupe Également utilisé pour déclencher des événements chaque fois qu'un message de chat est publié	Envoyer un message de chat de groupe, Envoyer un message de chat individuel, Répertorier tous les messages de chat, Répertorier tous les enregistrements → Chats, lorsqu'un message de chat est publié (Futeur)
ChatMember.ReadWrite	Ajouter un membre à un chat au nom de l'utilisateur connecté Récupérer la liste des membres impliqués dans un chat	Insérer un enregistrement → Membres des chats, Répertorier tous les enregistrements → Membres des chats
Calendars.ReadWrite	Créez une entrée de calendrier Outlook de la réunion en ligne des équipes.	Create Online Teams Meeting
OnlineMeetings.ReadWrite	Créez une réunion en ligne dans Microsoft Teams et récupérez l'ID de réunion, le code de passe et l'URL au nom de l'utilisateur actuel.	Create Online Teams Meeting
Files.Read.All	Récupérer les informations du fichier téléchargé sur SharePoint afin de les partager sur un canal ou un chat en équipes	Envoyer un message de canal - Envoyer un message de chat de groupe, Envoyer un message de chat individuel, Répondre au message de canal

Des étendues peuvent être ajoutées ou supprimées pour suivre les principes de moindre privilège .

Actualiser les jetons pour les applications OAuth

Les jetons de réactualisation pour les applications OAuth peuvent être invalidés ou révoqués à tout moment par Microsoft. Cela peut se produire pour différentes raisons, telles que des délais d’attente ou des révocations. Pour plus d’informations, consultez la documentation officielle de Microsoft .

Remarque :

L'invalidation du jeton entraîne des connexions échouées et les automatisations ne peuvent pas s'exécuter sans que les connexions soient réparées.

Ce problème affecte tous les connecteurs basés sur Microsoft Graph.

Assurez-vous de suivre les meilleures pratiques de Microsoft lors de la création de vos applications OAuth. Pour en savoir plus sur la création d'une application Microsoft OAuth, consultez la documentation Microsoft .

Ajouter la connexion Microsoft Teams

Pour créer une connexion à votre instance Microsoft Teams, vous devez effectuer les étapes suivantes :

1. Select Orchestrator from the product launcher.
2. Select a folder, and then navigate to the Connections tab.
3. Sélectionnez Ajouter une connexion (Add connecion).
4. To open the connection creation page, select the connector from the list. You can use the search bar to find the connector.
5. Vous pouvez choisir entre deux types d'authentification : Code d'autorisation OAuth 2.0 ou Fournissez votre propre application OAuth 2.0.
6. Entrez les identifiants requis.
7. Select Connect.

Pour plus d’informations sur l’authentification dans Microsoft Teams, consultez la page Authentification et autorisation Microsoft.