Ir para o conteúdo

Pré-requisitos do conector do Microsoft Dynamics 365 Business Central v2

Introdução

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

Etapas de registro do aplicativo Microsoft Azure

Siga estas etapas para criar um registro de aplicativo com a 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):

    Pré-requisitos do Microsoft Dynamics 365 Business Central 1

  2. Na barra lateral esquerda, em Gerenciar, clique em Registros de aplicativos.

  3. Clique em Novo registro:

    Pré-requisitos do Microsoft Dynamics 365 Business Central 2

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

    Pré-requisitos do Microsoft Dynamics 365 Business Central 3

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

    Pré-requisitos do Microsoft Dynamics 365 Business Central 4

    Importante

    Mantenha o ID do aplicativo (cliente) e o ID do diretório (locatário) 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 aba 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, depois defina, clique em Adicionar:

    Pré-requisitos do Microsoft Dynamics 365 Business Central 5

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

Adicione as permissões necessárias ao registro do aplicativo

O registro do seu aplicativo deve ter um conjunto específico de permissões.

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

Pré-requisitos do Microsoft Dynamics 365 Business Central 7

Importante

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

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

Permissões do aplicativo Dynamics 365 Business Central

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

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

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

  3. Clique em Permissões do aplicativo.

  4. Habilite 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 do aplicativo atualizado é exibida.

Permissões delegadas do Dynamics 365 Business Central

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

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

  3. Clique em Permissões do aplicativo.

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

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

Permissões delegadas do Microsoft Graph

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

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

    Pré-requisitos do Microsoft Dynamics 365 Business Central 9

  3. Clique em Permissões do aplicativo.

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

  5. Clique em Adicionar permissões. A página 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 administrador necessário
AdminCenter.ReadWrite.All Aplicativo Acesso total à API do Admin Center 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 Delegado Acesse o Dynamics 365 Business Central como o usuário conectado Não
user_impersonation Delegado Acesso como usuário conectado Não
User.Read Delegado Entre e leia o perfil do usuário Não

Depois de adicionar essas permissões, clique em Conceder consentimento administrativo para concluir o registro. Depois de concluído, cada permissão deve ter uma marca de seleçã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. Efetue login.

  3. Em Pesquisar Azure Active Directory, clique em Novo. Adicione o nome do seu aplicativo client_id 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 web

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