若要與 Qualys 整合,您必須為具有 管理員 角色的 Qualys 使用者或具有完整範圍 的讀取者 角色提供基本認證。
Qualys 設定
- 若要設定 Qualys 整合,您需要 Qualys 執行個體的API_URL,例如 “qualysapi.qg1.apps.qualys.co.uk”。 你可以在這裡找到它。
- 如果找不到:
- 登錄您的 Qualys 帳戶。
- 前往幫助→。
- 您會在 [安全性作業中心 ] ([SOC) ] 底下看到必要的資訊。
- 如果找不到:
- 您需要至少具有 讀取資產 許可權的使用者認證,才能成功從連接器擷取資料。 若要建立具有「讀取資產」角色的使用者:
- 登錄 Qualys。
- 移至 管理 區域。
- 移至 [角色管理] 區段。
- 選取 [新增角色]。
- 提供角色名稱,例如「讀取資產」。
- 如需角色許可權,請勾選 API 存取。
- 從 Modules 下拉式清單中,選擇 Asset View 。
- 若要限制許可權,請選擇 變更 資產檢視選取模組中的選項。
- 請務必至少在「資產管理許可權」下啟用「讀取資產」。
- 將新建立的角色新增至您要在 Exposure Management Qualys 連接器中驗證的使用者。
- 在 管理 下,轉到 用戶管理。
- 選取您使用 Exposure Management Qualys 連接器上線的使用者,然後選擇 [編輯]。
- 在 「角色和範圍」下,將先前各節中建立的「讀取資產」角色新增至使用者指派的角色。
- 在 [編輯範圍] 底下,選取 [允許使用者檢視存取所有物件] 以允許此使用者完整範圍。
- 將 「讀取資產 」角色指派儲存給使用者。
在暴露管理中建立 Qualys 連線
若要在曝光管理中建立與 Qualys 的連線,請遵循下列步驟:
- 從 [曝光管理] 導覽開啟 [資料連接器] ,然後在 [Qualys] 磚中選取 [ 連線 ]。
- 輸入您的 Qualys API URL 和驗證認證,然後選取 [連線]。
擷取的資料
Qualys 連接器會擷取運算裝置上的資料,包括機器和虛擬機器,以及從這些資產的 Qualys 中取得的弱點發現項目。 它還檢索一些網路資料以識別這些裝置。
| 類別 | 屬性 |
|---|---|
| 資產/裝置 | - 閘道位址 - FQDN - IP 位址 - MAC 位址 - 作業系統資訊 - Qualys 重要性資料 |
| 漏洞發現項目 | Qualys 會擷取其擷取資產的 CVE 發現項目。 |
疑難排解 Qualys 資料連接器
以下是設定 Qualys 連接器時可能出現的一些常見問題,以及如何解決這些問題的建議。
| 錯誤類型 | 疑難排解動作 |
|---|---|
| 錯誤碼 401:授權失敗 | 授權失敗表示認證可能不正確,或可能沒有足夠的許可權來存取 Qualys 資料。 檢查您的憑證並確保它們正確且有效。 此外,請檢查您的認證是否具有必要的許可權。 如需如何指派適當角色和範圍的詳細資訊,請參閱 Qualys 設定一節 。 您可以執行下列專案來驗證使用者認證: curl -u “user:password” -h “x-requested-with: curl” -x “POST”-d “action=list” “https://qualysapi.qg1.apps.qualys.ca/qps/rest/2.0/search/am/hostasset” >output.txt |
| 錯誤碼 409:權限可能不足 | Qualys 連接器使用需要特定權限的 knowledge_base API。 您可以在 此 Qualys API 文件的知識庫區段中查看更多詳細資料。 若要驗證提供的使用者是否具有足夠的權限,請執行下列命令並確認其成功: curl -u “user:password” -h “x-requested-with: curl” -x “POST”-d “action=list”“https://qualysapi.qg1.apps.qualys.ca/api/2.0/fo/knowledge_base/vuln/” >output.txt 如果失敗,請參閱 Qualys 檔以緩解。 |
| 錯誤代碼 403: 禁止存取錯誤 | 此錯誤表示提供的認證缺乏執行所要求 API 的必要許可權。 使用設定 區段中所述的適當許可權更新您的認證,並確定它們至少具有讀取資產許可權。 |
| 錯誤代碼 404: 找不到錯誤 | 此錯誤表示找不到要求的端點可連線。 確認您的 Qualys API 端點正確無誤,如需詳細資訊,請參閱 設定區段 。 |
| 錯誤代碼 429 “請求太多” | 系統會定期從已設定的外部提供者提取資料,這可能對並行要求數目有限制。 建議您為連接器建立專用使用者或帳戶,以避免達到此限制。 |
| 「暫時中斷連線」或「暫時失敗」錯誤訊息 | 如果此錯誤訊息顯示時沒有任何其他資訊,請驗證 API 端點 (連接器組態,並) 認證。 如果這些有效且問題無法自行解決,請聯絡支援。 |
| 在擷取的資料中看不到我的資產或 Qualys 報告的弱點 | 如需 Qualys 連接器預期擷取之資料的說明,請參閱擷取的資料。 如果仍有遺漏資料,請聯絡支援團隊。 |
| 必須設定 Qualys 允許的 IP,才能讓曝光管理連接器存取 Qualys | 請參閱此處,瞭解如何新增要新增至允許清單的 IP 集:將 IP 位址列入允許清單。 |
後續步驟
設定 Qualys 資料連接器之後:
- 檢閱您的受攻擊面對應 以查看 Qualys 數據
- 探索安全性建議
- 設定安全性方案 以追蹤補救進度