Autenticación de Microsoft Teams

Este documento describe cómo autenticar Microsoft Teams con UiPath Integration Service utilizando OAuth 2.0. El conector de Microsoft Teams admite la autenticación OAuth basada en el usuario, con soporte opcional para aplicaciones OAuth personalizadas y escenarios habilitados para bots.

Información general

La siguiente tabla resume las opciones de autenticación compatibles y sus requisitos previos.

Escenario de autenticación	Descripción	Requisitos previos
OAuth administrado por UiPath (código de autorización)	Utiliza una aplicación administrada por UiPath	Cuenta de Microsoft Teams, capacidad de otorgar consentimiento
Traiga su propia aplicación OAuth (BYOA)	Utiliza una aplicación de Azure AD administrada por el cliente	Aplicación de Azure AD, ID de cliente, secreto de cliente, ID de tenant, consentimiento del administrador

Autenticación OAuth 2.0

Incluir bot

La opción Incluir bot determina si la conexión incluye acceso basado en bots de Microsoft Teams además de los permisos OAuth delegados por el usuario.

Configuración	Comportamiento
No (predeterminado)	Solo OAuth delegado por el usuario
Sí	Habilita la funcionalidad del bot de Microsoft Teams

Nota:

• La autenticación de bot requiere un bot de Microsoft Teams registrado en Azure.
• La compatibilidad con bots no es necesaria para la mayoría de las actividades de Microsoft Teams.
• Utiliza esta opción solo si tu automatización requiere explícitamente capacidades de bot.

Configuración de Trae tu propia aplicación OAuth (BYOA)

Si seleccionas Trae tu propia aplicación OAuth, configura tu aplicación Azure AD de la siguiente manera.

Configuración de la aplicación Azure

Configuración	Valor
Flujo de OAuth	Código de autorización
URL de redirección/devolución de llamada	https://{baseURL}/provisioning_/callback(por ejemplo,https://cloud.uipath.com/provisioning_/callback para Automation Cloud).
Tipos de cuenta compatibles	Tenant único o multitenant
API	Microsoft Graph

ID de tenant

Tipo de aplicación	ID de tenant
Multi-tenant	common
Tenant único	ID de tenant de Azure

Nota:

UiPath admite tanto aplicaciones de tenant único como multi tenant.

Ámbitos y permisos

Los ámbitos controlan qué acciones puede realizar UiPath en Microsoft Teams. Los ámbitos son configurables durante la creación de la conexión.

Ámbitos obligatorios

Los siguientes ámbitos son obligatorios y no deben eliminarse. Son necesarios para una conexión correcta.

Ámbito	Propósito
openid	Autenticación de usuario y generación de tokens de ID
offline_access	Habilita la emisión de tokens de actualización
User.Read	Lee el perfil de usuario que ha iniciado sesión

Nota:

La eliminación de cualquier ámbito obligatorio dará lugar a fallos de conexión o de autenticación en tiempo de ejecución.

Todos los ámbitos

Los siguientes ámbitos habilitan escenarios de automatización comunes de Microsoft Teams.

