Passo a passo: Registrar o aplicativo Dynamics 365 com Ative Directory

  • Artigo

 

Publicado: janeiro de 2017

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

Esse passo a passo descreve como registrar um cliente de área de trabalho ou um aplicativo móvel de modo que ele possa ser conectado e autenticado com o servidor Microsoft Dynamics 365 e acessar os serviços da Web. Depois de registrado, um aplicativo pode acessar os serviços da Web usando solicitações HTTP através de pontos de extremidade SOAP ou OData do servidor. Esse passo a passo se aplica ao Microsoft Dynamics 365.

Pré-requisitos

Para uma Implantação para a Internet (IFD) no local ou:

  • Um Windows Server 2012 R2 com AD FS.

  • Você deve ter acesso de administrador ao servidor que hospeda a função de serviços de implantação Microsoft Dynamics 365 e o servidor AD FS.

  • O servidor no local deve ser configurado para usar a autenticação de declarações.

  • A URL de redirecionamento para o aplicativo. Instruções para saber se a URL foi fornecida na seção chamada Obtenha o URI de redirecionamento.

Neste tópico

Obtenha o URI de redirecionamento

Registro de aplicativos do Dynamics 365 no local (IFD)

Obtenha o URI de redirecionamento

Um método para obter o URI de redirecionamento para um aplicativo cliente nativo do Windows é executar a linha de código a seguir em uma sessão de depuração do aplicativo e examinar o valor retornado do URI. Em uma sessão de depuração WinJS, selecione a propriedade RawUri.

string redirectUri = WebAuthenticationBroker.GetCurrentApplicationCallbackUri().ToString();

Dim redirectUri As String = WebAuthenticationBroker.GetCurrentApplicationCallbackUri().ToString()

Windows.Security.Authentication.Web.WebAuthenticationBroker.getCurrentApplicationCallbackUri()

A classe WebAuthenticationBroker pode ser encontrada no namespace Windows.Security.Authentication.Web. Use o valor de cadeia de caracteres retornado da chamada do método ao registrar o aplicativo. A linha de código C# é mostrada no tópico Exemplo: Aplicativo OData moderno de área de trabalho do Windows 8.

Para um aplicativo cliente nativo que não seja do Windows, como um aplicativo de console, use qualquer valor válido do URI. Nesse caso, a URI não precisa existir, mas precisa ser exclusiva no locatário.

Registro de aplicativos do Dynamics 365 no local (IFD)

Cenário: Um cliente ou outra pessoa registra um aplicativo personalizado para acessar os dados da organização em um servidor Dynamics 365 fornecido por um ISV ou parceiro.

O ISV ou parceiro executa as seguintes tarefas:

  1. Configura o servidor no local (IFD) Dynamics 365 e o servidor AD FS usando os comandos Windows PowerShell fornecidos posteriormente nesta seção.

  2. Fornece informações de ID do cliente e endereço do servidor URL ao cliente.

O cliente ou outra pessoa executa as seguintes tarefas:

  1. Configura o aplicativo externo inserindo o ID do cliente e o endereço do servidor URL no aplicativo conforme instruído.

Configuração do servidor Dynamics 365

Para configurar o servidor Dynamics 365 a fim de habilitar declarações confederadas, siga estas etapas.

Definir configurações de declarações

  1. Faça logon como administrador no servidor Dynamics 365 que hospeda a função de serviço de implantação e abra uma janela de comando Windows PowerShell.

  2. Adicione o snap-in do Dynamics 365Windows PowerShell (Microsoft.Crm.PowerShell.dll).Para obter mais informações:TecnNet: Administrar a implantação usando o Windows PowerShell.

    Add-PSSnapin Microsoft.Crm.PowerShell

  3. Digite os seguintes comandos Windows PowerShell.

    $ClaimsSettings = Get-CrmSetting -SettingType OAuthClaimsSettings
$ClaimsSettings.Enabled = $true
Set-CrmSetting -Setting $ClaimsSettings

Instalação do servidor AD FS

Para registrar o aplicativo externo com AD FS, siga estas etapas.

Registre o aplicativo no Ative Directory

  1. Faça logon no servidor AD FS como administrador e abra uma janela de comando Windows PowerShell.

  2. Digite o seguinte comando.

    Add-AdfsClient -ClientId <CLIENT_ID> -Name <APP_NAME> -RedirectUri <REDIRECT_URI>

    Quando o <CLIENT_ID> for um número único, o <APP_NAME> é um nome para o aplicativo, e o <REDIRECT_URI> é qualquer URI válido cujo AD FS é para redirecionar depois de concluída a autenticação. Recomenda-se que o ID do cliente seja um GUID. Você pode gerar um GUID no Microsoft Visual Studio abrindo o menu Ferramentas e clicando em Criar GUID.

Confira Também

Adicionando, atualizando e removendo um aplicativo
Autenticar o usuário nos serviços web
Autenticar usuários no Microsoft Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Todos os direitos reservados. Direitos autorais