Configurar Microsoft Dynamics CRM spoke.

Configurar aplicação Microsoft Dynamics CRM

Crie uma aplicação OAuth personalizada a partir da sua conta Microsoft Dynamics CRM para habilitar a autenticação OAuth 2.0 com o Microsoft Dynamics CRM.

Antes de Iniciar

Requisitos Microsoft Dynamics CRM:

Microsoft Dynamics CRM conta
Conta Microsoft Azure
Função necessária: administrador do Microsoft Dynamics CRM

Por Que e Quando Desempenhar Esta Tarefa

Conclua essas etapas na sua conta de desenvolvedor do Azure. Consulte a documentação do produto Azure para obter instruções sobre como criar e configurar aplicações personalizadas.

Procedimento

Faça login no portal de registro do aplicativo Microsoft Azure com as credenciais da sua organização.
Registre uma nova aplicação personalizada preenchendo o nome da aplicação, o tipo de conta compatível e o URI de redirecionamento e clique em Registrar.
Uma visão geral das informações básicas da aplicação é mostrada.
Copie o ID da aplicação para um arquivo de texto.
Você usará este ID e o segredo do cliente gerado na próxima etapa para registrar o app como um provedor OAuth de terceiros em sua instância ServiceNow. Você usa o ID da aplicação como o ID do cliente ao conectar a aplicação a ServiceNow.
Adicionar um segredo do cliente.
1. No Microsoft Azure, navegue até Gerenciar > Certificados e segredos.
2. Forneça uma descrição e uma data de vencimento e clique em Adicionar.
  
  Nota:
  O segredo do cliente só é exibido em texto sem formatação por um curto período de tempo. Você usa o segredo do cliente ao conectar a aplicação a ServiceNow.
Habilite as permissões para as quais você deseja que a aplicação ofereça suporte.
Para obter mais informações, consulte a referência de permissões do Microsoft Graph.
1. No Microsoft Azure, navegue até Gerenciar > Permissões de API.
2. Clique no bloco do Microsoft Graph.
3. Selecione as Permissões delegadas ou da aplicação compatíveis com a aplicação.
  As permissões delegadas permitem que a aplicação acesse a API como um usuário conectado. As permissões da aplicação permitem que a aplicação seja executada como um serviço ou daemon em segundo plano sem um usuário conectado.
4. Clique em Adicionar permissões.

O que Fazer Depois

Registrar Microsoft Dynamics CRM como provedor OAuth.

Registrar Microsoft Dynamics CRM como provedor OAuth

Use as informações geradas durante a configuração da conta Microsoft Dynamics CRM para registrar o Microsoft Dynamics CRM como um provedor do OAuth e permitir que a instância solicite tokens do OAuth 2.0.

Antes de Iniciar

Solicitar assinatura do Integration Hub.
Ativar Microsoft Dynamics CRM.
Crie uma aplicação Microsoft Dynamics CRM.
Função necessária: administrador

Procedimento

Na ServiceNow, navegue até OAuth de Sistema > Registro de aplicações.
Clique em Nova.
Na tela intitulada Que tipo de aplicação OAuth, selecione Conectar a um provedor OAuth de terceiros.

No formulário, preencha os campos.

Tabela 1. Formulário de registros de aplicações
Campo	Valor necessário
Nome	Insira qualquer nome para identificar exclusivamente o registro, por exemplo, `Perfil OAuth do Dynamics CRM`.
ID de cliente	Insira a ID da aplicação Microsoft Dynamics CRM que você criou no Azure.
Segredo do cliente	Insira o segredo do cliente que você gerou ao criar a aplicação no Azure.
Tipo de concessão padrão	Selecione Código de autorização.
URL de Autorização	Clique no ícone de cadeado (ícone de ), insira `https://login.microsoftonline.com/common/oauth2/v2.0/authorize` seguido por um ponto de interrogação e o atributo de recurso da sua instância e clique no ícone de cadeado novamente. O atributo de recurso da URL. Por exemplo, `?resource=https://mycompany.crm.dynamics.com`. Este atributo é o URL da sua aplicação Microsoft.
URL de Token	Clique no ícone de cadeado (ícone de ), insira `https://login.microsoftonline.com/common/oauth2/v2.0/token`e clique no ícone de cadeado novamente.
URL de redirecionamento	Clique no ícone de cadeado (ícone de ), insira `https://`<instance> .service-now.com/oauth_redirect.do e clique no ícone de cadeado novamente.

Na lista relacionada Escopos de Entidade OAuth, edite o escopo da entidade fornecido para incluir o URL da sua aplicação Microsoft Dynamics CRM.
O nome e o escopo do OAuth geralmente são a mesma cadeia de caracteres.
Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
O sistema valida as credenciais do OAuth.

O que Fazer Depois

Criar registro de credencial para Microsoft Dynamics CRM.

Criar registros de credenciais para o Microsoft Dynamics CRM spoke

Crie registros de credencial para a aplicação OAuth personalizada Microsoft Dynamics CRM que você criou durante a configuração da conta Microsoft Dynamics CRM. Os aliases de conexão e credencial Microsoft Dynamics CRM spoke usam essas credenciais para autorizar ações.

Antes de Iniciar

Função necessária: administrador

Procedimento

