Ir para o conteúdo

Guia de conexão do Microsoft Dynamics CRM para Jitterbit App Builder

Visão geral

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

Requisitos do sistema

Conta ativa

  • Microsoft Dynamics CRM

Navegador da web do cliente

  • Chrome: 84+

  • Firefox: 73+

  • Safari: 13.0.1+

  • Edge: 84+

Instruções de conexão

Pré-requisitos

Antes de configurar uma conexão do App Builder para o Microsoft Dynamics CRM, você deve realizar os seguintes passos:

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

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

Registrar um aplicativo no Microsoft Azure

O método usado para autenticar do App Builder para o Dynamics CRM é OAuth 2.0. Vamos configurar o fluxo OAuth usando o Microsoft Azure.

  1. Navegue até o portal do centro de administração do Microsoft Entra ID

  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 estiver completo, o portal do Azure exibirá o registro do aplicativo na tela de Visão geral. Anote o valor em ID do aplicativo (cliente) como OAuthClientID e o ID do diretório (locatário) como AzureTenantID.

Adicionar uma URI de redirecionamento

A URL de redirecionamento representa o local 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 Microsoft Entra ID

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

Adicionar um segredo do cliente

Segredos do cliente também são referidos como uma senha de aplicativo. O aplicativo registrado no Microsoft Azure requer que um registro de segredo do cliente seja criado para cada ambiente do App Builder em que a conexão está sendo usada. Se sua configuração do App Builder tiver um ambiente de desenvolvimento, QA e Produção, você precisará de 3 registros de segredo do cliente correspondentes.

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

Gerar um registro de segredo do cliente fornece um Valor e um ID do Segredo. O Valor é codificado e só pode ser copiado e usado uma vez (caso contrário, um novo token precisaria ser gerado para capturar um novo Valor).

  1. Navegue até o aplicativo registrado no Microsoft Entra ID

  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 de Expira. Por exemplo: 730 dias (24 meses)

  6. Clique em Adicionar

  7. Anote o Valor, 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 ao App Builder.

  1. Navegue até o aplicativo registrado no Microsoft Entra ID

  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 Permissões de Aplicativo (OAuthGrantType=Client). Caso contrário, use Permissões Delegadas (OAuthGrantType=Code)

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

Para mais detalhes, veja Introdução: Registrar um aplicativo com a plataforma de identidade da Microsoft

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

  1. Navegue até o Dynamics CRM

  2. Crie um Usuário de Aplicativo

  3. Insira o valor do ID do Cliente do aplicativo registrado. Este é o valor do ID do Aplicativo (cliente) no Microsoft Azure.

  4. Atribua um papel ao novo usuário

Adicionando um servidor

  1. Navegue até o App Builder IDE

  2. No menu Conectar, clique no botão Data Servers

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

    • Nome do Servidor: Um nome de servidor identificável e único. 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 Save

    attachment

  5. Clique no botão Advanced Settings.

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

    1. AzureTenant – Valor do Id do Tenant para o serviço Azure

    2. InitiateOAuth – propriedade para iniciar o processo de obtenção/atualização do token de acesso OAuth na conexão. Por exemplo: GETANDREFRESH

    3. OAuthClientID – Valor do 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;

Solução de Problemas

Se você enfrentar problemas com o Microsoft Dynamics CRM, estas etapas de solução de problemas são recomendadas:

  1. Ative o registro de dados para gerar arquivos de log e dados, que você pode baixar e inspecionar.

  2. Consulte a documentação do CData ADO.NET Provider para Microsoft Dynamics CRM para informações detalhadas.