Ámbito de Microsoft Teams

Las actividades de Microsoft Teams usan la plataforma de identidad de Microsoft para establecer una conexión autenticada entre UiPath y tu aplicación de Microsoft Teams a través de la actividad de Ámbito de Microsoft . Esta conexión permite que un Robot llame a la API de Microsoft Graph para leer y escribir recursos en su nombre.

Para establecer tu conexión autenticada, primero registras tu aplicación de Microsoft Teams en tu Azure Active Directory (usando tu cuenta personal, de trabajo y / o de la escuela de Microsoft Office 365). Al registrar tu aplicación, asignas los permisos de la API de Microsoft Graph que especifican los recursos a los que un robot puede acceder en tu nombre.

Después de registrar tu aplicación de Microsoft Teams, Azure Active Directory asigna un ID de aplicación (cliente) único que se introduce en la actividad del ámbito de Microsoft Teams . El ApplicationID se utiliza para recopilar la información necesaria sobre su aplicación registrada para iniciar la autenticación.

Nota: para obtener más información sobre cómo registrar tu aplicación y asignar permisos, consulta la guía de configuración . Esta guía proporciona instrucciones paso a paso para configurar tu aplicación Microsoft Teams para la automatización.

Cómo funciona

Los siguientes pasos y diagrama de secuencia de mensajes son un ejemplo de cómo funciona la actividad desde el momento de diseño (es decir, las dependencias de la actividad y las propiedades de entrada / salida) hasta el tiempo de ejecución.

1. Completa los pasos de configuración .
2. Agrega la actividad de Ámbito de Microsoft Teams a tu proyecto.

3. Introduce valores para las propiedades Autenticación, Entrada y Desatendido (si procede).

   
   

   

   
   

Automatización atendida frente a desatendida

La actividad de ámbito de Microsoft Teams tiene tres flujos de autenticación diferentes (AuthenticationTypes) entre los que puedes elegir al agregar la actividad a tu proyecto. Su selección depende del tipo de modo de automatización que planea ejecutar (desatendido o atendido) y los requisitos de autenticación de su aplicación (consulte con su administrador si no está seguro de qué requisitos de autenticación se aplican a su aplicación).

TipoDeAutenticación	Atendido	Desatendido
Token interactivo	X
AutenticaciónDeVentanasIntegradas	X	X
Nombre de usuario y contraseña	X	X

Importante: la automatización desatendida no admite la autenticación multifactor. Si tu aplicación requiere autenticación multifactor, solo puedes ejecutar la automatización atendida utilizando el tipo de autenticación InteractiveToken .

Token interactivo

El tipo de autenticación InteractiveToken se puede usar para la automatización atendida y cuando se requiere la autenticación multifactor (MFA). Esta es la opción predeterminada y la que usamos en nuestros ejemplos. Si está interesado en "jugar" con el paquete de actividades, esta opción es fácil de configurar y funciona bien para cuentas personales (utilizando el URI de redirección predeterminado que se indica en el paso 7 de la sección Registre su aplicación de la guía de configuración).

Cuando la actividad del ámbito de Microsoft Teams se ejecuta por primera vez con este tipo de autenticación, se le pide que autorice el acceso a los recursos (a los que concedió permisos al registrar la aplicación) a través de un cuadro de diálogo de consentimiento .

Si selecciona esta opción, las propiedades Nombre de usuario,Contraseña y Tenant deben dejarse vacías.

Este tipo de autenticación sigue el flujo del código de autorización de OAuth 2.0.

Autenticación de Windows integrada

El tipo de autenticación integrada de Windows se puede utilizar tanto para la automatización atendida como para la desatendida. Esta opción puede aplicarse a aplicaciones alojadas en Windows que se ejecutan en equipos unidos a un dominio de Windows o Azure Active Directory.

Solo debes seleccionar esta opción si tu aplicación registrada está configurada para admitir la autenticación integrada de Windows (se puede encontrar información adicional en GitHub ).

Si selecciona esta opción, las propiedades Nombre de usuario,Contraseña y Tenant deben dejarse vacías.

Nombre de usuario y contraseña

El tipo de autenticación UserNameAndPassword se puede usar tanto para la automatización atendida (cuando no se requiere la autenticación multifactor) como para la desatendida.

Aunque Microsoft no lo recomienda, puedes usar este tipo de autenticación en aplicaciones cliente públicas. El uso de este tipo de autenticación impone restricciones en su aplicación. Por ejemplo, las aplicaciones que usen este flujo no podrán iniciar la sesión de un usuario que necesite realizar una autenticación multifactor (acceso condicional). Tampoco permitirá que tu aplicación se beneficie del inicio de sesión único. La autenticación con nombre de usuario / contraseña va en contra de los principios de la autenticación moderna y solo se proporciona para fines heredados (se puede encontrar información adicional en GitHub ).

