Saltar al contenido

Guía de Conexión de Microsoft Dynamics CRM

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 Microsoft Dynamics CRM

Navegador Web del Cliente

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Edge: 84+

Instrucciones de Conexión

Prerrequisitos

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

  • Verifique que tenga una cuenta de Dynamics CRM activa

  • 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 el estándar para Dynamics CRM es OAuth 2.0. Configuraremos el flujo OAuth mediante Microsoft Azure.

  1. Navegue hasta el portal del centro de administración de Azure Active Directory.

  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

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

Agregar una URL 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 Azure Active Directory

  2. Haga clic en Agregar una URL de redireccionamiento para ingresar 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 que se cree un registro de secreto de cliente para cada aplicación. App Builder ambiente en el que se utiliza la conexión. Si su App Builder la configuración tiene un ambiente de desarrollo, control de calidad y producción, necesitará 3 registros secretos de cliente correspondientes.

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

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

  1. Navegue hasta la aplicación registrada en Azure Active Directory

  2. En Administrar, seleccione Certificados y secretos

  3. Haga clic en Nuevo secreto de cliente

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

  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 en función de cómo desea integrarla con App Builder.

  1. Navegue hasta la aplicación registrada en Azure Active Directory

  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 un contexto de usuario, seleccione Permisos de aplicación (OAuthGrantType=Client). De lo contrario, utilice 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) de 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 App Builder IDE

  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 identificación del 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 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;