Authentification des applications basée sur .NET

  • Article

Cette rubrique fournit des instructions dans le cadre du développement d’applications codées et créées à l’aide de .NET.

Applications .NET Framework

Si vous utilisez le .NET Framework lors du développement de votre application, vous pouvez utiliser des classes dans l’espace de nom Xrm.Tooling pour s’authentifier et se 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 utilisé par les plug-ins et les activités de workflow, en en faisant un style que vous pouvez utiliser n’importe où 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 les informations de connexion avec une chaîne de connexion ;
  • prise en charge de l’authentification basée sur les revendications OAuth et Microsoft 365 ;
  • Sécurité de thread pour les actions exécutées dans un environnement multithread.
  • Fournit un contrôle de connexion commun (WPF) pour une expérience de connexion cohérente pour les applications depuis 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 de diagnostic intégré et création de rapports sur les performances pour les actions exécutées, que vous pouvez configurer selon les besoins de votre organisation ;
  • prise en charge de l’authentification de 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.ConnectorCrmServiceClient.ExecuteCrmWebRequest pour composer les demandes à l’aide de l’API Web avec tous les autres avantages fournis par les classes Xrm.Tooling tant que vous utilisez OAuth.

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

Versions .NET Framework

Utilisez la version 4.6.2 ou supérieure de .NET Framework 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 c’est le cas dans la version 4.6.2 de .NET Framework ou ultérieure.

Applications .NET Framework sans utiliser d’assemblys SDK

Si vous préférez ne pas avoir de dépendance sur des assemblys SDK, vous pouvez également utiliser les critères décrits dans Utiliser OAuth avec Microsoft Dataverse sans prendre de dépendance sur un des 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 kit de développement logiciel disponibles dans Microsoft.CrmSdk.XrmTooling.CoreAssembly et autres packages NuGet appartenant à « crmsdk » ne prennent pas en charge le développement de code .NET Core.

Pour le développement d’applications .NET Core, il existe une classe DataverseServiceClient, qui est calquée sur 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 basé sur .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 créer une application .NET Core, supprimer toutes les références spécifiques à .NET Framework et les packages NuGet, puis ajoutez le package Microsoft.PowerPlatform.Dataverse.Client au projet.

Voir aussi

Authentification auprès des services web Dataverse
Utilisation d’OAuth avec Dataverse

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).