Cómo utilizar las actividades de Microsoft 365 sin conexiones de Integration Service

Acerca de

Ahora puedes utilizar las actividades más recientes de Microsoft 365 incluso si no tienes Integration Service, a través del ámbito de Microsoft 365.

Las actividades de Microsoft 365 diseñadas específicamente para Integration Service cuentan con un campo Conexión, que te permite elegir una conexión creada a través de un conector de Integration Service. Cuando se utilizan dentro del ámbito de Microsoft 365, las actividades simplemente heredan la información de conexión del ámbito.

Matriz de tipos de autenticación y proyectos

Microsoft 365
	Nube		In situ
	Ámbito de aplicación de Microsoft Office 365	Integration Service	Ámbito de aplicación de Microsoft Office 365	Integration Service
Multiplataforma
Token interactivo: OAuth: aplicación pública de UiPath	❌	✅	❌	❌
Token interactivo: OAuth: BYOA	❌	✅	❌	❌
Autenticación de Windows integrada	❌	❌	❌	❌
Nombre de usuario y contraseña	❌	❌	❌	❌
Secreto e ID de aplicación	❌	❌	❌	❌
IDDeAplicación y certificado	❌	❌	❌	❌
Ventanas
Token interactivo: OAuth: aplicación pública de UiPath	✅	✅	✅	❌
Token interactivo: OAuth: BYOA	✅	✅	✅	❌
Autenticación de Windows integrada	✅	❌	✅	❌
Nombre de usuario y contraseña	✅	❌	✅	❌
Secreto e ID de aplicación	✅	✅	✅	❌
IDDeAplicación y certificado	✅	❌	✅	❌

Métodos de conexión

Hay dos formas de configurar una conexión en la actividad Ámbito de Microsoft 365 .

Método de conexión		Descripción	Beneficios	Desventajas
Activo (recomendado)		Utiliza un activo de Orchestrator para almacenar la conexión junto con la configuración del ámbito. El activo es un formato JSON. Cada vez que se utiliza, la actividad recupera la configuración del activo. Según la configuración del activo, el Ámbito se comporta de forma diferente; identifica el tipo de autenticación y oculta los campos innecesarios. Si el JSON del activo no está configurado correctamente, se produce un error de validación.	Las actividades se benefician de las búsquedas en tiempo de diseño y pueden descubrir archivos, carpetas, listas, rangos y otros. La conexión es fácilmente transferible, ya que las credenciales no se transmiten de un usuario a otro en texto sin formato. Puede ser configurado por un administrador. Es más seguro, porque las credenciales no llegan al flujo de trabajo de Studio.	Requiere un usuario avanzado para configurar el activo. No es fácil de configurar por parte de un Citizen Developer.
Panel de propiedades		Utiliza el panel de propiedades existente para configurar las credenciales de conexión. La configuración se puede añadir en texto sin formato o mediante variables.	Más fácil de usar. Mantiene la compatibilidad con versiones anteriores.
	Configuración a través de texto sin formato (no recomendado)	Configura el panel Propiedades con valores de texto sin formato.	Las actividades se benefician de las búsquedas en tiempo de diseño y pueden descubrir archivos, carpetas, listas, rangos y otros.	Menos seguro, porque las credenciales deben pasarse entre usuarios en texto sin formato.
	Configuración a través de variables	Configura el panel de propiedades con variables.	Más seguro, porque las credenciales no llegan al flujo de trabajo de Studio.	Las actividades no pueden descubrir ningún recurso en tiempo de diseño.

Formato de activo de ámbito de Microsoft 365

Nota:

El uap utilizado en las siguientes secciones significa nombre de usuario y contraseña.

Formato de activo estándar

El siguiente es el formato JSON aceptado que puedes utilizar en activos de texto, en tiempo de diseño o tiempo de ejecución, o ambos, y activos de credenciales que puedes utilizar en tiempo de ejecución para especificar detalles de Microsoft 365.

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive",
    "OAuth2AppData": {
        "ApplicationId": "",
        "TenantId": ""
    }
}

Nota:

Al utilizar los parámetros OAuth2AppData, ApplicationId y TenantId , asegúrate de rellenar esto en función del modo de autenticación elegido. Puedes encontrar ejemplos en las secciones siguientes.

La lista completa de opciones que puedes elegir para los parámetros Entorno y Modo es:

• "Environment": "Default" | "Global" | "China" | "Germany" | "USGovernment" | "USGovernmentDOD",
• "Mode": "interactive" | "integrated" | "uap" | "appidsecret" | "appidcertificate",

Configuración de activos de la aplicación UiPath multitenant (OAuth: aplicación pública de UiPath)

Nota:

El ID de aplicación del ejemplo es el ID de aplicación de UiPath válido que puedes utilizar para las conexiones.

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive",
    "OAuth2AppData": {
        "ApplicationId": "f2f43f65-16a6-4319-91b6-d2a342a88744",
        "TenantId": ""
    }
}

Cuando se requiera un ID de tenant, consulta la sección Detalles del token interactivo .

Configuración de activos de la aplicación UiPath de tenant único (OAuth: aplicación pública de UiPath)

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive",
    "OAuth2AppData": {
        "ApplicationId": "f2f43f65-16a6-4319-91b6-d2a342a88744",
        "TenantId": "your unique Microsoft 365 tenant ID"
    }
}

Configuración de activos de aplicación personalizada de tenant único (OAuth - BYOA)

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "",
    "Environment": "Default",
    "Mode": "interactive",
    "OAuth2AppData": {
        "ApplicationId": "your unique Microsoft tenant ID",
        "TenantId": "your unique Microsoft 365 tenant ID"
    }
}

Configuración de activos de ID de aplicación y aplicación personalizada secreta (OAuth - BYOA)

{
    "CertificateAsBase64": "",
    "CertificatePassword": "",
    "ClientSecret": "your unique Microsoft 365 application secret",
    "Environment": "Default",
    "Mode": "appidsecret",
    "OAuth2AppData": {
        "ApplicationId": "your unique Microsoft tenant ID",
        "TenantId": "your unique Microsoft 365 tenant ID"
    }
}

Limitaciones

Las siguientes características no están disponibles cuando se utilizan actividades dentro del ámbito de Microsoft 365: desencadenadores, vinculaciones y experiencia de anulación.

Actualización del token

No hay ningún servicio disponible para actualizar tus tokens de conexión, como el que está disponible en Integration Service.

Si el token de autorización no se actualiza durante un número determinado de días, caduca y debes volver a autenticarte. Para evitar la caducidad de los tokens de autorización, ejecuta un robot con esa conexión específica. Ejecutar una automatización con la actividad Ámbito actualiza el token de autorización.

Recursos adicionales de OAuth 2.0:

• Con flujo de aprobación de administrador: flujo de credenciales de cliente OAuth 2.0 en la plataforma de identidad de Microsoft
• Sin flujo de aprobación del administrador: plataforma de identidad de Microsoft y flujo de código de autorización OAuth 2.0: plataforma de identidad de Microsoft