Authentifizieren von .NET Anwendungen

Dieses Thema enthält Anleitungen zum Entwickeln von Anwendungen, die mithilfe von .NET codiert und erstellt wurden.

.NET Framework-Anwendungen

Wenn Sie das .NET Framework beim Entwickeln Ihrer Anwendung verwenden, können Sie Klassen innerhalb der Xrm.Tooling Namespace verwenden, um sich einfach zu authentifizieren und eine Verbindung mit den Microsoft Dataverse Webdiensten herzustellen.

Xrm.Tooling-Klassen in den SDK-Assemblies verwenden die IOrganizationService-Schnittstellenmethoden. Dies ist derselbe Programmierstil, der von Plug-Ins und Workflowaktivitäten verwendet wird und es ermöglicht, diesen Stil überall in .NET Framework-Anwendungen einzusetzen. Wir empfehlen die Verwendung der Microsoft.Xrm.Tooling.ConnectorCrmServiceClient-Klasse für die Webdienstverbindung.

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

• Sie können Verbindungsinformationen mithilfe einer connection string 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.
• Stellt ein gängiges Windows Presentation Foundation -Anmeldesteuerelement (WPF) für eine konsistente Anmeldeerfahrung aus Ihren Windows-Clientanwendungen bereit.
• Unterstützung für die sichere Speicherung der Anmeldeinformationen und Wiederverwendung der gespeicherten Anmeldeinformationen zur automatischen Anmeldung nach der ersten Anmeldung.
• Integrierte Diagnoseablaufverfolgung und Leistungsberichte der ausgeführten Aktionen, die Sie basierend auf den Anforderungen Ihrer Organisation 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 nutzen möchten, können Sie die Microsoft.Xrm.Tooling.Connector.CrmServiceClient.ExecuteCrmWebRequest-Methode verwenden, 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-Clientanwendungen mit den XRM-Tools

.NET Framework-Versionen

Verwenden Sie .NET Framework, Version 4.6.2 oder höher, wenn Sie Clientanwendungen 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 in .NET Framework 4.6.2 oder höher ist es das Standardprotokoll.

.NET Framework-Anwendungen ohne VERWENDUNG von SDK-Assemblys

Wenn Sie keine Abhängigkeit von SDK-Assemblys haben möchten, können Sie auch die in Use OAuth with Microsoft Dataverse beschriebenen Muster verwenden, ohne eine Abhängigkeit von SDK-Assemblys zu übernehmen. 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 SDK-APIs, die in Microsoft.CrmSdk.XrmTooling.CoreAssembly und anderen von "crmsdk" verwalteten NuGet-Paketen verfügbar sind, unterstützen die .NET Core-Codeentwicklung nicht.

Für .NET Core-Anwendungsentwicklung gibt es eine DataverseServiceClient-Klasse, die nach der zuvor erwähnten klasse CrmServiceClient gemustert 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.

Um vorhandenen .NET Framework-basierten Anwendungscode zu aktualisieren, der CrmServiceClient verwendet, ersetzen Sie zunächst die klasse DataverseServiceClient für CrmServiceClient in Ihrem Code. Sie müssen den Projekttyp zum Erstellen einer .NET Core-Anwendung festlegen, 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
Verwenden von OAuth mit Dataverse