秘密鍵の保護

最終公開日 : Nov 03, 2026
Related information
高度な構成

はじめに

証明書はFASサーバー上の組み込みデータベースに保存されます。関連する秘密鍵は、FASサーバーのネットワークサービスアカウントによって保存され、デフォルトでエクスポート不可としてマークされます。
秘密鍵には2種類あります。
  • Citrix_RegistrationAuthority証明書テンプレートからの、登録機関証明書に関連付けられた秘密鍵。
  • Citrix_SmartcardLogon証明書テンプレートからの、ユーザー証明書に関連付けられた秘密鍵。
実際には、2つの登録機関証明書があります。Citrix_RegistrationAuthority_ManualAuthorization（デフォルトで24時間有効）とCitrix_RegistrationAuthority（デフォルトで2年間有効）です。
Federated Authentication Service (FAS) 管理コンソールの Initial Setup タブのステップ3で、Authorize をクリックすると、FASサーバーはキーペアを生成し、Citrix_RegistrationAuthority_ManualAuthorization証明書に対する証明書署名要求を証明機関に送信します。これは一時的な証明書で、デフォルトで24時間有効です。証明機関はこの証明書を自動的に発行しません。その発行は、証明機関で管理者によって手動で承認される必要があります。証明書がFASサーバーに発行されると、FASはCitrix_RegistrationAuthority_ManualAuthorization証明書を使用して、Citrix_RegistrationAuthority証明書（デフォルトで2年間有効）を自動的に取得します。FASサーバーは、Citrix_RegistrationAuthority証明書を取得するとすぐに、Citrix_RegistrationAuthority_ManualAuthorizationの証明書とキーを削除します。
登録機関証明書に関連付けられた秘密鍵は特に機密性が高いです。なぜなら、登録機関証明書ポリシーにより、秘密鍵を所有する者は、テンプレートで構成されたユーザーセットに対して証明書要求を発行できるからです。結果として、この鍵を制御する者は、そのセット内の任意のユーザーとして環境に接続できます。
FASサーバーは、組織のセキュリティ要件に合った方法で秘密鍵を保護するように構成できます。以下のいずれかを使用します。
  • 登録機関証明書とユーザー証明書の秘密鍵の両方に、Microsoft Enhanced RSA and AES Cryptographic ProviderまたはMicrosoft Software Key Storage Providerを使用する。
  • 登録機関証明書の秘密鍵にはTrusted Platform Module (TPM) チップを備えたMicrosoft Platform Key Storage Providerを使用し、ユーザー証明書の秘密鍵にはMicrosoft Enhanced RSA and AES Cryptographic ProviderまたはMicrosoft Software Key Storage Providerを使用する。
  • 登録機関証明書とユーザー証明書の秘密鍵の両方に、HSMデバイスを備えたHardware Security Module (HSM) ベンダーのCryptographic ServiceまたはKey Storage Providerを使用する。

秘密鍵の構成設定

