Autenticación de Microsoft Dynamics 365 CRM

UiPath Integration Service permite la conectividad segura a tu instancia de Microsoft Dynamics 365 CRM utilizando la autenticación basada en OAuth 2.0. Una vez autenticado, puedes crear una conexión que permita el acceso a nivel de API a los datos de Dynamics 365 CRM para los flujos de trabajo de automatización.

Añadir una conexión a Microsoft Dynamics 365 CRM permite que los productos de UiPath interactúen con tus datos de CRM, lo que incluye leer, escribir, modificar y eliminar registros, dependiendo de los permisos del usuario autenticado en Dynamics 365 CRM.

Tipos de autenticación compatibles

Al crear una conexión de Dynamics 365 CRM, puedes elegir entre dos tipos de autenticación:

• Código de autorización OAuth 2.0 (predeterminado y recomendado)
• Traiga su propia aplicación OAuth 2.0 (registro de aplicaciones personalizado)

Código de autorización OAuth 2.0

Este es el método de autenticación más sencillo. Esta opción utiliza la aplicación Azure AD administrada de UiPath para gestionar el inicio de sesión del usuario y la adquisición de tokens.

1. En la pantalla de creación de conexión, selecciona Código de autorización OAuth 2.0.

2. Introduzca la URL del tenant (https://<yourorg>.crm.dynamics.com)

   Nota:

   El valor de la URL del tenant debe ser exactamente su dominio base de Dynamics 365 CRM.

3. Haz clic en Conectar.

4. Se te redirigirá a las pantallas de inicio de sesión y consentimiento de Microsoft para autenticarte.

   Este método no requiere configuración adicional en Azure AD y es adecuado para la mayoría de los usuarios.

Traiga su propia aplicación OAuth 2.0

Utiliza esta opción si tu organización requiere un control centralizado sobre los registros, ámbitos o políticas de cumplimiento de las aplicaciones de Azure AD.

Al seleccionar Traer tu propia aplicación OAuth 2.0 en la pantalla de conexión, debes proporcionar los siguientes detalles:

• ID de cliente
• Secreto de cliente
• URL del inquilino

Importante:

El URI de devolución de llamada/redireccionamiento https://{baseURL}/provisioning_/callback (por ejemplo https://cloud.uipath.com/provisioning_/callback) debe añadirse exactamente como se muestra en la pantalla de conexión a la configuración de registro de tu aplicación de Azure AD en URI de redirección con el tipo Web .

Esta URL de devolución de llamada está preconfigurada por UiPath y no se puede modificar en la interfaz de usuario de Integration Service.

Cuándo utilizar una aplicación personalizada

Utiliza esta opción si:

• Su organización requiere registros de aplicaciones de Azure AD gestionados por el administrador.
• Quieres un control detallado sobre los permisos y ámbitos de la aplicación.
• Debes seguir las políticas de seguridad internas para las aplicaciones OAuth.

Nota:

• Es posible que se requiera el consentimiento del administrador en su tenant para los permisos de la aplicación que solicita.
• La aplicación personalizada debe configurarse con Permisos delegados para Dynamics CRM.

Explicación de los campos obligatorios

Campo	Descripción
ID de cliente	El ID de la aplicación de Azure AD (solo es necesario si utilizas tu propia aplicación).
Secreto de cliente	El secreto que generaste para tu aplicación de Azure AD (obligatorio para la aplicación personalizada).
URL del inquilino	La URL de su instancia de Dynamics 365 CRM (para ambas opciones).
URL de devolución de llamada	Valor rellenado previamente que se muestra al utilizar una aplicación personalizada; debes registrar esta URL en Azure AD.

Recuperar sus credenciales

Para encontrar tu URL de tenant, ponte en contacto con tu administrador de Microsoft Dynamics.

En caso de que tengas acceso y utilices un tenant global único, sigue estos pasos:

1. Ve a https://portal.azure.com.

2. Selecciona Azure Active Directory.

3. Ve a Propiedades en la sección Administrar .

4. Tu tenant es el ID de tenant, por ejemplo: sample083151e4.api.crm10.dynamics.com.

   Nota:

   Any mistake in the Tenant URL prevents you from authenticating and creating a connection.

Si quieres crear tu propia aplicación OAuth 2.0 privada, sigue los pasos descritos en la documentación de Microsoft Dynamics 365:

• Inicio rápido: registrar una aplicación con la plataforma de identidad de Microsoft
• Tutorial: registrar una aplicación con Microsoft Entra ID

Permisos y consentimiento

Para funcionar correctamente, la conexión de Dynamics 365 CRM requiere los siguientes ámbitos OAuth:

• user_impersonation
• offline_access
• User.Read

Puedes utilizar la conexión para habilitar las actividades de Microsoft Dynamics 365 CRM en UiPath Studio para crear automatizaciones para gestionar cuentas, clientes potenciales, oportunidades, incidentes y otras capacidades de CRM. Los diversos casos de uso basados en permisos que se pueden lograr son los siguientes:

Ámbito/Permiso	Use case	Actividad/Evento
user_impersonation (obligatorio)	El ámbito user_impersonation es necesario para solicitar en tu flujo de autenticación que funcione con la API de administración de Azure. La suplantación se utiliza para ejecutar la lógica empresarial (código) en nombre de otro usuario de Microsoft Dataverse para proporcionar una característica o servicio deseado utilizando el rol adecuado y la seguridad basada en objetos de ese usuario suplantado. Esto es necesario porque los servicios web de Dataverse pueden ser llamados por varios clientes y servicios en nombre de un usuario de Dataverse, por ejemplo, en un flujo de trabajo o en una solución ISV personalizada.	N/D
offline_access (obligatorio)	Se requiere offline_access para recibir el token de actualización en el punto final de la solicitud de autenticación. Cuando canjeas un código de autorización en el flujo de código de autorización OAuth 2.0 sin ámbitooffline_access , no recibirás el token de actualización desde el punto final /token .	N/D
User.Read (obligatorio)	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.	N/D

Es posible que se requiera el consentimiento del administrador en función de las políticas corporativas de Azure AD.

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 Dynamics 365

1. Selecciona Integration Service en la barra izquierda.
2. En la lista Conectores , selecciona Microsoft Dynamics 365 CRM. También puedes utilizar la barra de búsqueda para acotar el conector.
3. Selecciona Conectar a Microsoft Dynamics 365 CRM.
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 Microsoft Dynamics 365, consulta la documentación de Microsoft Dynamics 365.

Solución de problemas de configuración comunes

• URI de redirección no válida : asegúrate de que tu aplicación Azure AD tenga exactamente la URL de devolución de llamada https://{baseURL}/provisioning_/callback (por ejemplo https://cloud.uipath.com/provisioning_/callback) registrada en las URI de redirección.
• Permisos no concedidos : es posible que se requiera el consentimiento del administrador para los ámbitos de Dynamics CRM.
• URL de tenant incorrecta : comprueba que estás utilizando la URL base de CRM exacta de tu organización.
• Problemas de token de actualización/consentimiento : pueden provocar conexiones fallidas si la configuración de Azure AD cambia después del consentimiento inicial.