Si selecciona esta opción, se requieren las propiedades Nombre de usuario y Contraseña , y la propiedad Tenant es opcional para las aplicaciones de un solo tenant (necesaria para las aplicaciones de múltiples tenant).

Nota: la propiedad ApplicationID es obligatoria al seleccionar el tipo de autenticación de Nombre de usuario y contraseña. Puede registrar su aplicación Microsoft Office 365 con su cuenta personal, de trabajo o de la escuela.

Propiedades

Los valores para las siguientes propiedades se especifican al agregar esta actividad a tu proyecto en UiPath Studio.

Común

NombreParaMostrar

El nombre para mostrar de la actividad.

Atributos	Detalles
Tipo	String
Obligatorio	Sí
Valor predeterminado	Ámbito de Microsoft Teams
Valores permitidos	Introduce una variable String o String .
Notas	N/D

Autenticación

IDDeLaAplicación

El ID único de aplicación (cliente) asignado por Azure Active Directory al registrar la aplicación durante la configuración.

Atributos	Detalles
Tipo	String
Obligatorio	Sí
Valor predeterminado	Vacío
Valores permitidos	Introduce una variable String o String .
Notas	El ID de aplicación (cliente) representa una instancia de una aplicación de Microsoft Teams. Una sola organización puede tener varios ID de aplicación (cliente) para su cuenta de Microsoft Office 365. Cada ID de aplicación (cliente) contiene sus propios permisos y requisitos de autenticación. Por ejemplo, usted y su compañero pueden registrar una aplicación de Microsoft Teams en el Azure Active Directory de su empresa y crear su propio ID de aplicación (cliente).

TipoDeAutenticación

El tipo de autenticación requerido para su aplicación registrada.

Atributos	Detalles
Tipo	Selección desplegable
Obligatorio	Sí
Valor predeterminado	Token interactivo
Valores permitidos	Seleccione una de las tres opciones: TokenInteractivoNombre de usuario y contraseña de autenticación de Windows
Notas	Para obtener más información sobre estas opciones y cuál seleccionar, consulta la sección Automatización atendida y desatendida anterior.

Tenant

El ID único de directorio (tenant) asignado por Azure Active Directory cuando registró su aplicación durante.

Atributos	Detalles
Tipo	String
Obligatorio	No (requerido para aplicaciones de tenant múltiple)
Valor predeterminado	Vacío
Valores permitidos	Introduce una variable String o String .
Notas	El ID del directorio (tenant) se puede encontrar en la página de información general de tu aplicación registrada (bajo el ID de la aplicación (cliente)).

Token interactivo

AplicaciónOAuth

Indica la aplicación (cliente) que se usará.

Atributos	Detalles
Tipo	enum
Obligatorio	No
Valor predeterminado	Personalizar
Valores permitidos	Personalizado, UiPath
Notas	Si se selecciona 'UiPath', se omiten ApplicationId y Tenant.

Nombre de usuario y contraseña (desatendido)

Estas propiedades se aplican solo cuando ejecuta automatización desatendida. Al especificar valores para estas propiedades, asegúrate de que la propiedad TipoDeAutenticación esté establecida en Nombre de usuario y contraseña. Para obtener más información, consulta la sección Nombre de usuario y contraseña anterior.

Contraseña

La contraseña de su cuenta de Microsoft Office 365.

Atributos	Detalles
Tipo	String
Obligatorio	No (requerido si TipoDeAutenticación es Nombre de usuario y contraseña)
Valor predeterminado	Vacío
Valores permitidos	Introduce una variable String o String .
Notas	N/D

Contraseña segura

La contraseña de su cuenta de Microsoft Office 365.

Atributos	Detalles
Tipo	SecureString
Obligatorio	No (se requiere si TipoDeAutenticación es Nombre de usuario y contraseña) y la Contraseña es nula.
Valor predeterminado	Vacío
Valores permitidos	Introduce una variable SecureString o SecureString .
Notas	N/D

Nombre de usuario

El nombre de usuario de su cuenta de Microsoft Office 365.

Atributos	Detalles
Tipo	String
Obligatorio	No (requerido si TipoDeAutenticación es Nombre de usuario y contraseña)
Valor predeterminado	Vacío
Valores permitidos	Introduce una variable String o String .
Notas	N/D