Autenticación de aplicaciones .NET

  • Artículo

Este tema brinda orientación al desarrollar aplicaciones codificadas y creadas con .NET.

Aplicaciones .NET Framework

Si está utilizando .NET Framework al desarrollar su aplicación, puede utilizar clases dentro del 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 es el mismo estilo de programación que usan los complementos y las actividades de flujo de trabajo, convirtiéndolo en un estilo que puede usar por todas partes para las aplicaciones de .NET Framework. Recomendamos utilizar el Microsoft.Xrm.Tooling.Connector.CrmServiceClient clase para la conexión del servicio web.

Las clases Xrm.Tooling proporcionan varios beneficios que incluyen:

  • Puede definir la información de conexión con una cadena de conexión.
  • Admite la autenticación basada en notificaciones de OAuth y Microsoft 365.
  • Seguridad de subprocesos para las acciones realizadas en un entorno multiprocesos.
  • 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.
  • Informes integrados de seguimiento de diagnósticos y de rendimiento de las acciones realizadas, que puede configurar según los requisitos de la organización.
  • Soporte para la autenticación del certificado X.509.

Las clases Xrm.Tooling se optimizar para usar los métodos de interfaz IOrganizationService.

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

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

Versiones de .NET Framework

Use la versión 4.6.2 de .NET Framework o superior 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 usado por .NET Framework 4.5.2, pero está en .NET Framework 4.6.2 o posterior.

Aplicaciones .NET Framework sin usar ensamblados SDK

Si prefiere no tener una dependencia en ningún ensamblado de SDK, puede usar también los patrones descritos en Usar OAuth con Microsoft Dataverse sin aceptar ninguna dependencia de cualquier montaje 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 de SDK disponibles en Microsoft.CrmSdk.XrmTooling.CoreAssembly y otros paquetes NuGet propiedad de "crmsdk" no admiten desarrollo de código .NET Core.

Para el desarrollo de aplicaciones .NET Core hay una clase DataverseServiceClient, que sigue el patrón de 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 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 utiliza CrmServiceClient, comience reemplazando la clase DataverseServiceClient para CrmServiceClient en su código. Deberá establecer el tipo de proyecto para crear una aplicación .NET Core, eliminar las referencias específicas de .NET Framework y paquetes NuGet y, a continuación, agregue el paquete Microsoft.PowerPlatform.Dataverse.Client al proyecto.

Consulte también

Autenticación con servicios web de Dataverse
Utilizar OAuth con Dataverse

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).