Authentifizieren von .NET Anwendungen

Dieser Artikel enthält Anleitungen für die Entwicklung von Anwendungen, die mithilfe von .NET codiert und erstellt wurden.

.NET Framework-Anwendungen

Wenn Sie das .NET Framework zum Entwickeln Ihrer Anwendung verwenden, verwenden Sie Klassen im Xrm.Tooling-Namespace, 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. Dieser Programmierstil ist derselbe Stil, der von Plug-Ins und Workflowaktivitäten verwendet wird, sodass Sie sie überall für .NET Framework-Anwendungen verwenden können. Verwenden Sie die Microsoft.Xrm.Tooling.Connector.CrmServiceClient -Klasse für die Webdienstverbindung.

Die Xrm.Tooling Klassen bieten viele Vorteile, darunter:

• Sie können Verbindungsinformationen mithilfe einer Verbindungszeichenfolge definieren.
• Unterstützt sowohl OAuth als auch Microsoft 365 anspruchsbasierte Authentifizierung.
• Threadsicherheit für Aktionen, die in einer Multithreadumgebung ausgeführt werden.
• Stellt ein allgemeines 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 verwenden möchten, können Sie die Microsoft.Xrm.Tooling.ConnectorMETHODE .CrmServiceClient.ExecuteCrmWebRequest verwenden, um Anforderungen mithilfe der Web-API mit allen anderen Vorteilen zu verfassen, die von den Xrm.Tooling Klassen bereitgestellt werden, solange Sie OAuth verwenden.

Weitere Informationen: Erstellen von Windows-Clientanwendungen mit den XRM-Tools

.NET Framework-Versionen

Verwenden Sie beim Erstellen neuer Clientanwendungen eine unterstützte .NET Framework-Version.

.NET Framework-Anwendungen ohne VERWENDUNG von SDK-Assemblys

Wenn Sie nicht von SDK-Assemblys abhängen möchten, können Sie die unter "Verwenden von OAuth mit Microsoft Dataverse" beschriebenen Muster verwenden, ohne dass eine Abhängigkeit von SDK-Assemblys besteht. 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 Kernanwendungen

Die in Microsoft verfügbaren SDK-APIs. CrmSdk.XrmTooling.CoreAssembly und andere "crmsdk"-eigene NuGet-Pakete unterstützen .NET Core-Codeentwicklung nicht.

Für .NET Core-Anwendungsentwicklung gibt es eine DataverseServiceClient Klasse, die nach der CrmServiceClient zuvor erwähnten Klasse gemustert ist. Sie können das Microsoft.PowerPlatform.Dataverse.Client-Paket von NuGet.org herunterladen, um diese neue Dienstclientklasse 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 in Ihrem Code CrmServiceClient durch die Klasse DataverseServiceClient. Stellen Sie den Projekttyp so ein, dass eine .NET Core-Anwendung erstellt wird, entfernen Sie alle .NET Framework-spezifischen Verweise und NuGet-Pakete, und fügen Sie dann dem Projekt das Paket Microsoft.PowerPlatform.Dataverse.Client hinzu.

Siehe auch

Authentifizierung mit Dataverse-Webdiensten
Verwenden von OAuth mit Dataverse