Ámbito de Microsoft Teams

Las actividades de Microsoft Teams utilizan 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 Microsoft Scope . Esta conexión permite a un robot llamar a la API de Microsoft Graph para leer y escribir recursos en tu nombre.

Para establecer tu conexión autenticada, primero registras tu aplicación Microsoft Teams en tu Azure Active Directory (utilizando tu cuenta personal, de trabajo y/o educativa 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 puede acceder un robot en tu nombre.

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

Nota:

Para obtener más información sobre el registro de tu aplicación y la asignación de 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. Añade la actividad Ámbito de Microsoft Teams a tu proyecto.

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

   

Automatización atendida frente a desatendida

La actividad Ámbito de Microsoft Teams tiene tres flujos de autenticación diferentes (AuthenticationTypes) entre los que puedes elegir al añadir la actividad a tu proyecto. Tu selección depende del tipo de modo de automatización que planeas ejecutar (desatendido o atendido) y los requisitos de autenticación de tu aplicación (consulta con tu administrador si no estás seguro de qué requisitos de autenticación se aplican a tu 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 unattended no admite la autenticación multifactor. Si tu aplicación requiere autenticación multifactor, solo puedes ejecutar la automatización attended utilizando el tipo de autenticación InteractiveToken .

Token interactivo

El tipo de autenticación InteractiveToken puede utilizarse para la automatización attended y cuando se requiere la autenticación multifactor (MFA). Esta es la opción predeterminada y la que utilizamos en nuestros ejemplos. Si estás 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 anotado en el paso 7 de la sección Registra tu aplicación de la guía de Configuración).

Cuando la actividad Ámbito de Microsoft Teams se ejecuta por primera vez utilizando este tipo de autenticación, se te solicita que autorices el acceso a los recursos (a los que concediste permisos al registrar tu aplicación) a través de un cuadro de diálogo de consentimiento .

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

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

Autenticación de Windows integrada

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.

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

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

Nombre de usuario y contraseña

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

Aunque Microsoft no lo recomienda, puedes utilizar este tipo de autenticación en aplicaciones cliente públicas. El uso de este tipo de autenticación impone restricciones en tu aplicación. Por ejemplo, las aplicaciones que utilizan este flujo no podrán iniciar sesión en un usuario que necesite realizar la 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 por razones heredadas (se puede encontrar información adicional en 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).

Nota:

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.

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 la aplicación (cliente) asignado por Azure Active Directory al registrar tu 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, tú y tu colega podéis registrar una aplicación de Microsoft Teams en el Azure Active Directory de tu empresa y generar tu 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	Selecciona una de las tres opciones: Token interactivo Autenticación integrada de Windows Nombre de usuario y contraseña
Notas	Para obtener más información sobre estas opciones y cuál seleccionar, consulta la sección Automatización desatendida y atendida anterior.

Tenant

El ID único del directorio (tenant) asignado por Azure Active Directory al registrar tu 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 cuando ejecutas solo automatización desatendida. Al especificar valores para estas propiedades, asegúrate de que la propiedad TipoDeAutenticación esté establecida en NombreDeUsuarioYContraseñ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 (required if AuthenticationType is UsernameAndPassword)
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 (obligatorio si el TipoDeAutenticación es NombreDeUsuarioYContraseñ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 (required if AuthenticationType is UsernameAndPassword)
Valor predeterminado	Vacío
Valores permitidos	Introduce una variable String o String .
Notas	N/D