Configurar Microsoft Dynamics CRM spoke.

  • Versão de lançamento: Washingtondc
  • Atualizado 3 de ago. de 2023
  • 7 min. de leitura

    • Integre a instância [ ServiceNow e Microsoft Dynamics CRM usando as credenciais Windows para autenticar ServiceNow solicitações.

    Antes de Iniciar

    • Instalar Microsoft AD
    • Solicitar assinatura do IntegrationHub.
    • Ative o Microsoft Dynamics CRM spoke.
    • Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Siga estas etapas para usar todas as ações Microsoft Dynamics CRM spoke.

    Configurar aplicação Microsoft Dynamics CRM

    Crie uma aplicação OAuth personalizada 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

    1. Faça login no portal de registro do aplicativo Microsoft Azure com as credenciais da sua organização.
    2. Registre uma nova aplicação personalizada preenchendo o nome da aplicação, o tipo de conta compatível e o URI de redirecionamento e, em seguida, clique em Registrar.
      Uma visão geral das informações básicas da aplicação é mostrada.
    3. 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.
    4. 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. Você usa o segredo do cliente ao conectar a aplicação a ServiceNow.
    5. 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 IntegrationHub.
    • Ativar Microsoft Dynamics CRM.
    • Crie uma aplicação Microsoft Dynamics CRM.
    • Função necessária: administrador

    Procedimento

    1. Na ServiceNow, navegue até OAuth de Sistema > Registro de aplicações.
    2. Clique em Nova.
    3. Na tela intitulada Que tipo de aplicação OAuth, selecione Conectar a um provedor OAuth de terceiros.
    4. 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 o 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 cadeado), 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 do token Clique no ícone de cadeado (ícone de cadeado), insira https://login.microsoftonline.com/common/oauth2/v2.0/tokene clique no ícone de cadeado novamente.
      URL de redirecionamento Clique no ícone de cadeado (ícone de cadeado), insira https://<instance> .service-now.com/oauth_redirect.do e clique no ícone de cadeado novamente.
    5. 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.

      Os escopos da entidade OAuth do Microsoft Dynamics CRM.
    6. 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 Credenciais 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

    1. Navegar até Todos > Conexões e Credenciais > Credenciais.
    2. Clique em Nova.
      O sistema exibe a mensagem Que tipo de credenciais você deseja criar?.
    3. Selecione Credenciais OAuth 2.0.
      A janela pop-up exibe um formulário de Credenciais do OAuth 2.0 em branco.
    4. Insira estes valores.
      Campo Valor necessário
      Nome Insira qualquer nome para identificar exclusivamente o registro. Por exemplo, insira Credenciais do Dynamics.
      Ativo Habilitar
      Perfil de Entidade OAuth Selecione o perfil OAuth que você criou ao registrar a aplicação Microsoft Dynamics CRM personalizada como um provedor OAuth. Por exemplo, selecione o perfil Dynamics OAuth.
      Ordem Selecione a ordem para aplicar esta credencial. Por exemplo, insira 100.
    5. Salve o registro.
    6. 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 for 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

    1. Navegar até Todos > Conexões e Credenciais > Aliases de conexão e credencial.
    2. Abra o alias de conexão e credencial da aplicação Microsoft Dynamics CRM.
    3. Na guia Conexões, clique em Novo.
      O sistema exibe um formulário de conexão HTTP(s) em branco.
    4. Insira estes valores.
      Campo Valor necessário
      Nome Insira qualquer nome para identificar exclusivamente o registro da conexão. Por exemplo, insira Conexão do MS Dynamics CRM.
      Credencial 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 o URL raiz do Dynamics. Por exemplo, https://<SiteName> .dynamics.com .
    5. Clique em Enviar.

    Configurar detalhes do webhook Microsoft Dynamics CRM

    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 Baixar ferramentas 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 nos Detalhes do Webhook do Dynamics CRM.

    Procedimento

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

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

    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

    1. Navegar até Todos > Flow Designer > Designer
    2. Clique em Subfluxos.
    3. Crie uma cópia do subfluxo padrão, Process Dynamics CRM Webhook.
    4. Personalize o subfluxo de acordo com seus requisitos e publique-o.
      Consulte Criar um subfluxo no para obter mais informações sobre como criar e usar subfluxos.
    5. Navegar até Detalhes do Webhook do Dynamics CRM > Política da decisão.
    6. Na guia Decisões, clique em Novo.
    7. 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.
      1. Clique no ícone de pesquisa.
      2. 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.
    8. 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 nessas tabelas.

    Resultado

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