Autenticación de aplicaciones .NET

En este artículo se proporcionan instrucciones para desarrollar aplicaciones codificadas y compiladas mediante .NET.

aplicaciones de .NET Framework

Al usar .NET Framework para desarrollar la aplicación, use clases en el espacio de nombres Xrm.Tooling para autenticarse y conectarse fácilmente a los servicios web de Microsoft Dataverse.

Las clases Xrm.Tooling en los ensamblados de SDK usan los métodos de interfaz IOrganizationService. Este estilo de programación es el mismo que usan los complementos y las actividades de flujo de trabajo, por lo que puede usarlo en todas partes para las aplicaciones de .NET Framework. Use la clase Microsoft.Xrm.Tooling.Connector.CrmServiceClient para la conexión al servicio web.

Las Xrm.Tooling clases proporcionan muchas ventajas, entre las que se incluyen:

• Puede definir información de conexión mediante un cadena de conexión.
• Admite la autenticación basada en reclamaciones tanto de OAuth como de Microsoft 365.
• Seguridad de hilos para las acciones realizadas en un entorno multihilo.
• Proporciona un control estándar de inicio de sesión de Windows Presentation Foundation (WPF) para ofrecer una experiencia de inicio de sesión coherente en sus aplicaciones cliente de Windows.
• Capacidad de almacenamiento seguro de credenciales de inicio de sesión y reutilización de las credenciales almacenadas para iniciar sesión automáticamente después del inicio de sesión inicial.
• Seguimiento de diagnóstico integrado e informes de rendimiento de las acciones realizadas, que puede configurar en función de los requisitos de su organización.
• Soporte para la autenticación del certificado X.509.

Las clases Xrm.Tooling se optimizan para utilizar los métodos de interfaz IOrganizationService.

Si desea usar la API web, puede usar el Microsoft.Xrm.Tooling.Connectormétodo .CrmServiceClient.ExecuteCrmWebRequest para redactar solicitudes mediante la API web con las demás ventajas proporcionadas por las Xrm.Tooling clases siempre que use OAuth.

Más información: Crear aplicaciones cliente de Windows utilizando las herramientas XRM

versiones de .NET Framework

Use una versión de .NET Framework compatible al crear nuevas aplicaciones cliente.

aplicaciones de .NET Framework sin usar ensamblados del SDK

Si prefiere no depender de ningún ensamblado del SDK, puede usar los patrones descritos en Uso de OAuth con Microsoft Dataverse sin depender de ningún ensamblado del SDK. Sin los ensamblados de SDK, puede usar solo los servicios web de OData Restful (API web y servicio de detección global de OData). Los Ejemplos de las operaciones de datos de API web (C#) demuestran este método.

aplicaciones de .NET Core

Las API del SDK disponibles en Microsoft. CrmSdk.XrmTooling.CoreAssembly y otros paquetes NuGet de propiedad "crmsdk" no admiten el desarrollo de código de .NET Core.

Para el desarrollo de aplicaciones con .NET Core, hay una clase DataverseServiceClient basada en la clase CrmServiceClient mencionada anteriormente. Puede descargar el paquete Microsoft.PowerPlatform.Dataverse.Client desde NuGet.org para empezar a usar esta nueva clase de cliente de servicio en sus aplicaciones. La documentación y el código de ejemplo para el DataverseServiceClient y las clases relacionadas estarán disponibles en una versión futura de la documentación.

Para actualizar el código de aplicación existente basado en .NET Framework que usa CrmServiceClient, sustituya la clase DataverseServiceClient por CrmServiceClient en el código. Establezca el tipo de proyecto para compilar una aplicación .NET Core, quite las referencias específicas de .NET Framework y los paquetes NuGet y agregue el Microsoft. Paquete PowerPlatform.Dataverse.Client al proyecto.

Consulte también

Autenticación con servicios web Dataverse
Usar OAuth con Dataverse