基本的なトラブルシューティング

最終公開日 : Oct 24, 2026
このトピックでは、Secure Private Access のセットアップ中またはセットアップ後に発生する可能性のあるエラーの一部をリストします。
証明書エラー
データベース作成エラー
ストアフロントの障害
パブリックゲートウェイ/コールバックゲートウェイの障害
セキュア プライベート アクセス サーバーに到達できません
Related information
監視とトラブルシューティング

証明書エラー

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

データベース作成エラー

  • エラーメッセージ: データベースの作成に失敗しました
    解決策: 自動ケースの場合 - マシンは、SQL Server 上のデータベース内にテーブルを作成するための 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™ における障害について

  • エラーメッセージ: 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が存在する場合は、このエントリを削除します。Settings > Integrationsページからスクリプトを手動でダウンロードして実行します。
  • エラーメッセージ：StoreFront構成はローカルではありません：<Store URL>
    ウィザードを使用してSecure Private Accessをセットアップした後、Settingsタブからゲートウェイエントリを編集できます。このエラーが発生したStoreFrontストアURLをメモしておいてください。
    解決策：
    この問題は、StoreFrontがSecure Private Accessと同じマシンにインストールされていない場合に発生します。StoreFrontをインストールしたマシンで、StoreFront構成を手動で実行する必要があります。
    1. Settingsをクリックし、次にIntegrationsタブをクリックします。
    2. StoreFront Store URLで、エラーが発生したURLエントリを特定します。
    3. このストアURLの横にある「Download Script」ボタンをクリックし、対応するStoreFrontインストールが存在するマシンで、このPowerShellスクリプトを管理者権限で実行します。このスクリプトは、すべてのStoreFrontマシンで実行する必要があります。
    注：
    StoreFront PowerShellスクリプトを実行するには、管理者権限でWindows x64互換のPowerShellウィンドウを開き、ConfigureStorefront.ps1を実行します。このスクリプトは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アドレスを更新します。

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

エラーメッセージ: 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/2402/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サーバーの詳細を更新する」を参照してください。

その他の項目

初回セットアップを完了できません

初回セットアップ中にDirectorの構成が失敗した場合、ライセンスサーバーを再構成できないことがあります。
解決策：
license_serverテーブルを手動でクリーンアップします。

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

Secure Private Access診断サポートバンドルを作成するには、次の手順を実行します。
  • 管理者権限でPowerShellまたはコマンドプロンプトウィンドウを開きます。
  • Secure Private Access のインストールフォルダーの直下にある Admin\AdminConfigTool という名前のフォルダーへ、現在の作業ディレクトリを移動させてください (例えば、Windows のコマンドプロンプトや 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. Assign the db_owner role to the “NT AUTHORITY\SYSTEM” user.
    USE CitrixAccessSecurity<SiteName>
    EXEC sys.sp_addrolemember [db_owner], 'NT AUTHORITY\SYSTEM'
    ALTER USER [NT AUTHORITY\SYSTEM] WITH DEFAULT_SCHEMA = dbo;
データベースを手動で作成すると、ダウンロードされたデータベーススクリプトがマシンIDに権限を追加します。

トラブルシューティングログのログレベルを変更する

トラブルシューティングログはデフォルトのエラーログレベルです。
To change the log level for the troubleshooting logs, in the runtime service appsettings.json (C:\Program Files\Citrix\Citrix Access Security\Runtime\RuntimeService) update restrictedToMinimumLevel for TroubleshootingSql to one of the following values:
-  Information
-  Debug
-  Warning
-  Error

"TroubleshootingSql": {
  "restrictedToMinimumLevel": "Error",
  "batchPostingLimit": 50,
  "batchPeriod": "00:00:05" // 5 seconds
}