Ir para o conteúdo

Pré-requisitos para o conector Microsoft Dynamics 365 Business Central v2 no Jitterbit Studio

Introdução

Como a conexão Microsoft Dynamics 365 Business Central v2 será um aplicativo que se comunica com a Microsoft, você precisará registrar um aplicativo usando o Microsoft Entra ID com um conjunto específico de permissões.

Passos para registro de aplicativo no Microsoft Azure

Siga estes passos para criar um registro de aplicativo na plataforma de identidade da Microsoft:

  1. No portal do Azure, pesquise e clique em Microsoft Entra ID (anteriormente conhecido como Azure Active Directory ou Azure AD):

    Microsoft Dynamics 365 Business Central prerequisites 1

  2. No menu à esquerda, sob Gerenciar, clique em Registros de aplicativos.

  3. Clique em Novo registro:

    Microsoft Dynamics 365 Business Central prerequisites 2

  4. Insira um Nome para seu aplicativo. Este nome de exibição será visível para os usuários:

    Microsoft Dynamics 365 Business Central prerequisites 3

  5. Clique em Registrar para concluir o registro do aplicativo. Você será direcionado para a página de Visão geral do aplicativo:

    Microsoft Dynamics 365 Business Central prerequisites 4

    Importante

    Mantenha o ID do aplicativo (cliente) e o ID do diretório (inquilino) do registro do aplicativo para usar como client_id e tenant_id ao configurar uma conexão.

  6. Clique em Adicionar um certificado ou segredo.

  7. Na guia Segredos do cliente, clique em Novo segredo do cliente para abrir o painel Adicionar um segredo do cliente. Neste painel, insira uma descrição e selecione uma data de expiração para o segredo do cliente, em seguida, clique em Adicionar:

    Microsoft Dynamics 365 Business Central prerequisites 5

  8. O segredo do cliente agora está visível na guia Segredos do cliente. Mantenha-o se desejar configurar uma conexão usando o tipo de concessão Credenciais do Cliente.

Adicionar permissões necessárias ao registro do aplicativo

Seu registro de aplicativo deve ter um conjunto específico de permissões.

No portal do Azure, navegue até seu registro de aplicativo e clique em Permissões de API na barra lateral esquerda:

Microsoft Dynamics 365 Business Central prerequisites 7

Importante

Dependendo das configurações de segurança da sua organização no Azure, algumas permissões exigirão consentimento do administrador para serem permitidas.

Estas são as permissões que você precisará definir:

Permissões de aplicativo do Dynamics 365 Business Central

Para adicionar permissões de aplicativo do Dynamics 365 Business Central, siga estas etapas:

  1. Na página Permissões de API, clique em Adicionar uma permissão.

  2. No painel Solicitar permissões de API, clique na guia APIs que minha organização usa, pesquise e clique em Dynamics 365 Business Central:

  3. Clique em Permissões de aplicativo.

  4. Ative as permissões AdminCenter.ReadWrite.All, API.ReadWrite.All, app_access e Automation.ReadWrite.All.

  5. Clique em Adicionar permissões. A página Permissões configuradas do registro de aplicativo atualizado é exibida.

Permissões delegadas do Dynamics 365 Business Central

  1. Na página de Permissões da API, clique em Adicionar uma permissão.

  2. No painel de Solicitar permissões da API, clique na guia APIs que minha organização usa, pesquise e clique em Dynamics 365 Business Central:

  3. Clique em Permissões de aplicativo.

  4. Ative as permissões Financials.ReadWrite.All e user_impersonation.

  5. Clique em Adicionar permissões. A página de Permissões configuradas do registro do aplicativo atualizado é exibida.

Permissões delegadas do Microsoft Graph

  1. Na página de Permissões da API, clique em Adicionar uma permissão.

  2. No painel de Solicitar permissões da API, clique na guia APIs que minha organização usa, pesquise e clique em Microsoft Graph:

    Microsoft Dynamics 365 Business Central prerequisites 9

  3. Clique em Permissões de aplicativo.

  4. Ative as permissões Financials.ReadWrite.All e user_impersonation.

  5. Clique em Adicionar permissões. A página de Permissões configuradas do registro do aplicativo atualizado é exibida.

A tabela a seguir resume o conjunto mínimo de permissões necessárias.

Nome da API/Permissão Tipo Descrição Consentimento do Admin Necessário
AdminCenter.ReadWrite.All Aplicativo Acesso total à API do Centro de Administração Sim
API.ReadWrite.All Aplicativo Acesso total à API de serviços web Sim
app_access Aplicativo Acesso de acordo com as permissões do aplicativo no Dynamics 365 Business Central Sim
Automation.ReadWrite.All Aplicativo Acesso total à automação Sim
Financials.ReadWrite.All Delegada Acesso ao Dynamics 365 Business Central como o usuário conectado Não
user_impersonation Delegada Acesso como o usuário conectado Não
User.Read Delegada Fazer login e ler o perfil do usuário Não

Uma vez que você tenha adicionado essas permissões, clique em Conceder consentimento de administrador para completar o registro. Uma vez concluído, cada permissão deve ter uma marca de verificação verde.

Em seguida, você precisa vincular seu aplicativo ao Dynamics 365 Business Central. Siga estas etapas:

  1. Acesse a seguinte URL, fazendo as substituições necessárias: https://businesscentral.dynamics.com/{tenant_id}/{env}

  2. Faça login.

  3. Em Pesquisar Microsoft Entra ID, clique em Novo. Adicione o client_id do seu aplicativo e adicione uma descrição (obrigatório).

  4. Em Grupos de Usuários, use o menu suspenso para selecionar a permissão que deseja conceder. O Jitterbit recomenda D365 BUS FULL ACCESS, mas o mínimo aceitável é D365 COMPANY HUB.

Publicar objetos como serviços da web

Os objetos do Business Central devem ser publicados como Serviços da Web para serem acessíveis via o conector. Para fazer isso, siga as etapas descritas na documentação da Microsoft.