一般的なエラーのトラブルシューティング

最終公開日 : Oct 24, 2026
このトピックでは、Secure Private Access の設定中に発生する可能性のあるいくつかのエラーをリストします。
証明書エラー
データベース作成エラー
ストアフロントのエラー
パブリックゲートウェイ/コールバックゲートウェイの障害
セキュアプライベートアクセスサーバーに到達できません

証明書エラー

エラーメッセージ: 1つ以上のGatewayサーバーから証明書を自動的に取得できません。
このエラーメッセージは、パブリックなNetScaler® Gatewayアドレスを追加しようとしたときに、証明書の取得に問題がある場合に表示されます。この問題は、Secure Private Access の設定時、または設定完了後に設定を更新する際に発生する可能性があります。
回避策: Citrix Virtual Apps and Desktops の場合と同様に、ゲートウェイ証明書を更新します。

データベース作成エラー

  • エラーメッセージ: データベースの作成に失敗しました
    解決策: 自動ケースの場合 - マシンは、SQLサーバー上のデータベース内にテーブルを作成するために、READ、WRITE、UPDATE の権限を持っている必要があります。
  • エラーメッセージ: データベースの作成に失敗しました: データベースが既に存在します。
    このエラーメッセージは、以下のいずれかのシナリオで表示されることがあります。
    • データベースの構成中に自動構成オプションが選択されている場合。
    • 管理者がデータベースを作成する場合、それは空のデータベースである必要があります。データベースが空でない場合、このエラーメッセージが表示されることがあります。
      解決策: 空のデータベースを作成する必要があります。
    • Secure Private Access をアンインストールし、同じサイト名でセットアップを再試行した場合。この場合、以前のインストールからのデータベースは削除されていません。
      解決策: データベースを手動で削除する必要があります。
    • スクリプトを使用してデータベースを手動でセットアップすることを選択し（「データベースの構成」ページで「手動構成」を選択）、その後「自動構成」オプションに変更したが、同じサイト名を使用した場合。この場合、スクリプトの実行中に同じ名前のデータベースが既に作成されています。
      解決策: サイトの名前を変更してから、スクリプトを再度実行する必要があります。
    • マシンに、SQL Server 上のデータベース内にテーブルを作成するための READ、WRITE、UPDATE 権限がない。
      解決策: マシンで適切な権限を有効にします。詳細については、「データベースのセットアップに必要な権限」を参照してください。
  • エラーメッセージ: データベースの作成に失敗しました: 接続に失敗しました
    解決策:
    • マシンからのデータベースネットワーク接続を確認します。SQL Server のポートがファイアウォールで開いていることを確認してください。
    • リモート SQL Server を使用している場合は、SQL Server に Secure Private Access マシンの ID (Domain\hostname$) でログインが作成されているか確認します。
    • リモート SQL Server を使用している場合は、マシン ID に適切な役割（システム管理者役割）が割り当てられていることを確認します。
    • ローカルSQLサーバーを使用している場合（インストーラーからではない場合）、NT AUTHORITY\SYSTEMユーザーにログインが作成されている必要があるか確認してください。

