Ir para o conteúdo

Guia de Conexão do Microsoft Dynamics CRM

Visão Geral

Este guia descreve os requisitos do sistema e as instruções para conectar App Builder para o Microsoft Dynamics CRM.

Requisitos do Sistema

Conta Ativa

  • Microsoft Dynamics CRM

Navegador da Web do Cliente

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Borda: 84+

Instruções de Conexão

Pré-requisitos

Antes de configurar uma conexão de App Builder para o Microsoft Dynamics CRM, você deve executar as seguintes etapas:

  • Verifique se você tem uma conta ativa do Dynamics CRM

  • Verifique se você pode fazer logon em uma conta ativa do Azure com permissão para configurar conexões

Registre um Aplicativo no Microsoft Azure

O método usado para autenticar de App Builder para o Dynamics CRM é OAuth 2.0. Configuraremos o fluxo OAuth usando o Microsoft Azure.

  1. Navegue até o portal do centro de administração do Azure Active Directory

  2. Em Gerenciar, selecione Registros de aplicativos > Novo registro

  3. Forneça um Nome. Por exemplo: App Builder dynamics CRM

  4. Selecione quem pode usar o aplicativo

  5. Clique em Registrar

Quando o registro for concluído, o portal do Azure exibirá o registro do aplicativo na tela Visão geral. Observe o valor em ID do aplicativo (cliente) como OAuthClientID e o ID do diretório (locatário) como AzureTenantID.

Adicionar um URI de Redirecionamento

O URL de redirecionamento representa o local para onde a Microsoft redirecionará o cliente do usuário e passará

os tokens de segurança após a autenticação.

  1. Navegue até o aplicativo registrado no Azure Active Directory

  2. Clique em Adicionar um URI de redirecionamento para inserir o valor. Por exemplo: http://localhost/auth-response

Adicionar um Segredo do Cliente

Os segredos do cliente também são chamados de senha do aplicativo. O aplicativo registrado no Microsoft Azure requer que um registro de segredo do cliente seja criado para cada App Builder ambiente em que a conexão está sendo usada. Se o seu App Builder a configuração tem um ambiente de desenvolvimento, controle de qualidade e produção; você precisará de 3 registros secretos de cliente correspondentes.

Os segredos do cliente têm uma data de expiração associada e o período máximo que podem ser definidos é de 2 anos.

Gerar um registro de segredo de cliente fornece a você um Valor de segredo de cliente e um ID de segredo. O Valor é codificado e só está disponível para cópia e uso uma vez (caso contrário, um novo token precisaria ser gerado para capturar um novo Valor).

  1. Navegue até o aplicativo registrado no Azure Active Directory

  2. Em Gerenciar, selecione Certificados e segredos

  3. Clique em Novo segredo do cliente

  4. Forneça uma Descrição. Por exemplo: App Builder produção

  5. Selecione um valor Expires. Por exemplo: 730 dias (24 meses)

  6. Clique em Add

  7. Observe o Value, pois ele será codificado. Você precisará dele como OAuthClientSecret

Atribuir Permissões de API

O aplicativo registrado no Microsoft Azure precisa de permissões atribuídas ao Dynamics CRM. Isso deve ser configurado com base em como você deseja integrá-lo com App Builder.

  1. Navegue até o aplicativo registrado no Azure Active Directory

  2. Em Gerenciar, selecione Permissões de API

  3. Clique em Adicionar uma permissão

  4. Clique em Dynamics ERP

  5. Se você planeja que seu aplicativo se conecte sem um contexto de usuário, selecione Application Permissions (OAuthGrantType=Client). Caso contrário, use Delegated Permissions (OAuthGrantType=Code)

  6. Clique em Adicionar uma permissão e defina as permissões de acordo com os requisitos do seu negócio

Para obter mais detalhes, consulte Início rápido: registrar um aplicativo na plataforma de identidade da Microsoft

Para esta etapa de configuração, você deve ter o valor do ID do aplicativo (cliente) para o aplicativo registrado acima copiado em algum lugar fácil de usar, como sua área de transferência.

  1. Navegue até o Dynamics CRM

  2. Crie um usuário do aplicativo

  3. Insira o valor Client ID do aplicativo registrado. Este é o valor Application (client) ID no Microsoft Azure.

  4. Atribua uma papel ao novo usuário

Adicionando um Servidor

  1. Navegue até App Builder IDE

  2. No menu Conectar, clique no botão Servidores de Dados

  3. Clique no botão + Server no painel Data Servers. Isso abrirá a página Server. Forneça as seguintes informações:

    • Nome do servidor: Um nome de servidor identificável e exclusivo. Por exemplo: Dynamics CRM

    • Tipo: Selecione Dynamics CRM no menu suspenso

    • Url: Insira a URL para acessar o Dynamics CRM, deve começar com http:// ou https://

  4. Clique no botão Salvar

    anexo

  5. Clique no botão Configurações avançadas.

  6. Forneça as seguintes informações e os valores correspondentes no campo Avançado, separando cada valor com ponto e vírgula:

    1. AzureTenant – Valor do ID do locatário para o serviço do Azure

    2. InitiateOAuth – propriedade para iniciar o processo para obter/atualizar o token de acesso OAuth na conexão. Por exemplo: GETANDREFRESH

    3. OAuthClientID – Valor de ID atribuído quando o aplicativo é registrado no servidor OAuth

    4. OAuthClientSecret – valor atribuído quando o aplicativo é registrado no servidor OAuth

    5. OAuthGrantType – tipo de concessão para o fluxo OAuth. Por exemplo: CLIENT

    6. OAuthSettingsLocation – local do arquivo de configurações onde os valores OAuth serão salvos. Por exemplo: C:\inetpub\wwwroot\App Builder\App_Data\CData\DynamicsCRM;

Exemplo de configurações avançadas:

AzureTenant=<TenantID>;
InitiateOAuth=GETANDREFRESH;
OAuthClientId=<ClientID>;
OAuthClientSecret=<ClientSecret>;
OAuthGrantType=CLIENT;
OAuthSettingsLocation=C:\inetpub\wwwroot\App Builder\App_Data\CData\DynamicsCRM;