Compartilhar via

Passo a passo: Configurar o Microsoft Azure (ACS) para integração com o Dynamics 365

  • Artigo

 

Publicado: janeiro de 2017

Aplicável a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Importante

Este procedimento é preterido. Você deve usar o procedimento descrito no Passo a passo: Configurar o Microsoft Azure (SAS) para integração com o Dynamics 365 usando SAS em vez de ACS.Para obter mais informações:Azure Documentation: Autenticação e autorização do Barramento de Serviço

Este passo a passo guia você pela configuração do Microsoft Azure Active Directory Access Control Service (ACS) para permitir ao aplicativo de ouvinte ler as Microsoft Dynamics 365 mensagens postadas no Barramento de Serviço do Microsoft Azure Essa configuração é executada usando a Ferramenta de Registro de Plug-in fornecida no download do SDK. Este passo a passo se aplica à integração com qualquer Microsoft Dynamics 365 tipo de implantação.

Como um pré-requisito deste passo a passo, se você estiver executando o Microsoft Dynamics 365 (local ou via IFD), configure o Microsoft Dynamics 365 para integração com Microsoft Azure. Para obter mais informações, consulte Passo a passo: Configurar o Dynamics 365 para integração com o Microsoft Azure.Microsoft Dynamics 365 (online) é pré-configurado para Microsoft Azure integração.

Neste tópico

Crie uma configuração de ponto de extremidade de serviço

Configurar ACS

Crie uma configuração de ponto de extremidade de serviço

Uma entidade ServiceEndpoint contém os dados da configuração necessários para mensagens externas com um ponto de extremidade da solução Barramento de Serviço do Microsoft Azure. Ao usar a Ferramenta de Registro de Plug-in fornecida no download do SDK, é fácil criar uma entidade de ponto de extremidade de serviço em uma organização do Dynamics 365 e configurar as regras, o escopo e o emissor do ponto de extremidade do barramento de serviço.

Siga as etapas abaixo para criar um ponto de extremidade de serviço.

  1. Execute a Ferramenta de Registro de Plug-in e faça logon em sua organização do Dynamics 365 de destino.

  2. Selecione a guia da organização na qual você deseja registrar um ponto de extremidade de serviço.

  3. Na barra de ferramentas da guia, clique em Registrar e, em seguida, em Registrar Novo Ponto de Extremidade de Serviço.

  4. Preencha a caixa de diálogo Registro do ponto de extremidade de serviço com as informações relacionadas à solução, conforme mostrado na figura a seguir e descrito na tabela seguinte. Verifique se o contrato especificado é o mesmo contrato usado pelo aplicativo de listener da solução.

    Criar um ponto de extremidade do serviço

    Elemento da UI

    description

    Nome (campo)

    Um nome para o registro de ponto de extremidade de serviço.

    Descrição (campo)

    Uma descrição deste registro do ponto de extremidade.

    Espaço Reservado da Solução (campo)

    O nome do namespace do serviço da solução.

    Caminho (campo)

    O caminho do projeto. Por exemplo, para um determinado ponto de extremidade de serviço URL do https://crmsdkdemo-sb.accesscontrol.windows.net/TwoWayService/Demo, o caminho é TwoWayService/Demo.

    Contrato (menu suspenso)

    O contrato de ponto de extremidade. Um aplicativo de listener deve usar esse contrato para ler a mensagem postada. Para obter mais informações, consulte Escrever um aplicativo ouvinte para uma solução do Microsoft Azure.

    Declaração (menu suspenso)

    As declarações para enviar ao Microsoft Azure. Use Nenhum para a declaração padrão. Especifique UserId ou UserInfo para enviar informações adicionais sobre o usuário conectado.

    Modo federado (caixa de seleção)

    Marque essa caixa para usar o modo federado.

    ID (campo)

    Campo não gravável que é preenchido automaticamente com a ID da configuração do ponto de extremidade.

    Salvar e Configurar ACS (botão)

    Salva a configuração inserida e automatiza o processo de configuração do ACS para você. Fornece uma maneira interativa de fazer o que está descrito no Passo a passo: Configurar o Microsoft Azure (método alternativo do ACS) tópico.

    Salvar e Verificar Autenticação (botão)

    Salva a configuração inserida e verifique se o ACS está configurado corretamente.

    Salvar (botão)

    Salva a configuração inserida e fecha a caixa de diálogo.

  5. Se você ainda não configurou a integração do ACS com o Microsoft Dynamics 365 e deseja que a Ferramenta de Registro de Plug-in faça a configuração para você, clique em Salvar e Configurar ACS e siga as instruções na próxima seção deste passo a passo. Se você já configurou o ACS, clique em Salvar e Verificar Autenticação ou em Salvar e continue com as instruções em Registrar uma etapa do ponto de extremidade de serviço para um evento.

Configurar ACS

Siga as etapas abaixo para configurar o Microsoft Azure Active Directory Access Control Service (ACS).

  1. Depois de selecionar Salvar e Configurar ACS, a caixa de diálogo Configuração ACS aparece. Insira os valores de dados adequados nos campos de formulário conforme descrito na tabela a seguir.

    Nome do Campo

    Descrição

    Chave de Gerenciamento

    A chave de gerenciamento da sua solução. É possível obter este valor de chave no Portal de Gerenciamento do Azure.

    Obtenha uma chave de gerenciamento para um namespace do barramento de serviço

    1. Entre no portal do Azure.

    2. No painel esquerdo, clique em Barramento de Serviço e selecione o espaço reservado na lista.

    3. Na parte inferior da página, clique em Informações de Conexão.

    4. Na caixa de diálogo Acessar as informações de conexão, a Chave padrão será mostrada. Esta é a chave de gerenciamento.

    Observação

    Se você tiver modificado a chave simétrica, digite essa chave em vez da chave padrão no campo Chave de Gerenciamento. Se você não fizer isso, talvez receba erros com uma descrição como: “ACS50012: falha na autenticação”.

    Arquivo do Certificado

    O arquivo de certificado público que foi usado para configurar o Microsoft Dynamics 365 para integração com o Microsoft Azure.

    Para o Microsoft Dynamics 365 (online e local), é possível baixar este arquivo de certificado do servidor. No Microsoft Dynamics 365 aplicativo Web, clique em Configurações > Personalizações e, em seguida, clique em Recursos de Desenvolvedor. Baixe e salve o arquivo de certificado usando o link fornecido abaixo de Barramento de Serviço do Microsoft Azure Certificado de emissor.

    Nome do Emissor

    O nome do emissor. Esse nome deve ser o mesmo usado para configurar o Microsoft Dynamics 365 para integração com o Microsoft Azure. É possível obter o nome do emissor na página Recursos do Desenvolvedor mencionada na descrição anterior.

    Para obter mais informações, consulte Configurar a integração do Azure com o Microsoft Dynamics 365.

  2. Clique em Configurar ACS. Um log do processo de configuração é exibido na área de saída do formulário.

  3. Clique em Fechar.

  4. Clique em Salvar e Verificar Autenticação na caixa de diálogo Registro do Ponto de Extremidade de Serviço. Após a verificação ser concluída, é possível fechar as caixas de diálogo.

Confira Também

Extensões do Azure para Microsoft Dynamics 365
Passo a passo: Configurar o Microsoft Azure (método alternativo do ACS)
Configurar a integração do Azure com o Microsoft Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais