Como registar uma aplicação Microsoft Entra ID para a aplicação móvel Anvaigo

Quem deve ler este artigo?

Este artigo aplica-se apenas a instalações locais do Microsoft Business Central que utilizam o Microsoft Entra ID para autenticação.

Registar a aplicação

Na visão geral do Entra ID, abra os registos de aplicações e clique em Novo registo:

Escolha um nome para a nova aplicação:

A definição dos tipos de conta suportados pode ser deixada nas contas de valor pré-seleccionadas apenas neste diretório organizacional.

Adicionar um URI de redireccionamento do tipo web com o valor https://oauth.anvaigo.com/OAuth/Callback. 

Clique em Registar para criar a aplicação.

Copiar o ID do cliente

Será redireccionado para a página de resumo da nova aplicação. Na secção intitulada Essenciais, encontre o valor ID da aplicação (cliente). Copie e guarde este valor, uma vez que será necessário durante o processo de configuração do Anvaigo no Business Central.  

Adicione o endereço OAuth Landing do seu sistema Business Central

Seleccione Autenticação e adicione o endereço OAuthLanding do seu sistema Business Central como um segundo URI de redireccionamento da Web. 

Adicione o URI e clique em Guardar:

Adicionar um segredo de cliente

Seleccione Certificados e segredos e clique em Novo segredo de cliente

Introduza uma descrição para o novo segredo e seleccione o período de validade do segredo. Clique em Adicionar para criar o segredo.

Certifique-se de que copia e guarda o valor do segredo agora, uma vez que só será apresentado desta vez. Este valor também será utilizado no processo de configuração.

Tenha em atenção a data de expiração e certifique-se de que define lembretes para criar um novo segredo a tempo e actualizá-lo na página Anvaigo Service Setup no Business Central.

Adicionar permissões de API

Seleccione Permissões de API e clique em Adicionar uma permissão. 

Isto abrirá uma lista de APIs da Microsoft normalmente utilizadas. Clique em Dynamics 365 Business Central e depois em Permissões delegadas. Marque a caixa para user_impersonation.

Agora clique em Permissões de aplicação. Marque as caixas para app_access e API.ReadWrite.All. Clique em Adicionar permissões.

A aplicação está agora configurada. É possível utilizar o ID do cliente e o segredo do cliente para concluir o processo de configuração do Anvaigo no Business Central. 

Encontre mais informações sobre a Autenticação Service-to-Service (S2S) aqui.