Navegar até Todos > Conexões e Credenciais > Credenciais.
Clique em Nova.
O sistema exibe a mensagem Que tipo de credenciais você deseja criar?.
Selecione Credenciais OAuth 2.0.
A janela pop-up exibe um formulário em branco de Credenciais OAuth 2.0.

Insira estes valores.


Campo	Valor necessário
Nome	Insira qualquer nome para identificar exclusivamente o registro. Por exemplo, insira `Credenciais dinâmicas`.
Ativo	Habilitar
Perfil de Entidade OAuth	Selecione o perfil OAuth que você criou ao registrar a aplicação personalizada Microsoft Dynamics CRM como um provedor OAuth. Por exemplo, selecione o perfil do Dynamics OAuth.
Ordem	Selecione a ordem para aplicar esta credencial. Por exemplo: insira `100`.

Salve o registro.
Em Links relacionados, clique em Obter token OAuth.
O sistema exibe uma mensagem de confirmação de que o fluxo de token OAuth foi concluído com sucesso. Revise os detalhes se o fluxo não tiver sido concluído com sucesso.
Nota:
Certifique-se de permitir janelas pop-up no navegador.

Criar registros de conexão para o Microsoft Dynamics CRM spoke

Crie registros de conexão para sua conta do Microsoft Azure. O alias de conexão e credencial Microsoft Dynamics CRM spoke usa essas conexões para executar ações em Microsoft Dynamics CRM.

Antes de Iniciar

Função necessária: administrador

Procedimento

Navegar até Todos > Conexões e Credenciais > Aliases de conexão e credencial.
Abra o alias de conexão e credencial da aplicação Microsoft Dynamics CRM.
Na guia Conexões, clique em Novo.
O sistema exibe um formulário de conexão HTTP(s) em branco.

Insira estes valores.


Campo	Valor necessário
Nome	Insira qualquer nome para identificar exclusivamente o registro de conexão. Por exemplo, insira `Conexão do MS Dynamics CRM`.
Credenciais	Selecione o registro de credencial que você criou para Microsoft Dynamics CRM. Por exemplo, selecione Credenciais do MS Dynamics.
Alias de conexão	Selecione o registro de alias de conexão que você criou para Microsoft Dynamics CRM.
Ativo	Habilitar
URL de Conexão	Insira a URL dinâmica raiz. Por exemplo, `https://`<SiteName> .dynamics.com .

Clique em Enviar.

Configurar Microsoft Dynamics CRM detalhes do webhook

Registre o webhook [ Microsoft Dynamics CRM em ServiceNow para notificar a aplicação ServiceNow quando determinados eventos ocorrerem em Microsoft Dynamics CRM.

Antes de Iniciar

Função necessária: administrador

Microsoft Dynamics CRM requer registro por meio da Ferramenta de registro de plug-in do Windows. Para instalar a Ferramenta de registro de plug-in do Windows, consulte o documento da Microsoft Ferramentas de download do NuGet.
A URL do endpoint é a URL da instância ServiceNow na qual as informações do evento são publicadas. Por exemplo, https://<instance-name> .service-now.com/api/sn_ms_crm_spoke/dynamics_webhook_callbacks .
O par de chave-valor usado para registrar o webhook na Ferramenta de registro de plug-in é o mesmo que o Nome e a Chave de autorização em Detalhes do webhook do Dynamics CRM.

Procedimento

Navegar até Todos > Detalhes do webhook do Dynamics CRM > Detalhes do Cliente.
Clique em Nova.
No campo Nome, insira a chave do plug-in do webhook.
No campo Chave de autorização, insira o valor do par chave-valor do webhook.

Configurar Microsoft Dynamics CRM política de decisão de webhook

Crie uma política de roteamento de webhook e um subfluxo de acordo com seus requisitos.

Antes de Iniciar

Função necessária: administrador

Procedimento

Navegar até Todos > Flow Designer > Designer
Clique em Subfluxos.
Crie uma cópia do subfluxo padrão, Process Dynamics CRM Webhook.
Personalize o subfluxo de acordo com seus requisitos e publique-o.
Consulte Create a subflow in Workflow Studio para obter mais informações sobre como criar e usar subfluxos.
Navegar até Detalhes do webhook do Dynamics CRM > Política da decisão.
Na guia Decisões, clique em Novo.

No formulário, preencha os campos.

Tabela 2. Formulário de decisão
Campo	Descrição
Rótulo	Rótulo exclusivo para identificar a política de roteamento.
Resposta	Opção para especificar se esta resposta é a resposta padrão. A resposta padrão é aplicável quando as condições não são atendidas. Clique no ícone de pesquisa. Selecione o subfluxo necessário na lista Documento:. Nota: Certifique-se de que o nome da tabela seja `Subfluxo de resposta do Webhook do Dynamics CRM [sn_ms_crm_spoke_dynamic_crm_webhook_answer_subflow]`.
Condição	Condições a serem atendidas quando os eventos necessários ocorrerem em Microsoft Dynamics CRM.

Clique em Enviar.

Nota:
Essas políticas de roteamento são salvas nas tabelas de decisão. Os usuários são alertados para não atualizar ou modificar diretamente os dados dessas tabelas.

Resultado

A política de decisão e o subfluxo foram criados.