AppScan Presence 疑難排解

使用 AppScan Presence 時發現錯誤的疑難排解作業。

啟動錯誤

錯誤 原因 解決方案
這個 AppScan Presence 安裝的另一個實例已在執行中。 AppScan Presence 的實例已經從相同目錄執行。
  • Windows：開啟工作管理員並且尋找執行 Presence.exe 處理程序
  • Linux：在指令行中鍵入 ps aux 並且尋找標題為 Presence 的處理程序

金鑰錯誤

當您建立新的 Presence 時，會建立名為 presence.key 的唯一檔案，並且位於已下載的 ZIP 檔中。此金鑰是用於識別 Presence。

在多數情況下，金鑰問題都可以透過 AppScan on Cloud 網站產生新的金鑰並放在 Presence 目錄來解決。如果沒有作用，請建立新的 AppScan Presence 進行私有網站掃描。

錯誤 原因 解決方案
「Presence 金鑰」已過期。請更新金鑰檔並放在 AppScan Presence 目錄中。 AppScan Presence 金鑰會在特定時間長度，或在針對此 Presence 實例建立新的金鑰後到期。 更新 Presence 金鑰檔並放在 Presence 目錄中，或者建立及下載新的 Presence。
找不到「Presence 金鑰」。請驗證金鑰檔位於 AppScan Presence 目錄中，或是從「HCL AppScan on Cloud」網站下載新的金鑰檔。 在 AppScan Presence 目錄中找不到 presence.key 檔案。 更新 AppScan Presence 金鑰檔並放在 AppScan Presence 目錄中，或者建立及下載新的 AppScan Presence。
「Presence 金鑰」無效。請從「HCL AppScan on Cloud」網站下載有效的金鑰檔並放在 AppScan Presence 目錄中。 AppScan Presence 目錄中的 presence.key 檔案無效。 更新 AppScan Presence 金鑰檔並放在 AppScan Presence 目錄中，或者建立及下載新的 AppScan Presence。
Presence 已從「HCL AppScan on Cloud」網站中刪除。請建立新的 Presence（下載及安裝）。 AppScan Presence 已刪除。 建立及下載新的 AppScan Presence。
「Presence 金鑰」使用中。請從「HCL AppScan on Cloud」網站產生新的金鑰檔，或結束目前使用此金鑰的 AppScan Presence 實例。 金鑰檔一次只能由一個 AppScan Presence 的實例使用。此錯誤的兩個常見原因為：
  • AppScan Presence 目錄已複製到不同的機器，或是相同機器上的不同目錄，且兩個實例同時在執行。
  • AppScan Presence 處理程序已在最近幾分鐘內中止，但是伺服器誤以為 Presence 仍在連線中。
 避免在兩個目錄或機器上安裝相同的 AppScan Presences 實例。

如果您停止然後重新啟動 AppScan Presence 處理程序，請等候 5 分鐘然後再試一次。
錯誤 原因 解決方案
「Presence 金鑰」已過期。 金鑰已達到期時間限制，或已針對此實例產生新的金鑰。 透過 AppScan on Cloud 主控台更新 Presence 金鑰檔案，並將其放在該目錄中。
找不到「Presence 金鑰」。 目錄中缺少 presence.key 檔案。 從您的 AppScan on Cloud 伺服器下載金鑰，並將其放在 Presence 資料夾中。
「Presence 金鑰」無效。 presence.key 檔案已損毀，或屬於不同的 AppScan on Cloud 環境。 從 AppScan on Cloud 網站產生並下載有效的金鑰檔案。
Presence 已遭刪除。 Presence 項目已從 AppScan on Cloud 主控台移除。 建立及下載新的 AppScan Presence。
「Presence 金鑰」使用中。 金鑰檔案一次只能由一個實例使用。 確認 Presence 未在其他位置執行。如果程序已中止，請等待 5 分鐘讓 AppScan on Cloud 伺服器完成逾時活動訊號處理後再重新啟動。

連線錯誤

執行 AppScan Presence 的機器必須透過埠 443 連線至下列位址：如果需要 Proxy 才能存取這些位址，請確定在 AppScan Presence 目錄的 appsettings.json 檔案中，於「OutgoingProxyEndpoint」區段進行配置（請參閱 設定 HCL AppScan 資料流量記錄器）。

AppScan Presence 使用特定、自簽 SSL/TLS 憑證。請驗證貴公司的閘道未干擾 SSL/TLS 連線，讓 Presence 無法連線至伺服器。

錯誤 原因 解決方案
無法連線至內部 Proxy (<host:port>) 並出現以下錯誤：<錯誤訊息> AppScan Presence 無法連線至連出 Proxy 伺服器。 請驗證在 appsettings.json 檔案中的「連出 Proxy 端點」區段 ，適當地配置連出 Proxy 主機和埠。
無法對連出 Proxy 伺服器進行鑑別。請在 appsettings.json 中配置外寄 Proxy 使用者名稱與密碼。 AppScan Presence 無法鑑別在位於 AppScan Presence 目錄之 appsettings.json 檔案中定義的連出 Proxy。 請驗證在「連出 Proxy 端點」區段中的 appsettings.json 檔案，適當地配置連出 Proxy 認證。
連接伺服器時發生錯誤。如果問題持續發生，請確認網際網路連線是否正常。如果需要 Proxy，請在 appsettings.json 中進行配置，再重新啟動 AppScan Presence。 AppScan Presence 無法連線至位於 https://cloud.appscan.com 的 AppScan on Cloud 伺服器 請驗證此機器可以連線至 cloud.appscan.com 位址（未遭貴公司的防火牆封鎖），且防火牆不會干擾來自伺服器的 SSL 資料流量。

如果需要 Proxy，請確定已在 AppScan Presence 目錄的 appsettings.json 檔案中，於「連出 Proxy 端點」區段中適當進行配置。

通道啟動錯誤

  • Web 應用程式掃描：請確定機器可以存取受測伺服器。

錯誤 原因 解決方案
無法連線至內部 Proxy (<host:port>) 並出現以下錯誤：<錯誤訊息> AppScan Presence 無法連線至已在 appsettings.json 檔案中配置的內部 Proxy。 請驗證 appsettings.json 的「內部 Proxy 端點」區段已適當地配置內部 Proxy 主機和埠，且目前的機器可以存取此 Proxy 伺服器。
正在檢查起始 URL︰<起點 URL>
後面接續以下其中一個項目：
  • 警告：已接收無效的 HTTP 回應
  • 警告：已接收 HTTP 回應狀態：<HTTP 錯誤狀態>
  • 警告：失敗並出現以下錯誤：<錯誤訊息>
 當執行 Web 應用程式掃描時，AppScan Presence 嘗試存取應用程式的起始 URL 以確定機器可以存取受測的網站。這些警告指出此測試失敗，但是掃描仍然會啟動。 如果掃描失敗，請驗證執行 AppScan Presence 的機器可以存取受測的網站。如果需要 Proxy，請在 AppScan Presence 目錄的 appsettings.json 檔案中，於「內部 Proxy 端點」區段進行配置。
通道用戶端無法啟動 AppScan Presence 無法啟動專用網站掃描處理程序。 請參閱 AppScan Presence 日誌以及聯絡「支援」。

細項錯誤

錯誤 原因 解決方案
無法更新所需元件 <元件名稱>。請參閱 AppScan Presence 日誌。 AppScan Presence 無法下載及安裝指定元件的更新。 請確定執行 AppScan Presence 的使用者帳戶具有 AppScan Presence 目錄以及系統暫存目錄的寫入許可權。如果問題持續發生，請參閱 AppScan Presence 日誌以及聯絡「支援」。