.NET-Anwendungen authentifizieren

  • Artikel

Dieses Thema bietet Anleitungen zum Entwickeln von Anwendungen, die mit .NET codiert und erstellt wurden.

.NET Framework-Anwendungen

Wenn Sie bei der Entwicklung Ihrer Anwendung das .NET Framework verwenden, können Sie Klassen im Xrm.Tooling-Namensraum verwenden, um sich einfach zu authentifizieren und mit den Microsoft Dataverse-Webdiensten zu verbinden.

Xrm.Tooling-Klassen in den SDK-Assemblies verwenden die IOrganizationService-Schnittstellenmethoden. Dies ist der gleiche Programmierstil, der auch von Plug-Ins und Workflow-Aktivitäten verwendet wird, was ihn zu einer Vorgehensweise macht, die Sie überall für.NET Framework-Anwendungen verwenden können. Wir empfehlen die Verwendung der Microsoft.Xrm.Tooling.Connector.CrmServiceClient Klasse für die Webdienst-Verbindung zu verwenden.

Die Xrm.Tooling-Klassen bieten viele Vorteile, darunter:

  • Sie können Verbindungsinformationen über eine Verbindungszeichenfolge definieren.
  • Unterstützt sowohl OAuth als auch Microsoft 365 anspruchsbasierte Authentifizierung.
  • Thread-Sicherheit für Aktionen, die in einer Multi-Thread-Umgebung ausgeführt werden.
  • Bietet ein allgemeines WPF-Login-Steuerelement (Windows Presentation Foundation) für ein konsistentes Anmeldeerlebnis in Ihren Windows Client-Anwendungen.
  • Unterstützung für die sichere Speicherung der Anmeldeinformationen und Wiederverwendung der gespeicherten Anmeldeinformationen zur automatischen Anmeldung nach der ersten Anmeldung.
  • Integrierte Diagnosenachverfolgung und Leistungsberichte der durchgeführten Aktionen, die Sie entsprechend der Anforderungen Ihres Unternehmens konfigurieren können.
  • Support für X.509-Zertifikatsauthentifizierung.

Die Xrm.Tooling-Klassen sind für die Verwendung der IOrganizationService-Schnittstellenmethoden optimiert.

Wenn Sie die Web-API verwenden möchten, können Sie die Microsoft.Xrm.Tooling.Connector.CrmServiceClient.ExecuteCrmWebRequest verwenden. Methode, um Anfragen über die Web-API mit allen anderen Vorteilen der Xrm.Tooling-Klassen zu erstellen, solange Sie OAuth verwenden.

Weitere Informationen: Erstellen von Windows-Client-Anwendungen mithilfe der XRM-Tools

.NET Framework Versionen

Verwenden Sie 4.6.2 .NET Framework oder höher, wenn Client-Anwendungen erstellen. Nur Anwendungen, die Transport Level Security (TLS) 1.2 oder eine bessere Sicherheit verwenden, können eine Verbindung herstellen. TLS 1.2 ist nicht das Standardprotokoll, das von .NET Framework 4.5.2 verwendet wird, aber es ist in .NET Framework 4.6.2 oder später.

.NET Framework-Anwendungen ohne Verwendung von SDK-Assemblys

Wenn Sie es vorziehen, keine Abhängigkeit zu SDK-Assemblies zu haben, können Sie auch die unter OAuth mit Microsoft Dataverse verwenden beschriebenen Muster für Anwendungen verwenden, ohne von SDK-Assemblies abhängig zu sein. Ohne die SDK-Assemblys können Sie nur die OData Restful Webdienste (Web API und OData Global Discovery Service) verwenden. Die Beispiele für Web-API-Datenvorgänge (C#) veranschaulichen diese Vorgehensweise.

.NET Core- und .NET 6-Anwendungen

Die in Microsoft.CrmSdk.XrmTooling.CoreAssembly verfügbaren SDK-APIs und andere NuGet-Pakete im Besitz von „crmsdk“ unterstützen keine .NET Core-Codeentwicklung.

Für die .NET Core-Anwendungsentwicklung gibt es eine DataverseServiceClient-Klasse, die dem Muster der bereits erwähnten CrmServiceClient-Klasse nachempfunden ist. Sie können das Microsoft.PowerPlatform.Dataverse.Client-Paket von Nuget.org herunterladen, um diese neue Service-Client-Klasse in Ihren Anwendungen zu verwenden. Dokumentation und Beispielcode für DataverseServiceClient und verwandte Klassen werden in einer zukünftigen Dokumentationsversion zur Verfügung gestellt.

So aktualisieren Sie vorhandenen .NET Framework-basierten Anwendungscode, der CrmServiceClient verwendet. Beginnen Sie mit der Ersetzung der DataverseServiceClient-Klasse für CrmServiceClient in deinem Code. Sie müssen den Projekttyp festlegen, um eine .NET Core-Anwendung zu erstellen, alle .NET Framework-spezifischen Verweise und NuGet-Pakete entfernen, und dann das Microsoft.PowerPlatform.Dataverse.Client-Paket dem Projekt hinzufügen.

Siehe auch

Authentifizierung mit Dataverse-Webdiensten
OAuth in Dataverse verwenden

Hinweis

Können Sie uns Ihre Präferenzen für die Dokumentationssprache mitteilen? Nehmen Sie an einer kurzen Umfrage teil. (Beachten Sie, dass diese Umfrage auf Englisch ist.)

Die Umfrage dauert etwa sieben Minuten. Es werden keine personenbezogenen Daten erhoben. (Datenschutzbestimmungen).