エラーのトラブルシューティング

最終公開日 : Oct 24, 2026
このトピックでは、Secure Private Access のセットアップ中に発生する可能性のあるエラーの一部をリストします。
「証明書エラー」(/ja-jp/citrix-secure-private-access/2308/spa-onprem-troubleshooting#certificate-errors) 「データベース作成エラー」(/ja-jp/citrix-secure-private-access/2308/spa-onprem-troubleshooting#database-creation-errors) 「StoreFront の障害」(/ja-jp/citrix-secure-private-access/2308/spa-onprem-troubleshooting#storefront-failures) 「パブリックゲートウェイ/コールバックゲートウェイの障害」(/ja-jp/citrix-secure-private-access/2308/spa-onprem-troubleshooting#public-gateway-callback-gateway-failures) 「Secure Private Access Server に到達できません」(/ja-jp/citrix-secure-private-access/2308/spa-onprem-troubleshooting#secure-private-access-server-not-reachable)

証明書エラー

エラーメッセージ: 1つ以上のGatewayサーバーから証明書を自動的に取得できません。 回避策: Citrix Virtual Apps and Desktops の場合と同様に、Gateway証明書を更新します。

データベース作成エラー

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

StoreFront™ で発生する問題

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

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

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

セキュアプライベートアクセスサーバーに到達できません

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

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

エラーメッセージ: 接続チェックに失敗しました
データベース接続チェックは、複数の理由により失敗する可能性があります。
  • ファイアウォールにより、Secure Private Access プラグインホストマシンからデータベースサーバーに到達できません。
    解決策: データベースポート (デフォルトポート 1433) がファイアウォールで開いているか確認してください。
  • Secure Private Access プラグインホストマシンには、データベースに接続する権限がありません。
    解決策: Secure Private Access の SQL データベース権限 を参照してください。

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

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

認証に関する問題

Secure Private AccessランタイムサービスのIIS認証構成は、統合Windows認証 (IWA) がサポートされていないため、機能しない可能性があります。

その他の項目

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

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

セキュアプライベートアクセス用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. マシンIDにdb_ownerロールを割り当てます。
    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サーバーログインを作成します。ログインがすでに作成されている場合は、この手順を無視できます。
    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に権限を追加します。