Autenticación de aplicaciones .NET

En este tema se proporcionan instrucciones al desarrollar aplicaciones codificadas y compiladas mediante .NET.

aplicaciones de .NET Framework

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

Las clases en los ensamblados de SDK usan los métodos de interfaz . Este es el mismo estilo de programación que usan los complementos y las actividades de flujo de trabajo, lo que lo convierte en un estilo que puede usar en todas partes para las aplicaciones de .NET Framework. Recomendamos utilizar la clase . para la conexión del servicio web.

Las clases proporcionan varios beneficios que 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 multihilos.
• Proporciona un control de inicio de sesión común de Windows Presentation Foundation (WPF) para una experiencia de inicio de sesión coherente en las 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 se optimizan para usar los métodos de la interfaz.

Si desea usar la API web, puede usar el método .. para crear solicitudes mediante API web con el resto de las ventajas proporcionadas con las clases siempre y cuando use OAuth.

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

versiones de .NET Framework

Use .NET Framework versión 4.6.2 o posterior al crear aplicaciones cliente. Solo las aplicaciones que usan la seguridad de nivel de transporte (TLS) 1.2 o una mejor seguridad pueden conectarse. TLS 1.2 no es el protocolo predeterminado que usa .NET Framework 4.5.2, pero está en .NET Framework 4.6.2 o posterior.

aplicaciones de .NET Framework sin usar ensamblados del SDK

Si prefiere no tener una dependencia en ningún ensamblado del SDK, también puede usar los patrones descritos en Use 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 .NET Core y .NET 6

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

Para el desarrollo de aplicaciones .NET Core, hay una clase DataverseServiceClient que se modela según la clase CrmServiceClient mencionada anteriormente. Puedes descargar el paquete Microsoft.PowerPlatform.Dataverse.Client de Nuget.org para comenzar a usar esta nueva clase de cliente de servicio en sus aplicaciones. La documentación y el código de ejemplo para el y las clases relacionadas estarán disponibles en una versión futura de la documentación.

Para actualizar el código de aplicación basado en .NET Framework existente que usa , comience sustituyendo la clase /> en el código. Deberá establecer el tipo de proyecto para compilar una aplicación .NET Core, quitar cualquier referencia específica de .NET Framework y paquetes NuGet y, a continuación, agregar el paquete Microsoft.PowerPlatform.Dataverse.Client al proyecto.

Consulte también

Autenticación con servicios web Dataverse
Usar OAuth con Dataverse