Saltar al contenido

Requisitos previos del conector de Microsoft Dynamics 365 Business Central v2

Introducción

Como la conexión de Microsoft Dynamics 365 Business Central v2 será una aplicación que interactúa con Microsoft, deberá registrar una aplicación utilizando Microsoft Entra ID con un conjunto específico de permisos.

Pasos para el registro de la aplicación de Microsoft Azure

Siga estos pasos para crear un registro de aplicación con la plataforma de identidad de Microsoft:

  1. En el portal de Azure, busque y haga clic en Microsoft Entra ID (anteriormente conocido como Azure Active Directory o Azure AD):

    Requisitos previos de Microsoft Dynamics 365 Business Central 1

  2. En la barra lateral izquierda, bajo Administrar, haga clic en Registros de aplicaciones.

  3. Haga clic en Nuevo registro:

    Requisitos previos de Microsoft Dynamics 365 Business Central 2

  4. Ingrese un Nombre para su aplicación. Este nombre para mostrar será visible para los usuarios:

    Requisitos previos de Microsoft Dynamics 365 Business Central 3

  5. Haga clic en Registrarse para completar el registro de la aplicación. A continuación, se lo dirigirá a la página Descripción general de la aplicación:

    Requisitos previos de Microsoft Dynamics 365 Business Central 4

    Importante

    Conserve el ID de aplicación (cliente) y el ID de directorio (inquilino) del registro de la aplicación para usarlos como client_id y tenant_id al configurar una conexión.

  6. Haga clic en Agregar un certificado o secreto.

  7. En la pestaña Secretos de cliente, haga clic en Nuevo secreto de cliente para abrir el panel Agregar un secreto de cliente. En este panel, ingrese una descripción y seleccione una fecha de vencimiento para el secreto de cliente. Luego, configúrelo y haga clic en Agregar:

    Requisitos previos de Microsoft Dynamics 365 Business Central 5

  8. El secreto del cliente ahora está visible en la pestaña Secretos del cliente. Consérvelo si desea configurar una conexión utilizando el tipo de concesión Credenciales del cliente.

Agregar los permisos necesarios al registro de la aplicación

El registro de su aplicación debe tener un conjunto específico de permisos.

En el portal de Azure, navegue hasta el registro de su aplicación y haga clic en Permisos de API en la barra lateral izquierda:

Requisitos previos de Microsoft Dynamics 365 Business Central 7

Importante

Dependiendo de la configuración de seguridad de su organización de Azure, algunos permisos requerirán el consentimiento del administrador para permitirlos.

Estos son los permisos que necesitarás configurar:

Permisos de la aplicación Dynamics 365 Business Central

Para agregar permisos a la aplicación Dynamics 365 Business Central, siga estos pasos:

  1. En la página Permisos de API, haga clic en Agregar un permiso.

  2. En el panel Solicitar permisos de API, haga clic en la pestaña APIs que usa mi organización, busque y haga clic en Dynamics 365 Business Central:

  3. Haga clic en Permisos de la aplicación.

  4. Habilite los permisos AdminCenter.ReadWrite.All, API.ReadWrite.All, app_access y Automation.ReadWrite.All.

  5. Haga clic en Agregar permisos. Se mostrará la página Permisos configurados del registro de la aplicación actualizada.

Permisos delegados de Dynamics 365 Business Central

  1. En la página Permisos de API, haga clic en Agregar un permiso.

  2. En el panel Solicitar permisos de API, haga clic en la pestaña APIs que usa mi organización, busque y haga clic en Dynamics 365 Business Central:

  3. Haga clic en Permisos de la aplicación.

  4. Habilite los permisos Financials.ReadWrite.All y user_impersonation.

  5. Haga clic en Agregar permisos. Se mostrará la página Permisos configurados del registro de la aplicación actualizada.

Permisos delegados de Microsoft Graph

  1. En la página Permisos de API, haga clic en Agregar un permiso.

  2. En el panel Solicitar permisos de API, haga clic en la pestaña APIs que usa mi organización, busque y haga clic en Microsoft Graph:

    Requisitos previos de Microsoft Dynamics 365 Business Central 9

  3. Haga clic en Permisos de la aplicación.

  4. Habilite los permisos Financials.ReadWrite.All y user_impersonation.

  5. Haga clic en Agregar permisos. Se mostrará la página Permisos configurados del registro de la aplicación actualizada.

La siguiente tabla resume el conjunto mínimo de permisos requeridos.

Nombre de API/permiso Tipo Descripción Se requiere consentimiento del administrador
AdminCenter.ReadWrite.All Aplicación Acceso completo a la API del Centro de administración Sí
API.ReadWrite.All Aplicación Acceso completo a la API de servicios web Sí
app_access Aplicación Acceso según los permisos de la aplicación en Dynamics 365 Business Central Sí
Automation.ReadWrite.All Aplicación Acceso completo a la automatización Sí
Financials.ReadWrite.All Delegado Acceder a Dynamics 365 Business Central como el usuario que inició sesión No
user_impersonation Delegado Acceso como el usuario que inició sesión No
Usuario.Lectura Delegado Iniciar sesión y leer perfil de usuario No

Una vez que hayas agregado estos permisos, haz clic en Otorgar consentimiento de administrador para completar el registro. Una vez completado, cada permiso debe tener una marca de verificación verde.

A continuación, debe enlace su aplicación a Dynamics 365 Business Central. Siga estos pasos:

  1. Acceda a la siguiente URL, realizando las sustituciones necesarias: https://businesscentral.dynamics.com/{tenant_id}/{env}

  2. Iniciar sesión.

  3. En Buscar en Azure Active Directory, haga clic en Nuevo. Agregue la aplicación client_id y añadir una descripción (obligatorio).

  4. En Grupos de usuarios, utilice el menú desplegable para seleccionar el permiso que desea otorgar. Jitterbit recomienda ACCESO COMPLETO A D365 BUS, pero el mínimo aceptable es D365 COMPANY HUB.

Publicar objetos como servicios web {: #publish-objects-as-web-services }Los objetos de Business Central deben publicarse como servicios web para poder acceder a ellos a través del conector. Para lograr esto, siga los pasos que se describen en la documentación de Microsoft.