Azure Key Vaultクライアントの設定

適用先
Dynamics 365 for Finance and Operations

高度な証明書ストレージ機能により、Microsoft Dynamics 365 for Finance and Operations で使用される証明書のストレージの種類を定義する機会が提供されます。

新しい機能で使用できる証明書を格納するためのオプションは 2 つあります。 このオプションを定義するには、新しいパラメーター [システム パラメーター ] で高度な証明書ストアを使用 ([システム管理] \ [設定] \ [システム パラメーター]、[ 全般] タブ):

  • ローカル ストレージ。 このオプションは、オンプレミス展開オプションだけでなく、あらゆる種類のオンプレミス開発環境でも使用できます。 この場合は、[ 高度な証明書ストアを使用する] パラメーターを [いいえ] に設定する必要があります。 このオプションは、証明書を検証して操作する必要がある開発および検証の目的で DEV 環境用に設定することをお勧めします。
  • Azure Key Vaultストレージ。 このオプションは、クラウド展開オプションと共に使用する必要があり、オンプレミス展開環境やあらゆる種類のオンプレミス開発環境で使用できます。 [高度な証明書ストアを使用する] パラメーターを [はい] に設定する必要があります。 これは、Azure Cloud の PROD 環境の唯一のオプションです。

このイメージは、Key Vault クライアントを設定する方法を示しています。

Azure Key Vaultに保存されている証明書を操作するには、事前に手順を実行する必要があります。 「Azure Key Vaultストレージの保守」4040294記事で説明されている必要なすべての設定。 Azure Key Vault ストレージを設定した後、Microsoft Dynamics 365 for Finance and Operations で証明書へのリンクを設定する必要があります。

証明書が Azure KeyVault にインストールされたらすぐに、アプリケーションでセットアップする必要があります。 セットアップ手順は次のとおりです。

  1. システム管理モジュール (システム管理\セットアップ\ Key Vault パラメーター) で、"Key Vault パラメーター" というフォームを開きます。 Key Vault パラメーターの新しいインスタンスを作成し、名前と説明を定義します。
  2. 「全般」タブに移動し、Azure Key Vaultストレージとの統合に使用する必須パラメータを指定します。
  • Key Vault URL - シークレット参照で定義されていない場合は、既定のキー コンテナー URL。
  • Key Vaultクライアント - 認証用の Azure Key Vault ストレージに関連付けられた AD アプリケーションの対話型クライアント ID。
  • Key Vault 秘密鍵 - Azure Key Vaultストレージへの認証に使用される AD アプリケーションに関連付けられた秘密鍵。

このイメージは、Key Vault クライアントを設定する方法を示しています。

注: 複数のキー コンテナー ストレージを使用する場合、それぞれに、Microsoft Dynamics 365 for Finance and Operations で作成された Key Vault パラメーターの個別のインスタンスが必要です。

  1. [証明書] タブに移動し、[追加] ボタンをクリックしてそこに証明書を追加します。 証明書ごとに、次のデータを入力する必要があります。
  • 名前と説明。
  • Key Vault 証明書シークレット - 証明書へのシークレット参照。

注: Key Vault 証明書シークレットは、次のような形式である必要があります。

vault://<KeyVaultName*>/<SecretName>/<SecretVersion*>

記号 "*" でマークされた属性は省略可能であり、属性 <SecretName> は必須です。 そのため、ほとんどの場合は、次の形式で Key Vault シークレット キーを定義するだけで十分です。

vault:///<SecretName>

Key Vault シークレット キーにシークレット バージョンが含まれていない場合は、システムは有効期限が最新のアクティブな証明書を取得します。

注: Azure Key Vault ストレージ機能は、証明書のキャッシュによって拡張されました。 そのため、次のことを行うことを強くお勧めします。

  • Key Vault 証明書シークレットでシークレット バージョンを指定します。
  • 既存の証明書の新しいバージョンを Key Vault ストレージにアップロードした後、Microsoft Dynamics 365 for Finance and Operations の "Key Vault 証明書シークレット" パラメーターでシークレット バージョンを更新する必要があります。

Validate 関数を使用すると、証明書への参照を正しく定義し、証明書が有効であるかどうかをチェックできます。