ストアフロント™ の障害

  • エラーメッセージ: StoreFront エントリの作成に失敗しました: <Store URL>
    StoreFrontエントリが表示されない場合は、設定タブから更新してください。ウィザードを使用してSecure Private Accessを設定した後、設定タブからStoreFrontエントリを編集できます。このエラーが発生したStoreFrontストアURLをメモしてください。
    解決策:
    1. 設定をクリックし、次に統合タブをクリックします。
    2. StoreFrontストアURLで、StoreFrontエントリが表示されない場合は追加します。
  • エラーメッセージ: StoreFront エントリの構成に失敗しました: <Store URL>
    解決策:
    1. PowerShellの実行ポリシーに制限がある可能性があります。詳細については、PowerShellスクリプトコマンド Get-ExecutionPolicy を実行してください。
    2. 制限されている場合は、これをバイパスし、StoreFront構成スクリプトを手動で実行する必要があります。
    3. 設定をクリックし、次に統合タブをクリックします。
    4. StoreFrontストアURLで、エラーが発生したStoreFront URLエントリを特定します。
    5. このストアURLの横にあるスクリプトのダウンロードボタンをクリックし、対応するStoreFrontインストールが存在するマシンで、このPowerShellスクリプトを管理者権限で実行します。このスクリプトは、すべてのStoreFrontマシンで実行する必要があります。
    注:
    アンインストール後にインストールを再試行する場合は、StoreFront構成（StoreFront > store> Delivery Controller™ -> Secure Private Access）に「Secure Private Access」という名前のエントリがないことを確認してください。Secure Private Accessが存在する場合は、このエントリを削除してください。設定 > 統合ページからスクリプトを手動でダウンロードして実行してください。
  • エラーメッセージ: StoreFront構成はローカルではありません: <Store URL>
    ウィザードを使用してSecure Private Accessをセットアップした後、設定タブからゲートウェイエントリを編集できます。このエラーが発生したStoreFrontストアURLをメモしてください。
    解決策:
    この問題は、StoreFrontがSecure Private Accessと同じマシンにインストールされていない場合に発生します。StoreFrontをインストールしたマシンで、StoreFront構成を手動で実行する必要があります。
    1. 設定をクリックし、次に統合タブをクリックします。
    2. StoreFrontストアURLで、エラーが発生したStoreFront URLエントリを特定します。
    3. このストアURLの横にある「スクリプトのダウンロード」ボタンをクリックし、対応するStoreFrontインストールが存在するマシンで、このPowerShellスクリプトを管理者権限で実行します。このスクリプトは、すべてのStoreFrontマシンで実行する必要があります。
    注:
    StoreFront PowerShellスクリプトを実行するには、管理者権限を持つWindows x64互換のPowerShellウィンドウを開き、その後ConfigureStorefront.ps1を実行してください。StoreFrontスクリプトは、Windows PowerShell (x86)とは互換性がありません。
  • Error message: "Get-STFStoreService : Exception of type 'Citrix.DeliveryServices.Framework.Feature.Exceptions.RegistryKeyNotFoundException' was thrown." while running StoreFront script using PowerShell.
    このエラーは、StoreFrontスクリプトがx86互換のPowerShellウィンドウで実行された場合に発生します。
    解決策:
    StoreFront PowerShellスクリプトを実行するには、管理者権限でWindows x64互換のPowerShellウィンドウを開き、次にConfigureStorefront.ps1を実行します。

パブリックゲートウェイ/コールバックゲートウェイの障害

エラーメッセージ: ゲートウェイエントリの作成に失敗しました: <Gateway URL> または コールバックゲートウェイエントリの作成に失敗しました: <Callback Gateway URL>
解決策:
失敗が発生したパブリックゲートウェイまたはコールバックゲートウェイのURLをメモしてください。ウィザードを使用してSecure Private Accessをセットアップした後、設定タブからゲートウェイエントリを編集できます。
  1. 設定をクリックし、次に統合タブをクリックします。
  2. 失敗が発生したパブリックゲートウェイアドレスまたはコールバックゲートウェイアドレス、および仮想IPアドレスを更新します。

Secure Private Accessサーバーへの接続に失敗しました

エラーメッセージ: IISプールの更新に失敗しました。IISプールの再起動に失敗しました
解決策:
Internet Information Services (IIS) のアプリケーションプールに移動し、次のアプリケーションプールが開始され、実行されていることを確認します。
  • セキュア プライベート アクセス 実行時プール
  • セキュアプライベートアクセス 管理プール
また、デフォルトのIISサイト "Default Web Site" が稼働していることも確認してください。

データベース接続チェックの失敗