FASを3つのオプションのいずれかを使用するように構成します。テキストエディターを使用してCitrix.Authentication.FederatedAuthenticationService.exe.configファイルを編集します。ファイルのデフォルトの場所は、FASサーバー上のProgram Files\Citrix\Federated Authentication Serviceフォルダー内です。
ローカライズされた画像
FAS は、サービス開始時にのみ構成ファイルを読み取ります。値が変更された場合、新しい設定を反映させるには FAS を再起動する必要があります。
Citrix.Authentication.FederatedAuthenticationService.exe.config ファイルで、関連する値を次のように設定します。
Citrix.TrustFabric.ClientSDK.TrustAreaJoinParameters.ProviderLegacyCsp (CAPI API と CNG API を切り替える)
値 コメント
真 CAPI API を使用
false (デフォルト) CNG API を使用
Citrix.TrustFabric.ClientSDK.TrustAreaJoinParameters.ProviderName (使用するプロバイダーの名前)
値 コメント
マイクロソフト拡張RSAおよびAES暗号化プロバイダー デフォルトの CAPI プロバイダー
Microsoft ソフトウェア キー ストレージ プロバイダー 既定のCNGプロバイダー
Microsoft プラットフォーム キー ストレージ プロバイダー 既定のTPMプロバイダー。TPMはユーザーキーには推奨されません。TPMは登録機関キーにのみ使用してください。仮想化環境でFASサーバーを実行する予定がある場合は、仮想化がサポートされているかどうかをTPMおよびハイパーバイザーベンダーに確認してください。
HSMベンダーCSP/キー ストレージ プロバイダー HSMベンダーによって提供されます。値はベンダーによって異なります。仮想化環境でFASサーバーを実行する予定がある場合は、仮想化がサポートされているかどうかをHSMベンダーに確認してください。
Citrix.TrustFabric.ClientSDK.TrustAreaJoinParameters.ProviderType (CAPI APIの場合にのみ必須)
値 コメント
24 既定。Microsoft KeyContainerPermissionAccessEntry.ProviderType プロパティ PROV_RSA_AES 24 を参照します。CAPIでHSMを使用しており、HSMベンダーが別途指定しない限り、常に24である必要があります。
Citrix.TrustFabric.ClientSDK.TrustAreaJoinParameters.KeyProtection (FASが秘密鍵操作を実行する必要がある場合、ここで指定された値を使用します) 秘密鍵の「エクスポート可能」フラグを制御します。ハードウェアでサポートされている場合、TPMキー ストレージの使用を許可します。
値 コメント
保護なし 秘密キーはエクスポート可能です。
GenerateNonExportableKey デフォルト。秘密キーはエクスポートできません。
GenerateTPMProtectedKey 秘密キーはTPMを使用して管理されます。秘密キーは、ProviderNameで指定したProviderName（例：Microsoft Platform Key Storage Provider）を介して保存されます。
Citrix.TrustFabric.ClientSDK.TrustAreaJoinParameters.KeyLength (秘密キーのサイズをビット単位で指定します)
値 コメント
2048 デフォルト。1024または4096も使用できます。
構成ファイルの設定は、次のようにグラフィカルに表示されます（インストール時のデフォルトは赤で表示）。
ローカライズされた画像

構成シナリオの例

例1

この例では、登録機関証明書の秘密キーと、Microsoft Software Key Storage Providerを使用して保存されたユーザー証明書の秘密キーについて説明します。
これはデフォルトのインストール後構成です。追加の秘密鍵構成は不要です。

例 2

この例では、登録機関証明書の秘密鍵がMicrosoft Platform Key Storage Providerを介してFASサーバーのマザーボードのハードウェアTPMに保存され、ユーザー証明書の秘密鍵がMicrosoft Software Key Storage Providerを使用して保存されることを示します。
このシナリオでは、FASサーバーのマザーボード上のTPMが、TPMメーカーのドキュメントに従ってBIOSで有効にされ、その後Windowsで初期化されていることを前提としています。<https://docs.microsoft.com/ja-jp/previous-versions/windows/it-pro/windows-vista/cc749022(v=ws.10)>を参照してください。

FAS管理コンソールの使用

