Saltar al contenido

Guía de conexión de Microsoft Dynamics CRM para Jitterbit App Builder

Descripción general

Esta guía describe los requisitos del sistema e instrucciones para conectar App Builder a Microsoft Dynamics CRM.

Requisitos del sistema

Cuenta activa

  • Microsoft Dynamics CRM

Navegador web del cliente

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Edge: 84+

Instrucciones de conexión

Requisitos previos

Antes de configurar una conexión desde App Builder a Microsoft Dynamics CRM, se deben realizar los siguientes pasos:

  • Verificar que se tiene una cuenta activa de Dynamics CRM

  • Verificar que se puede iniciar sesión en una cuenta activa de Azure con permiso para configurar conexiones

Registrar una aplicación en Microsoft Azure

El método utilizado para autenticar desde App Builder a Dynamics CRM es OAuth 2.0. Configuraremos el flujo de OAuth utilizando Microsoft Azure.

  1. Navegar al portal del centro de administración de Microsoft Entra ID

  2. En Administrar, seleccionar Registros de aplicaciones > Nuevo registro

  3. Proporcionar un Nombre. Por ejemplo: App Builder Dynamics CRM

  4. Seleccionar quién puede usar la aplicación

  5. Hacer clic en Registrar

Cuando se complete el registro, el portal de Azure mostrará el registro de la aplicación en la pantalla de Descripción general. Anote el valor en ID de aplicación (cliente) como OAuthClientID y el ID de directorio (inquilino) como AzureTenantID.

Agregar una URI de redirección

La URL de redirección representa la ubicación a la que Microsoft redirigirá el cliente del usuario y pasará

los tokens de seguridad después de la autenticación.

  1. Navegar a la aplicación registrada en Microsoft Entra ID

  2. Hacer clic en Agregar una URI de redirección para ingresar el valor. Por ejemplo: http://localhost/auth-response

Agregar un secreto de cliente

Los secretos de cliente también se conocen como una contraseña de aplicación. La aplicación registrada en Microsoft Azure requiere que se cree un registro de secreto de cliente para cada entorno de App Builder en el que se esté utilizando la conexión. Si su configuración de App Builder tiene un entorno de desarrollo, QA y producción, necesitará 3 registros de secreto de cliente correspondientes.

Los secretos del cliente tienen una fecha de expiración asociada, y la duración máxima para la que se pueden establecer es de 2 años.

Generar un registro de secreto del cliente proporciona un Valor y un ID de Secreto. El Valor está codificado y solo está disponible para copiar y usar una vez (de lo contrario, se necesitaría generar un nuevo token para capturar un nuevo Valor).

  1. Navega a la aplicación registrada en Microsoft Entra ID

  2. En Administrar, selecciona Certificados y secretos

  3. Haz clic en Nuevo secreto de cliente

  4. Proporciona una Descripción. Por ejemplo: App Builder Producción

  5. Selecciona un valor de Expira. Por ejemplo: 730 días (24 meses)

  6. Haz clic en Agregar

  7. Toma nota del Valor ya que se codificará. Lo necesitarás como OAuthClientSecret

Asignar permisos de API

La aplicación registrada en Microsoft Azure necesita permisos asignados a Dynamics CRM. Esto debe configurarse según cómo desees integrarlo con App Builder.

  1. Navega a la aplicación registrada en Microsoft Entra ID

  2. En Administrar, selecciona Permisos de API

  3. Haz clic en Agregar un permiso

  4. Haz clic en Dynamics ERP

  5. Si planeas que tu aplicación se conecte sin un contexto de usuario, selecciona Permisos de Aplicación (OAuthGrantType=Client). De lo contrario, utiliza Permisos Delegados (OAuthGrantType=Code)

  6. Haz clic en Agregar un permiso y define los permisos según los requisitos de tu negocio

Para más detalles, consulta Guía rápida: Registrar una aplicación con la plataforma de identidad de Microsoft

Para este paso de configuración, debes tener el valor de ID de Aplicación (cliente) de la aplicación registrada anteriormente copiado en un lugar accesible, como tu portapapeles.

  1. Navega a Dynamics CRM

  2. Crea un Usuario de Aplicación

  3. Ingresa el valor de ID de Cliente de la aplicación registrada. Este es el valor de ID de Aplicación (cliente) en Microsoft Azure.

  4. Asigna un rol al nuevo usuario

Agregar un servidor

  1. Navega a la IDE de App Builder

  2. En el menú Conectar, haz clic en el botón Servidores de Datos

  3. Haz clic en el botón + Servidor en el panel de Servidores de Datos. Esto abrirá la página del Servidor. Proporciona la siguiente información:

    • Nombre del Servidor: Un nombre de servidor identificable y único. Por ejemplo: Dynamics CRM

    • Tipo: Selecciona Dynamics CRM del menú desplegable

    • Url: Ingresa la Url para acceder a Dynamics CRM, debe comenzar con http:// o https://

  4. Haz clic en el botón Guardar

    attachment

  5. Haz clic en el botón Configuración Avanzada.

  6. Proporciona la siguiente información y los valores correspondientes en el campo Avanzado, separando cada valor con un punto y coma:

    1. AzureTenant – Valor de Id de inquilino para el servicio de Azure

    2. InitiateOAuth – propiedad para iniciar el proceso de obtención/actualización del token de acceso OAuth en la conexión. Por ejemplo: GETANDREFRESH

    3. OAuthClientID – Valor de Id asignado cuando la aplicación está registrada con el servidor OAuth

    4. OAuthClientSecret – valor asignado cuando la aplicación está registrada con el servidor OAuth

    5. OAuthGrantType – tipo de concesión para el flujo OAuth. Por ejemplo: CLIENT

    6. OAuthSettingsLocation – ubicación del archivo de configuración donde se guardarán los valores de OAuth. Por ejemplo: C:\inetpub\wwwroot\App Builder\App_Data\CData\DynamicsCRM;

Ejemplo de Configuración Avanzada:

AzureTenant=<TenantID>;
InitiateOAuth=GETANDREFRESH;
OAuthClientId=<ClientID>;
OAuthClientSecret=<ClientSecret>;
OAuthGrantType=CLIENT;
OAuthSettingsLocation=C:\inetpub\wwwroot\App Builder\App_Data\CData\DynamicsCRM;

Solución de Problemas

Si experimentas problemas con Microsoft Dynamics CRM, se recomiendan los siguientes pasos de solución de problemas:

  1. Habilita el registro de datos para generar archivos de registro y datos, que puedes descargar e inspeccionar.

  2. Consulta la documentación del Proveedor ADO.NET de CData para Microsoft Dynamics CRM para obtener información detallada.