エラーメッセージ: 接続チェックに失敗しました
データベース接続チェックは、複数の理由により失敗する可能性があります。
  • ファイアウォールが原因で、Secure Private Accessプラグインホストマシンからデータベースサーバーに到達できません。
    解決策: ファイアウォールでデータベースポート（デフォルトポート1433）が開いているか確認してください。
  • Secure Private Accessプラグインホストマシンには、データベースに接続する権限がありません。
    解決策: 「Secure Private AccessのSQLデータベース権限」(/ja-jp/citrix-secure-private-access/2311/spa-onprem-troubleshooting#sql-database-permissions-for-secure-private-access)を参照してください。

ゲートウェイ接続チェックに失敗しました。公開証明書を取得できません

エラーメッセージ: インストール後の構成が「ゲートウェイ接続チェックに失敗しました。公開証明書を取得できません…」というエラーで失敗します。
解決策:
  • 設定ツールを使用して、ゲートウェイ公開証明書をSecure Private Accessデータベースに手動でアップロードします。
  • 管理者権限でPowerShellまたはコマンドプロンプトウィンドウを開きます。
  • Change the directory to the Admin\AdminConfigTool folder under the Secure Private Access installation folder (for example, cd "C:\Program Files\Citrix\Citrix Access Security\Admin\AdminConfigTool")
  • 次のコマンドを実行します。
    .\AdminConfigTool.exe /UPLOAD_PUBLIC_GATEWAY_CERTIFICATE <PublicGatewayUrl> <PublicGatewayCertificatePath>

アプリケーション列挙の失敗

StoreFront URLまたはNetScaler Gateway URLに末尾のスラッシュ (/) が含まれている場合、アプリケーションの列挙が中断されます。
解決策:
StoreFrontストアURLまたはNetScaler Gateway URLの末尾のスラッシュを削除します。詳細については、セットアップ後にStoreFrontまたはNetScaler Gatewayサーバーの詳細を更新するを参照してください。

その他の問題

セキュア プライベート アクセス診断サポートバンドルの作成

Secure Private Access診断サポートバンドルを作成するには、次の手順を実行します。
  • 管理者権限でPowerShellまたはコマンドプロンプトウィンドウを開きます。
  • セキュアプライベートアクセス インストールフォルダーの配下にある Admin\AdminConfigTool という名前のフォルダーへディレクトリを移動してください (例: cd "C:\Program Files\Citrix\Citrix Access Security\Admin\AdminConfigTool")。
  • 次のコマンドを実行します。
    .\AdminConfigTool.exe /SUPPORTBUNDLE <output folder>

Secure Private Access の SQL データベースに対するアクセス権限

データベースを自動的に作成するには、Secure Private Accessプラグインホストマシンがデータベースに接続し、データベーススキーマを作成する権限を持っている必要があります。
リモートデータベース:
リモートデータベースの権限を設定するには、次の手順を実行します。
  1. CitrixAccessSecurity<Site Name> という名前の構文で空のデータベースを作成します。ここで、<Site Name> は Secure Private Access サイト名です。(例: CitrixAccessSecuritySPA)。
    CREATE DATABASE CitrixAccessSecurity<SiteName>
  2. Secure Private Access仮想マシンのマシンIDのSQLサーバーログインを作成します。たとえば、Secure Private Accessブローカーマシン名がHOST1で、マシンドメインがDOMAIN1の場合、マシンIDは「DOMAIN1\HOST1$」です。ログインがすでに作成されている場合は、この手順を無視できます。
    USE CitrixAccessSecurity<SiteName>
    CREATE LOGIN [DOMAIN1\HOST1$] FROM WINDOWS
    ドメイン名は、次のクエリを使用して見つけることができます。
    SELECT DEFAULT_DOMAIN()[DomainName]
  3. db_ownerロールをマシンIDに割り当てます。
    USE CitrixAccessSecurity<SiteName>
    EXEC sys.sp_addrolemember [db_owner], 'DOMAIN1\HOST1$'
    ALTER USER [DOMAIN1\HOST1$] WITH DEFAULT_SCHEMA = dbo;
ローカルデータベース:
ローカルデータベースの権限を設定するには、次の手順を実行します。
  1. CitrixAccessSecurity<Site Name>という名前の構文で空のデータベースを作成します。ここで、<Site Name>はSecure Private Accessサイト名です（例：CitrixAccessSecuritySPA）。
    CREATE DATABASE CitrixAccessSecurity<SiteName>
  2. NT AUTHORITY\SYSTEMユーザーのSQL Serverログインを作成します。ログインがすでに作成されている場合は、この手順を無視できます。
    USE CitrixAccessSecurity<SiteName>
    CREATE LOGIN [NT AUTHORITY\SYSTEM] FROM WINDOWS
  3. 「NT AUTHORITY\SYSTEM」という名前のユーザーに db_owner ロールを割り当てます。
    USE CitrixAccessSecurity<SiteName>
    EXEC sys.sp_addrolemember [db_owner], 'NT AUTHORITY\SYSTEM'
    ALTER USER [NT AUTHORITY\SYSTEM] WITH DEFAULT_SCHEMA = dbo;
データベースを手動で作成すると、ダウンロードされたデータベーススクリプトがマシンIDに権限を追加します。