FAS管理コンソールはオフラインの証明書署名要求を実行できないため、組織が登録機関証明書に対してオンラインの証明書署名要求を許可しない限り、その使用は推奨されません。
初期のFASセットアップを実行する際、証明書テンプレートを展開し、証明機関を設定した後、サービスを承認する前（構成シーケンスのステップ3）に、次の手順を実行します。
ステップ1: 構成ファイルを編集し、以下の行を次のように変更します。
ローカライズされた画像
ファイルは次のようになります。
ローカライズされた画像
一部のTPMは鍵長を制限します。デフォルトの鍵長は2048ビットです。ハードウェアでサポートされている鍵長を指定してください。
ステップ2: Citrix Federated Authentication Serviceを再起動して、構成ファイルから値を読み取ります。
ステップ3: サービスを承認します。
ステップ4: 証明機関サーバーから保留中の証明書要求を手動で発行します。登録機関証明書が取得されると、管理コンソールのセットアップシーケンスのステップ3が緑色になります。この時点で、登録機関証明書の秘密鍵はTPMで生成されています。証明書はデフォルトで2年間有効です。
登録機関証明書の秘密キーがTPMに正しく保存されていることを確認するには、以下のPowerShellコマンドを使用します。登録機関証明書の秘密キーがTPMに保存されている場合、PrivateKeyProviderフィールドはMicrosoft Platform Crypto Providerに設定されます。
Add-PSSnapin Citrix.Authentication.FederatedAuthenticationService.V1
Get-FasAuthorizationCertificate -FullCertInfo -Address localhost
手順5： 設定ファイルを以下のように編集し直します。
ローカライズされた画像
注：
FASはTPMで保護されたキーを持つユーザー証明書を生成できますが、大規模な展開ではTPMハードウェアが遅すぎる場合があります。
手順6： FASを再起動します。これにより、サービスは設定ファイルを再読み込みし、変更された値を反映します。その後の自動秘密キー操作は、ユーザー証明書キーに影響します。これらの操作は秘密キーをTPMに保存せず、Microsoftソフトウェアキー記憶プロバイダーを使用します。
手順7： FAS管理コンソールでルールタブを選択し、インストールと構成で説明されているように設定を編集します。

PowerShellの使用

登録機関証明書は、PowerShellを使用してオフラインで要求できます。これは、証明機関がオンライン証明書署名要求を介して登録機関証明書を発行することを望まない組織に適しています。FAS管理コンソールを使用してオフラインの登録機関証明書署名要求を行うことはできません。
手順1： 管理コンソールを使用してFASの初期構成を行う際に、最初の2つの手順（「証明書テンプレートの展開」と「証明機関のセットアップ」）のみを完了します。
ローカライズされた画像
手順2： 証明機関サーバーで、証明書テンプレートMMCスナップインを追加します。Citrix_RegistrationAuthority_ManualAuthorizationテンプレートを右クリックし、テンプレートの複製を選択します。
全般タブを選択します。名前と有効期間を変更します。この例では、名前はOffline_RAで、有効期間は2年です。
ローカライズされた画像
手順3： 証明機関サーバーで、証明機関MMCスナップインを追加します。証明書テンプレートを右クリックします。新規を選択し、発行する証明書テンプレートをクリックします。作成したばかりのテンプレートを選択します。
ステップ 4: FASサーバーで次のPowerShellコマンドレットをロードします。
Add-PSSnapin Citrix.Authentication.FederatedAuthenticationService.V1
ステップ 5: FASサーバーのTPM内でRSAキーペアを生成し、FASサーバーで次のPowerShellコマンドレットを入力して証明書署名要求を作成します。注: 一部のTPMはキー長を制限します。デフォルトのキー長は2048ビットです。ご使用のハードウェアでサポートされているキー長を指定してください。
New-FasAuthorizationCertificateRequest -UseTPM $true -address \<FQDN of FAS Server>
例:
New-FasAuthorizationCertificateRequest -UseTPM $true -address fashsm.auth.net
次のように表示されます。
ローカライズされた画像
注:
  • Id GUID（この例では「5ac3d8bd-b484-4ebe-abf8-4b2cfd62ca39」）は、後続のステップで必要になります。
  • このPowerShellコマンドレットは、登録機関証明書の秘密キーを生成するために使用される1回限りの「上書き」と考えてください。
  • このコマンドレットを実行すると、FASの起動時に構成ファイルから読み取られた値がチェックされ、使用するキー長が決定されます（デフォルトは2048）。
  • この手動のPowerShellによって開始された登録機関証明書の秘密キー操作では、-UseTPMが$trueに設定されているため、システムはTPMを使用するために必要な設定と一致しないファイルからの値を無視します。
  • このコマンドレットを実行しても、構成ファイルの設定は変更されません。
  • 後続の自動FASによって開始されたユーザー証明書の秘密キー操作では、FASの起動時にファイルから読み取られた値が使用されます。
  • FASサーバーがユーザー証明書を発行して、TPMによって保護されたユーザー証明書秘密キーを生成する場合、構成ファイルでKeyProtection値をGenerateTPMProtectedKeyに設定することも可能です。
