Authentification des applications .NET

Cette rubrique fournit des conseils lors du développement d’applications codées et générées à l’aide de .NET.

applications pour .NET Framework

Si vous utilisez .NET Framework lors du développement de votre application, vous pouvez utiliser des classes dans l’espace de noms Xrm.Tooling pour vous authentifier et vous connecter facilement aux services web Microsoft Dataverse.

Les classes Xrm.Tooling dans les assemblys SDK utilisent les méthodes d’interface IOrganizationService. Il s’agit du même style de programmation que celui utilisé par les plug-ins et les activités de workflow, ce qui en fait un style que vous pouvez utiliser partout pour les applications .NET Framework. Nous vous recommandons d’utiliser la classe Microsoft.Xrm.Tooling.Connector.CrmServiceClient pour la connexion au service web.

Les classes Xrm.Tooling fournissent un grand nombre d’avantages, notamment :

• Vous pouvez définir des informations de connexion à l’aide d’un connection string.
• Prend en charge l'authentification par revendications OAuth et Microsoft 365.
• Sécurité des threads pour les actions exécutées dans un environnement à plusieurs threads.
• Fournit un contrôle de connexion Windows Presentation Foundation (WPF) courant pour une expérience de connexion cohérente à partir de vos applications clientes Windows.
• Prise en charge du stockage sécurisé des informations d’identification et de la réutilisation des informations d’identification stockées pour vous connecter automatiquement après la connexion initiale.
• Suivi des diagnostics et rapports de performances intégrés des actions effectuées, que vous pouvez configurer en fonction des exigences de votre organisation.
• La prise en charge de l’authentification par certificat X.509.

Les classes Xrm.Tooling sont optimisées pour utiliser les méthodes d’interface IOrganizationService.

Si vous souhaitez utiliser l’API web, vous pouvez utiliser la méthode Microsoft.Xrm.Tooling.Connector.CrmServiceClient.ExecuteCrmWebRequest pour composer des requêtes en utilisant l’API web avec tous les autres avantages fournis avec les classes Xrm.Tooling tant que vous utilisez OAuth.

Plus d’informations : Créer des applications clientes Windows à l’aide des outils XRM

versions de .NET Framework

Utilisez .NET Framework version 4.6.2 ou ultérieure lorsque vous créez des applications clientes. Seules les applications utilisant TLS 1.2 ou une meilleure sécurité peuvent se connecter. TLS 1.2 n’est pas le protocole par défaut utilisé par .NET Framework 4.5.2, mais il se trouve dans .NET Framework 4.6.2 ou version ultérieure.

.NET Framework sans utiliser d’assemblies SDK

Si vous préférez ne pas avoir de dépendance sur les assemblys du Kit de développement logiciel (SDK), vous pouvez également utiliser les modèles décrits dans Utiliser OAuth avec Microsoft Dataverse sans prendre de dépendance sur les assemblys sdk. Sans assemblys SDK, vous pouvez utiliser uniquement les services Web OData Restful (API Web et service de découverte global OData). Les Exemples d’opérations de données de l’API Web (C#) illustrent cette approche.

applications .NET Core et .NET 6

Les API du SDK disponibles dans Microsoft.CrmSdk.XrmTooling.CoreAssembly et d'autres packages NuGet appartenant à « crmsdk » ne prennent pas en charge le développement de code .NET Core.

Pour .NET développement d’applications Core, il existe une classe DataverseServiceClient, qui est modèleée après la classe CrmServiceClient mentionnée précédemment. Vous pouvez télécharger le package Microsoft.PowerPlatform.Dataverse.Client depuis Nuget.org pour commencer à utiliser cette nouvelle classe de client de service dans vos applications. La documentation et l’exemple de code pour le DataverseServiceClient et les classes associées seront disponibles dans une future version de la documentation.

Pour mettre à jour le code d’application .NET Framework existant qui utilise CrmServiceClient, commencez par remplacer la classe DataverseServiceClient pour CrmServiceClient dans votre code. Vous devez définir le type de projet pour générer une application .NET Core, supprimer les références spécifiques à l’infrastructure .NET et les packages NuGet, puis ajouter le package Microsoft.PowerPlatform.Dataverse.Client au projet.

Voir aussi

Authentification auprès des services Web Dataverse
Utiliser OAuth avec Dataverse