Ámbito	Use case	Actividad o evento
openid	Al utilizar este permiso, una aplicación puede recibir un identificador único para el usuario en forma de subdemanda. El permiso también otorga a la aplicación acceso al punto final UserInfo . El ámbito openid puede utilizarse en el punto final del token de la plataforma de identidad de Microsoft para adquirir tokens de ID. La aplicación puede utilizar estos tokens para la autenticación	N/D
offline_access	Se requiere para recibir el token de actualización en el punto final de la solicitud de autenticación. Al canjear un código de autorización en el flujo de código de autorización OAuth 2.0 sin ámbito de acceso sin conexión, no recibirás el token de actualización del punto final /token.	N/D
profile	Recuperar el perfil de usuario actual, como nombre, nombre de usuario, correo electrónico, etc., para que pueda usarse como usuario predeterminado/autenticado en la creación de la conexión y en ciertas actividades	N/D
email	Permite que la aplicación lea las direcciones de correo electrónico principales de todos los usuarios, para enviar mensajes o invitarlos a un canal	Enviar mensaje de chat individual, Invitar miembro al canal, Invitar usuario al equipo
User.Read	Permite a los usuarios iniciar sesión en la aplicación y permite que la aplicación lea el perfil de los usuarios que han iniciado sesión. También permite que la aplicación lea la información básica de la empresa de los usuarios que han iniciado sesión	Obtener registro → Yo
Team.Create	Crear un equipo para invitar e involucrar a los usuarios respectivos	Insertar registro → Equipos
Team.ReadBasic.All	Recuperar la lista de equipos que se seleccionarán en las actividades, como enviar un mensaje de canal, etc.	Crear canal, enumerar todos los canales, enviar mensaje de chat, enviar mensaje de chat individual, invitar a un miembro a un canal, responder a un mensaje de canal, enviar mensaje de canal, obtener equipo por nombre
TeamMember.ReadWrite.All	Añadir miembro a un equipo en nombre del usuario que ha iniciado sesión Recuperar la lista de miembros de un equipo	Enumerar todos los miembros del equipo, Invitar usuario al equipo, Obtener equipo por nombre, Insertar registro → Miembros del equipo, Enumerar todos los registros → Miembros del equipo
Channel.Create	Crear un canal (estándar/privado) para invitar e involucrar a los respectivos usuarios del equipo	Crear canal
Channel.ReadBasic.All	Recuperar la lista de canales de un equipo que se seleccionará en las actividades, como enviar un mensaje de canal, etc.	Obtener canal por nombre, Invitar a un miembro a un canal, Enumerar todos los canales, Enumerar canal por nombre, Responder al mensaje del canal, Enviar mensaje del canal
ChannelMember.ReadWrite.All	Añadir miembro a un canal en nombre del usuario que ha iniciado sesión Recuperar la lista de miembros involucrados en un canal	Invitar a un miembro a un canal, enumerar todos los registros → Miembros de los canales de Teams
ChannelMessage.Send	Enviar un mensaje en un canal. Además, responde a un mensaje en un hilo, si es necesario.	Responder al mensaje del canal, Enviar mensaje del canal
ChannelMessage.Read.All	Permite que la aplicación lea todos los mensajes del canal en Microsoft Teams, sin un usuario que haya iniciado sesión. También se utiliza para desencadenar eventos cada vez que se publica un mensaje en el canal o cada vez que se menciona una palabra clave en el canal	Responder al mensaje del canal, Enumerar todos los mensajes del canal, Enumerar todos los registros → Mensajes de los canales de Teams, Cuando se publica un mensaje en el canal (Futuro), Cuando se menciona una palabra clave o nombre de usuario en el canal (Futuro)
Chat.ReadWrite	Permite que la aplicación lea y envíe tu 1:1 Permite que la aplicación lea y envíe mensajes de chat de grupo También se utiliza para desencadenar eventos cada vez que se publica un mensaje de chat	Enviar mensaje de chat de grupo, Enviar mensaje de chat individual, Enumerar todos los mensajes de chat, Enumerar todos los registros → Chats, Cuando se publica un mensaje de chat (Futuro)
ChatMember.ReadWrite	Añadir miembro a un chat en nombre del usuario que ha iniciado sesión Recuperar la lista de miembros involucrados en un chat	Insertar registro → Miembros de chats, Enumerar todos los registros → Miembros de chats
Calendars.ReadWrite	Crea una entrada de calendario de Outlook de la reunión de Teams en línea.	Crear reunión en línea de Teams
OnlineMeetings.ReadWrite	Cree una reunión en línea en Microsoft Teams y recupere el ID de la reunión, el código de acceso y la URL en nombre del usuario actual.	Crear reunión en línea de Teams
Files.Read.All	Recuperar la información del archivo que se cargó en SharePoint para compartirla en un canal o chat de Teams	Enviar mensaje de canal Enviar mensaje de chat de grupo, enviar mensaje de chat individual, responder a mensaje de canal

Se pueden añadir o eliminar ámbitos para seguir los principios de privilegios mínimos .

Actualizar tokens para aplicaciones OAuth

Microsoft puede invalidar o revocar los tokens de actualización para las aplicaciones OAuth en cualquier momento. Esto puede ocurrir por diferentes razones, como los tiempos de espera y las revocaciones. Para obtener más información, consulta la documentación oficial de Microsoft.

Nota:

La invalidación del token da como resultado conexiones fallidas y las automatizaciones no pueden ejecutarse sin reparar las conexiones.

Este problema afecta a todos los conectores basados en Microsoft Graph.

Asegúrate de seguir las mejores prácticas de Microsoft al crear tus aplicaciones OAuth. Para obtener más información sobre cómo crear una aplicación OAuth de Microsoft, consulta la documentación de Microsoft.

Agregar la conexión de Microsoft Teams

Para crear una conexión a su instancia de Microsoft Teams, debe realizar los siguientes pasos:

1. Selecciona Integration Service en la barra izquierda.
2. En la lista Conectores , selecciona Microsoft Teams. También puedes utilizar la barra de búsqueda para acotar el conector.
3. Selecciona Conectar a Microsoft Teams.
4. Ahora se te redirige a la página de conexión. Puedes elegir entre dos tipos de autenticación: Código de autorización OAuth 2.0 o Trae tu propia aplicación OAuth 2.0.
5. Introduce las credenciales necesarias.
6. Select Connect.

Para obtener más información sobre la autenticación en Microsoft Teams, consulta la página Autenticación y autorización de Microsoft.