キーペアの生成にTPMが使用されたことを確認するには、キーペアが生成されたときに、FASサーバーのWindowsイベントビューアーのアプリケーションログを確認します。
ローカライズされた画像
注：「」
続いて：
ローカライズされた画像
注：「プロバイダー: Microsoft Platform Crypto Provider」
手順6： 証明書要求セクションをテキストエディターにコピーし、テキストファイルとしてディスクに保存します。
ローカライズされた画像
手順7： FASサーバーでPowerShellに次のように入力して、証明書署名要求を証明機関に送信します。
certreq -submit -attrib "certificatetemplate:\<certificate template from step 2>" \<certificate request file from step 6>
例：
certreq -submit -attrib "certificatetemplate:Offline_RA" C:\Users\Administrator.AUTH\Desktop\usmcertreq.txt
次のように表示されます：
ローカライズされた画像
この時点で、証明機関リストウィンドウが表示される場合があります。この例の証明機関では、http（上）とDCOM（下）の両方の登録が有効になっています。利用可能な場合は、DCOMオプションを選択してください。
ローカライズされた画像
証明機関が指定されると、PowerShellはRequestIDを表示します。
ローカライズされた画像
手順8： 証明機関サーバーで、証明機関MMCスナップインの保留中の要求をクリックします。要求IDをメモします。次に、要求を右クリックして発行を選択します。
手順9： 発行された証明書ノードを選択します。発行されたばかりの証明書を見つけます（要求IDが一致するはずです）。ダブルクリックして証明書を開きます。詳細タブを選択します。ファイルへコピーをクリックします。証明書のエクスポートウィザードが起動します。次へをクリックします。ファイル形式について、以下のオプションを選択します。
ローカライズされた画像
形式は「暗号メッセージ構文標準 – PKCS #7 証明書 (.P7B)」で、「可能であれば、証明のパスにあるすべての証明書を含める」が選択されている必要があります。
手順10： エクスポートした証明書ファイルをFASサーバーにコピーします。
手順11： FASサーバーで次のPowerShellコマンドレットを入力して、登録機関証明書をFASサーバーにインポートします。
ローカライズされた画像
例：
ローカライズされた画像
以下が表示されます。
ローカライズされた画像
登録機関証明書の秘密キーがTPMに正しく保存されていることを確認するには、以下のPowerShellコマンドを使用します。登録機関証明書の秘密キーがTPMに保存されている場合、PrivateKeyProviderフィールドはMicrosoft Platform Crypto Providerに設定されます。
Add-PSSnapin Citrix.Authentication.FederatedAuthenticationService.V1
Get-FasAuthorizationCertificate -FullCertInfo -Address localhost
ステップ12: FAS管理コンソールを閉じてから再起動します。
ローカライズされた画像
注: 「このサービスを承認する」のステップに緑色のチェックマークが表示されます。
ステップ13: FAS管理コンソールでルールタブを選択し、インストールと構成で説明されている設定を編集します。

例3

