Compartir a través de


Tutorial: Registrar una aplicación de Dynamics 365 con Active Directory

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Este tutorial describe cómo registrar un cliente de escritorio o una aplicación móvil de modo que puede conectarse y autenticarse en el servidor de Microsoft Dynamics 365 y obtener acceso a los servicios web. Una vez registrada, una aplicación puede tener acceso a los servicios web mediante solicitudes de HTTP a través de los extremos SOAP u OData del servidor. Este tutorial se aplica a Microsoft Dynamics 365.

Requisitos previos

Para una Implementación con conexión a Internet (IFD) o local:

  • Un Windows Server 2012 R2 con AD FS.

  • Debe tener acceso de administrador al servidor que hospeda el rol de servicios de implementación de Microsoft Dynamics 365 y al servidor de AD FS.

  • El servidor local debe estar configurado para usar la autenticación de notificaciones.

  • La dirección URL de redirección para la aplicación. Las instrucciones para encontrar esa URL se encuentran en la sección titulada Obtener la URI de redirección.

En este tema

Obtener la URI de redirección

Registro de aplicaciones Dynamics 365 locales (IFD)

Obtener la URI de redirección

Un método para obtener la URI de redirección para una aplicación Windows del cliente nativo es ejecutar la siguiente línea de código en una sesión de depuración de la aplicación y examinar el valor URI devuelto. En una sesión de depuración de WinJS, seleccione la propiedad de RawUri.

string redirectUri = WebAuthenticationBroker.GetCurrentApplicationCallbackUri().ToString();
Dim redirectUri As String = WebAuthenticationBroker.GetCurrentApplicationCallbackUri().ToString()
Windows.Security.Authentication.Web.WebAuthenticationBroker.getCurrentApplicationCallbackUri()

La clase WebAuthenticationBroker se puede encontrar en el espacio de nombres de Windows.Security.Authentication.Web. Use el valor de cadena que devuelve el método cuando se registra la aplicación. La línea de C# de código aparece en el tema Ejemplo: aplicación moderna de escritorio OData de Windows 8.

Para una aplicación cliente nativa no Windows como una aplicación de consola, use cualquier valor de URI válido. En este caso, el URI no tiene por qué existir realmente pero debe ser único en el inquilino.

Registro de aplicaciones Dynamics 365 locales (IFD)

Escenario: Un cliente u otra persona registra una aplicación personalizada para tener acceso a datos de la organización en un servidor de Dynamics 365 proporcionado por un ISV o asociado.

El ISV o asociado realiza las siguientes tareas:

  1. Configura el servidor local de Dynamics 365 (IFD) y el servidor de AD FS con los comandos de Windows PowerShell que se proporcionan más adelante en esta sección.

  2. Se proporciona información sobre el Id. de cliente y la URL de dirección del servidor al cliente.

El cliente u otra persona realizará las siguientes tareas:

  1. Configura la aplicación externa introduciendo el Id. de cliente y la URL de dirección de servidor en la aplicación según se indique.

Programa de instalación de Dynamics 365 Server

Para configurar el servidor de Dynamics 365 para habilitar notificaciones federadas, siga estos pasos.

Configurar los ajustes de notificaciones

  1. Inicie sesión como administrador en el servidor de Dynamics 365 que recibe el rol del servicio de implementación y abra una ventana de comandos de Windows PowerShell.

  2. Agregue el complemento Dynamics 365Windows PowerShell de (Microsoft.Crm.PowerShell.dll).Más información:TechNet: Administración de la implementación con Windows PowerShell

    Add-PSSnapin Microsoft.Crm.PowerShell
    
  3. Escriba el siguiente comando de Windows PowerShell.

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

Instalación del servidor AD FS

Para registrar la aplicación externa con AD FS, siga estos pasos.

Registrar la aplicación en Active Directory

  1. Inicie sesión en el servidor de AD FS como administrador y abra una ventana de comandos de Windows PowerShell.

  2. Escriba el siguiente comando.

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

    Donde <CLIENT_ID> es un número único, <APP_NAME> es un nombre para la aplicación, y <REDIRECT_URI> es cualquier URI válida a la que redirigirá AD FS cuando la autenticación se haya completado. Se recomienda que el Id. del cliente sea un GUID. Puede generar un GUID en Microsoft Visual Studio abriendo el menú Herramientas y haciendo clic en Cree el GUID.

Ver también

Agregar, actualizar y quitar una aplicación
Autenticar al usuario con los servicios web
Autenticar usuarios en Microsoft Dynamics 365

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright