エラーのトラブルシューティング
このトピックでは、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 をメモしてください。解決策:-
「StoreFront Store URL」に、StoreFrontエントリが表示されていない場合は追加します。
-
「エラーメッセージ」: StoreFrontエントリの構成に失敗しました:
<Store URL>「解決策」:-
PowerShellの実行ポリシー制限が適用されている可能性があります。詳細については、PowerShellスクリプトコマンド
Get-ExecutionPolicyを実行してください。 -
制限されている場合は、これをバイパスして、StoreFront構成スクリプトを手動で実行する必要があります。
-
「設定」をクリックし、次に「統合」タブをクリックします。
-
「StoreFront Store URL」において、エラーが発生したStoreFront URLの項目を特定してください。
-
このストア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構成を手動で実行する必要があります。-
「設定」をクリックし、次に「統合」タブをクリックします。
-
StoreFront Store URL にて、エラーが発生したストアフロントのURLを特定してください。
-
このStore URLの横にある「スクリプトのダウンロード」ボタンをクリックし、対応するStoreFrontインストールが存在するマシンで、このPowerShellスクリプトを管理者権限で実行します。
注:ストアフロント パワーシェル スクリプトを実行するには、管理者権限でウィンドウズ x64互換のパワーシェル ウィンドウを開き、ConfigureStorefront.ps1を実行します。ストアフロント スクリプトはウィンドウズ パワーシェル (x86) と互換性がありません。 -
パブリックゲートウェイ/コールバックゲートウェイの障害
エラーメッセージ: Gatewayエントリの作成に失敗しました:
<Gateway URL> または Callback Gatewayエントリの作成に失敗しました: <Callback Gateway URL>
解決策:
障害が発生したパブリックゲートウェイまたはコールバックゲートウェイのURLをメモします。ウィザードを使用してSecure Private Accessを設定した後、「設定」タブからゲートウェイエントリを編集できます。
-
「設定」をクリックし、次に「統合」タブをクリックします。
-
パブリックゲートウェイアドレスまたはコールバックゲートウェイアドレス、および障害が発生した仮想IPアドレスを更新します。
セキュアプライベートアクセスサーバーに到達できません
エラーメッセージ: IISプールを更新できませんでした。IISプールを再起動できませんでした
解決策:
-
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プラグインホストマシンがデータベースに接続し、データベーススキーマを作成する権限を持っている必要があります。
リモートデータベース:
リモートデータベースの権限を設定するには、次の手順を実行します。
-
CitrixAccessSecurity<Site Name>という名前の構文で空のデータベースを作成します。ここで、<Site Name>はSecure Private Accessサイト名です。(例: CitrixAccessSecuritySPA)。CREATE DATABASE CitrixAccessSecurity<SiteName> -
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] -
マシンIDにdb_ownerロールを割り当てます。
USE CitrixAccessSecurity<SiteName>EXEC sys.sp_addrolemember [db_owner], 'DOMAIN1\HOST1$'ALTER USER [DOMAIN1\HOST1$] WITH DEFAULT_SCHEMA = dbo;
ローカルデータベース:
ローカルデータベースの権限を設定するには、次の手順を実行します。
-
CitrixAccessSecurity<Site Name>という名前の構文で空のデータベースを作成します。ここで、<Site Name>はSecure Private Accessサイト名です。(例: CitrixAccessSecuritySPA)。CREATE DATABASE CitrixAccessSecurity<SiteName> -
NT AUTHORITY\SYSTEMユーザーのSQLサーバーログインを作成します。ログインがすでに作成されている場合は、この手順を無視できます。USE CitrixAccessSecurity<SiteName>CREATE LOGIN [NT AUTHORITY\SYSTEM] FROM WINDOWS -
“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に権限を追加します。