この例では、HSMに保存されている登録機関証明書の秘密キーとユーザー証明書の秘密キーについて説明します。この例では、HSMが構成済みであることを前提としています。HSMには、たとえば「HSM_Vendor's Key Storage Provider」のようなプロバイダー名があります。
FASサーバーを仮想化環境で実行する予定がある場合は、ハイパーバイザーのサポートについてHSMベンダーに確認してください。
ステップ1. 管理コンソールを使用してFASの初期設定を行う際は、「証明書テンプレートの展開」と「証明機関のセットアップ」の最初の2つのステップのみを完了してください。
ローカライズされた画像
ステップ2: HSMのProviderName値が何であるべきかについては、HSMベンダーのドキュメントを参照してください。HSMがCAPIを使用している場合、ドキュメントではプロバイダーがCryptographic Service Provider (CSP) と呼ばれることがあります。HSMがCNGを使用している場合、プロバイダーはKey Storage Provider (KSP) と呼ばれることがあります。
ステップ3: 設定ファイルを次のように編集します。
ローカライズされた画像
ファイルは次のようになります。
ローカライズされた画像
このシナリオでは、HSM が CNG を使用しているため、ProviderLegacyCsp の値は false に設定されています。HSM が CAPI を使用している場合、ProviderLegacyCsp の値は true に設定する必要があります。HSM が CAPI と CNG のどちらを使用しているかについては、HSM ベンダーのドキュメントを参照してください。また、非対称 RSA キー生成でサポートされているキー長についても、HSM ベンダーのドキュメントを参照してください。この例では、キー長はデフォルトの 2048 ビットに設定されています。指定するキー長がハードウェアでサポートされていることを確認してください。
手順 4: Citrix Federated Authentication Service を再起動して、構成ファイルから値を読み取ります。
手順 5: FAS 管理コンソールの タブで をクリックして、HSM 内に RSA キーペアを生成し、証明書署名要求を作成します。
手順 6: キーペアが HSM で生成されたことを確認するには、Windows イベントログのアプリケーションエントリを確認します。
ローカライズされた画像
注：[プロバイダー: HSM ベンダーのキーストレージプロバイダー]
手順 7: 証明機関サーバーで、証明機関 MMC の ノードを選択します。
ローカライズされた画像
要求を右クリックし、 を選択します。
注：「このサービスを承認する」の手順に緑色のチェックマークが付いています。
ローカライズされた画像
手順 8: FAS 管理コンソールで タブを選択し、「インストールと構成」の説明に従って設定を編集します。

FAS 証明書ストレージ

FAS は、証明書を保存するために FAS サーバー上の Microsoft 証明書ストアを使用しません。組み込みデータベースを使用します。
登録機関証明書の GUID を特定するには、FAS サーバーで次の PowerShell コマンドレットを入力します。
Add-pssnapin Citrix.a&ast;
Get-FasAuthorizationCertificate –address \<FAS server FQDN>
例えば、Get-FasAuthorizationCertificate –address cg-fas-2.auth.net:
ローカライズされた画像
ユーザー証明書のリストを取得するには、次のように入力します。
Get-FasUserCertificate –address \<FAS server FQDN>
例えば、Get-FasUserCertificate –address cg-fas-2.auth.net
ローカライズされた画像
注:
HSM を使用して秘密キーを保存する場合、HSM コンテナは GUID で識別されます。HSM 内の秘密キーの GUID は、以下を使用して取得できます。
Get-FasUserCertificate –address \<FAS server FQDN> -KeyInfo $true
例:
Get-FasUserCertificate –address fas3.djwfas.net -KeyInfo $true
ローカライズされた画像

関連情報

  • 「インストールと構成」(/ja-jp/federated-authentication-service/2305/install-configure.html)は、FASのインストールと構成に関する主要なリファレンスです。
  • 一般的なFAS展開については、「フェデレーション認証サービスアーキテクチャの概要」(/ja-jp/federated-authentication-service/2305/deployment-architectures.html)の記事にまとめられています。
  • その他の「ハウツー」記事は、「高度な構成」(/ja-jp/federated-authentication-service/2305/config-manage.html)の記事で紹介されています。