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 y las 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+

  • Ventaja: 84+

Instrucciones de conexión

Prerrequisitos

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

  • Verifique que tenga una cuenta activa de Dynamics CRM

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

Registrar una aplicación en Microsoft Azure

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

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

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

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

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

  5. Haga clic en Registrarse

Una vez completado el registro, Azure Portal mostrará el registro de la aplicación en la pantalla Información general. Anote el valor en ID de aplicación (cliente) como OAuthClientID y el valor en ID de directorio (inquilino) como AzureTenantID.

Agregar una URI de redireccionamiento

La URL de redireccionamiento representa la ubicación donde Microsoft redirigirá al cliente del usuario y lo pasará

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

  1. Navegue hasta la aplicación registrada en Microsoft Entra ID

  2. Haga clic en Añadir una URL de redireccionamiento para introducir el valor. Por ejemplo: http://localhost/auth-response

Agregar un secreto de cliente

Los secretos de cliente también se conocen como contraseñas de aplicación. La aplicación registrada en Microsoft Azure requiere la creación de un registro de secreto de cliente para cada ambiente de App Builder en el que se utilice la conexión. Si su configuración de App Builder tiene un ambiente de desarrollo, control de calidad y producción, necesitará tres registros de secreto de cliente correspondientes.

Los secretos de cliente tienen una fecha de vencimiento asociada y la duración máxima que se puede establecer para ellos es de 2 años.

Al generar un registro de secreto de cliente, se obtiene un Valor y un ID de secreto. El Valor está codificado y solo se puede copiar y usar una vez (de lo contrario, se necesitaría generar un nuevo token para capturarlo).

  1. Navegue hasta la aplicación registrada en Microsoft Entra ID

  2. En Administrar, seleccione Certificados y secretos

  3. Haga clic en Nuevo secreto de cliente

  4. Proporcione una Descripción. Por ejemplo: App Builder Production

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

  6. Haga clic en Agregar

  7. Anote el Valor, ya que se codificará. Lo necesitará 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 se desee integrar con App Builder.

  1. Navegue hasta la aplicación registrada en Microsoft Entra ID

  2. En Administrar, seleccione Permisos de API

  3. Haga clic en Agregar un permiso

  4. Haga clic en Dynamics ERP

  5. Si planea que su aplicación se conecte sin contexto de usuario, seleccione Permisos de la aplicación (OAuthGrantType=Client). De lo contrario, use Permisos delegados (OAuthGrantType=Code).

  6. Haga clic en Agregar un permiso y defina los permisos según los requisitos de su negocio.

Para obtener más detalles, consulte Inicio rápido: Registrar una aplicación con la plataforma de identidad de Microsoft

Para este paso de configuración, debe tener el valor de ID de aplicación (cliente) para la aplicación registrada anteriormente copiado en algún lugar fácil de usar, como su portapapeles.

  1. Vaya a Dynamics CRM

  2. Crear un usuario de aplicación

  3. Ingrese 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. Asignar un rol al nuevo usuario

Agregar un servidor

  1. Navegue hasta el IDE de App Builder

  2. Desde el menú Conectar, haga clic en el botón Servidores de datos

  3. Haga clic en el botón + Servidor en el panel Servidores de datos. Se abrirá la página Servidor. Proporcione la siguiente información:

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

    • Tipo: Seleccione Dynamics CRM en el menú desplegable

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

  4. Haga clic en el botón Guardar

    archivo adjunto

  5. Haga clic en el botón Configuración avanzada.

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

    1. AzureTenant: valor de identificador de inquilino para el servicio de Azure

    2. InitiateOAuth: propiedad para iniciar el proceso de obtención/actualización del token de acceso OAuth al conectar. Por ejemplo: GETANDREFRESH

    3. OAuthClientID: valor de identificación asignado cuando la aplicación se registra con el servidor OAuth

    4. OAuthClientSecret: valor asignado cuando la aplicación se registra con el servidor OAuth

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

    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;