.NET アプリケーションの認証

  • [アーティクル]

このトピックには、.NET を使用してコード化および構築されたアプリケーションを開発する際のガイダンスが含まれています。

.NET Framework アプリケーション

アプリケーションの開発に .NET Framework を使用している場合は、Xrm.Tooling の名前空間内のクラスを使用して、Microsoft Dataverse の Webサービスを簡単に認証し接続することができます。

SDK アセンブリの Xrm.Tooling クラスは IOrganizationService のインターフェース メソッドを使用します。 これはプラグインおよびワークフロー活動で使用されるプログラミングと同じスタイルで、.NET Framework アプリケーションのどこででも使用できる 1 つのスタイルです。 Microsoft.Xrm.Tooling.Connector.CrmServiceClient の使用を推奨します Web サービス接続のクラス。

Xrm.Tooling クラスが提供する利点には次のものが含まれます。

  • 接続文字列を使用して接続情報を定義できます。
  • OAuth および Microsoft 365 両方のクレームベース認証をサポートします。
  • マルチスレッド環境で実行されるアクションのスレッド セーフです。
  • 共通の Windows Presentation Foundation (WPF) ログイン コントロールを提供し、Windows クライアント アプリケーションからの一貫したサインイン体験を実現します。
  • サインインの資格情報を安全に保存し、保存された資格情報を再利用することで、初回のサインイン後の自動サインインをサポートします。
  • 実行されたアクションの組み込み診断トレースおよびパフォーマンス レポートにより、組織の要求に基づいて構成できます。
  • x509 証明書認証をサポートします。

Xrm.Tooling クラスは、IOrganizationService インターフェイス メソッドを使用するよう最適化されます。

Web API の使用を希望する場合は、Microsoft.Xrm.Tooling.Connector を使用できます。CrmServiceClient.ExecuteCrmWebRequest OAuth を使用する限り、Xrm.Tooling クラスで提供される他のすべての利点を伴う、Web API を使用している要求を構成するメソッドです。

詳細情報: XRM ツールを使用して Windows のクライアント アプリケーションを作成する

.NET Framework バージョン

クライアント アプリケーションを作成するときには、.NET Framework バージョン 4.6.2 以降を使用します。 Transport Level Security (TLS) 1.2 またはそれより優れたセキュリティを使用するアプリケーションのみが接続できます。 TLS 1.2 は .NET Framework 4.5.2 で使用される既定のプロトコルではありませんが、.NET Framework 4.6.2 またはそれ以降では既定のプロトコルです。

SDK アセンブリを使用しない .NET Framework アプリケーション

任意の SDK アセンブリに依存しないことを希望する場合、任意の SDK アセンブリに依存せずに Microsoft Dataverse で OAuth を使用する で説明されたパターンを使用することもできます。 SDK アセンブリなしで、OData Restful Web サービス (Web API および OData グローバル検索サービス) のみを使用できます。 Web API データ操作サンプル (C#) ではこのアプローチを示します。

.NET Core および .NET 6 アプリケーション

Microsoft.CrmSdk.XrmTooling.CoreAssembly で使用可能な SDK API、および NuGet パッケージが所有する他の "crmsdk" は、.NET Core コードの開発をサポートしません。

.NET Core アプリケーション開発用に、前述の CrmServiceClient クラスの後にパターン化された DataverseServiceClient クラスがあります。 Nuget.org から Microsoft.PowerPlatform.Dataverse.Client パッケージをダウンロードして、お持ちのアプリケーションでこの新しいサービス クライアント クラスの使用を開始することができます。 DataverseServiceClient 用のドキュメントとサンプル コードは、今後のドキュメント リリースで利用できるようになります。

CrmServiceClient を使用する既存の .NET Framework ベースのアプリケーション コードを更新するには、使用しているコードの CrmServiceClient の代わりに、DataverseServiceClient クラスを使用します。 プロジェクト タイプを設定して .NET Core アプリケーションを構築し、.NET Framework 固有の参照と NuGet パッケージを削除してから、Microsoft.PowerPlatform.Dataverse.Client パッケージをプロジェクトに追加する必要があります。

関連情報

Dataverse Web サービスによる認証
Dataverse で OAuth を使用する

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。