AppScan Presence のトラブルシューティング
AppScan 360° 環境内で AppScan Presence を操作したときに検出されるエラーのトラブルシューティングタスク。。
起動のエラー
| エラー | 原因 | 解決方法 |
|---|---|---|
| この AppScan Presence インストールの別のインスタンスが既に実行されています。 | AppScan Presence のインスタンスが、同じディレクトリーから既に実行されています。 |
|
キーのエラー
AppScan 360° で新しい Presence を作成すると、presence.key という名前の固有のファイルが生成され、ダウンロードした ZIP ファイルに含められます。このキーは、ローカル AppScan 360° インスタンスに対する Presence を識別します。
ほとんどの場合、キーの問題は、AppScan 360° Web コンソールで新しいキーを生成して、そのキーを Presence ディレクトリーに格納することで解決します。
| エラー | 原因 | 解決方法 |
|---|---|---|
| プレゼンス・キーの有効期限が切れています。 | キーが有効期限に達したか、このインスタンス用に新しいキーが生成されました。 | Presence キーファイルを AppScan 360° コンソールから更新し、ディレクトリーに配置します。 |
| プレゼンス・キーが見つかりませんでした。 | presence.key ファイルがディレクトリーにありません。 |
AppScan 360° サーバーからキーをダウンロードして、Presence フォルダーに配置します。 |
| プレゼンス・キーが無効です。 | presence.key ファイルは破損しているか、別の AppScan 360° 環境に属しています。 |
AppScan 360° Web サイトから有効なキーファイルを生成してダウンロードします。 |
| Presence が削除されました。 | Presence エントリーが AppScan 360° コンソールから削除されました。 | 新しい AppScan Presence を作成してダウンロードします。 |
| プレゼンス・キーは使用中です。 | 1 つのキーファイルは、同時に 1 つのインスタンスでのみ使用可能です。 | Presence が他の場所で動作していないことを確認します。プロセスが中断された場合は、AppScan 360° サーバーがタイムアウトをハートビートするまで 5 分待ってから再起動します。 |
接続のエラー
AppScan Presence を実行しているマシンは、AppScan 360°サーバー URL (https://appscan360.yourdomain.com) に対してポート 443 (またはカスタム構成ポート) で安定した接続を確立している必要があります。
AppScan 360°サーバーに到達するためにプロキシーが必要な場合は、appsettings.json ファイルを OutgoingProxyEndpoint セクションでプロキシーを構成します。
| エラー | 原因 | 解決方法 |
|---|---|---|
| 内部プロキシーへの接続に失敗しました。 | Presence が指定された発信プロキシーに到達できませんでした。 | OutgoingProxyEndpoint の下で appsettings.json のプロキシーホスト/ポート設定を確認します。 |
| 発信プロキシー・サーバーに対して認証できません。 | プロキシーの資格情報が正しくありません。 | OutgoingProxyEndpoint のセクションで、ユーザー名とパスワードを更新します (appsettings.json において) |
| サーバーへの接続でエラーが発生しました。 | Presence は AppScan 360° オンプレミスサーバーに到達できません。 |
1. AppScan 360° URL がマシンから到達可能であることを確認します。 2.内部ファイアウォールが AppScan 360° ホストへのトラフィックを許可していることを確認します。 3.自己署名証明書に干渉する可能性のある SSL インスペクションツールを確認します。 |
トンネル起動のエラー
Presence マシンが、テスト対象のアプリケーションに直接ネットワークアクセスできることを確認します。
| エラー | 原因 | 解決方法 |
|---|---|---|
| 内部プロキシーへの接続に失敗しました。 | Presenceは ターゲットアプリケーションとの通信に使用されるプロキシーに到達できませんでした。 | InternalProxyEndpoint 設定を確認します (appsettings.json において)。 |
| 警告: 無効な HTTP 応答/状況を受信しました。 | Presence は開始 URL に到達しましたが、アプリがエラーを返しました。 | Presence を実行しているマシンが、ターゲット Web サイトにアクセスする権限を持っていることを確認します。ローカル WAF または IP ホワイトリストを確認します。 |
| トンネルクライアントを開始できませんでした。 | プライベートサイトのスキャンプロセスを初期化できませんでした。 | インストールディレクトリーの Presence ログを参照し、社内の AppScan 360° 管理者に連絡します。 |
その他のエラー
| エラー | 原因 | 解決方法 |
|---|---|---|
| 必要なコンポーネントの更新に失敗しました。 | Presence は、AppScan 360° サーバーから更新をダウンロードできませんでした。 | ユーザーアカウントに Presence ディレクトリーとシステムの Temp フォルダーへの書き込み許可があることを確認します。 |