SOAR 遷移作業常見問題
取得 SOAR 遷移程序常見問題的解答。瞭解常見問題的解決方法,以及順利轉換的最佳做法。
遷移範圍和影響
問:如何確認遷移作業是否成功?
當「CloudIAM Enabled」處於啟用狀態,且 Cloud Logging 連續 30 天記錄到零個需要客戶採取行動的舊版 SOAR API 呼叫時,環境即完成遷移。請按照下列步驟驗證每個階段:
- 查看平台和 Identity and Access Management (IAM) 狀態:依序前往「SOAR 設定」>「授權管理」,然後查看系統版本號碼旁的文字:
- 第 1 階段後:系統版本號碼旁會顯示 Google.com。
- 第 2 階段 IAM 遷移後:系統版本號碼旁會同時顯示「Google.com」和「已啟用 CloudIAM」。
在 Cloud Logging 中確認沒有舊版 API 呼叫:
- 確認 SOAR 作業記錄 (
resource.labels.namespace_name="chronicle-soar") 是否傳送至 Google Cloud 專案的 Cloud Logging。統一 Google Security Operations 執行個體會自動啟用記錄匯出功能,SOAR 獨立執行個體則會使用記錄檔寫入者服務帳戶設定,詳情請參閱「收集 SOAR 平台記錄檔」。所有舊版 API 淘汰警告 (labels.auth_deprecation="true") 都會以WARNING嚴重程度作業記錄的形式,在此處發出,而非在 Cloud 稽核記錄中發出,且只有客戶可採取行動的警告 (labels.actionable_by="Customer") 會匯出至您的 Google Cloud 專案 (內部 Google UI 和系統呼叫會自動篩除)。 在 Google Cloud 控制台,依序前往「Logging」>「Logs Explorer」,將日期範圍設為「30 days」,然後執行下列查詢:
resource.labels.namespace_name="chronicle-soar" labels.auth_deprecation="true"確認查詢連續 30 天傳回零筆記錄項目,如以下範例所示:
圖 1:Logs Explorer 顯示零個舊版 API 淘汰記錄項目。 如果出現項目,請在Logs Explorer中執行下列查詢,並檢查產生的欄位,找出仍呼叫舊版
siemplify-soar.com端點的元件:- 過時的 Content Hub (現成) 整合:
resource.labels.namespace_name="chronicle-soar" labels.auth_deprecation="true" labels.is_system="true" labels.is_custom="false"請查看
labels.integration_name、labels.integration_version、labels.latest_integration_version和觸發元件 (labels.action_name、labels.connector_name、labels.job_name、labels.playbook_name),找出要更新的 Content Hub 套件。- 手動發出 HTTP 呼叫的自訂 Python 程式碼:
resource.labels.namespace_name="chronicle-soar" labels.auth_deprecation="true" labels.is_custom="true"檢查
labels.integration_name、labels.action_name、labels.connector_name、labels.job_name和labels.playbook_name,找出自訂指令碼。- 直接呼叫舊版 API (
AppKey) 的外部指令碼和第三方工具:
resource.labels.namespace_name="chronicle-soar" labels.auth_deprecation="true" labels.is_system="false"檢查
labels.app_key(舊版 API 金鑰 ID)、labels.via_xlb(外部輸入的"true"),以及textPayload(Deprecated direct AppKey authentication detected (Route: ROUTE).) 中呼叫的 HTTP 路由,如下例所示:
圖 2. 展開的淘汰記錄項目,顯示 app_key標籤和 HTTP 路由。- 遠端代理歸因 (
labels.is_remote="true"):表示來自遠端代理上執行程式碼的舊版通話。請先將遠端代理程式升級至2.6.2以上版本,並遷移至服務帳戶驗證 (請參閱「遷移遠端代理程式驗證基礎架構」)。遠端代理程式升級並設定 Google Cloud 服務帳戶後,代理程式本身的控制層輪詢會使用 OAuth 2.0;遠端代理程式 SDK 呼叫的完整元件標籤歸因功能,正在正式環境中分階段推出。如果遷移代理後仍有項目,請檢查該代理上是否有過時的整合項目或自訂程式碼。
- 確認 SOAR 作業記錄 (
驗證遠端代理程式和 Webhook:如果環境使用遠端代理程式或傳入 Webhook,請確認這些項目可在新基礎架構上運作:
- 遠端代理:依序前往「SOAR Settings」>「Advanced」>「Remote Agents」,確認每個遷移的代理都回報「Live」狀態。
- Webhook:將測試事件傳送至每個更新後的區域
: ingestWebhook 網址,並確認 Google SecOps 擷取了警告。
問:為什麼需要遷移?
我們正在翻新 SOAR 基礎架構,將其遷移至 Google Cloud。這項重大升級可帶來多項重要優勢,包括提升可靠性、強化安全性、提高法規遵循程度,以及更精細的存取控管。此外,這項服務也整合 Model Context Protocol (MCP),可讓您存取代理式 AI 功能。
遷移作業包括:
- 運用 Google 頂尖的 API 層,強化 SOAR 的可靠性和監控功能。這個層級提供領先業界的 API 解決方案,具備配額管理、稽核和觀測能力等進階功能。
- 解鎖角色式存取控管 (RBAC) 功能,控管整個平台的各項功能和資料。
- 提供更完善的法規遵循功能,例如 VPC Service Controls、資料落地和客戶自行管理的加密金鑰 (CMEK)。
問:遷移範圍為何?
遷移作業涉及下列元件:
- 將 SOAR 專案遷移至客戶擁有的 Google Cloud 專案。
- 將 SOAR 驗證和權限遷移至 Google Cloud IAM。
- 將 SOAR API 遷移至 Chronicle API。
- 遷移遠端代理驗證基礎架構。
問:遷移後會立即有哪些異動?
遷移完成後,您會立即看到幾項重大異動:
- GCP 專案擁有權:SOAR 專案會從 Google 擁有的專案遷移至客戶擁有的 Google Cloud 專案。
- 驗證:
- Unified SecOps 客戶:無異動。驗證作業仍由 Google Cloud IAM 管理。
- SOAR 獨立版客戶:驗證作業現在由 Google Cloud IAM 管理。對於使用 SAML 的使用者,這代表採用員工身分聯盟,且 SAML 設定將不再儲存及管理於 SOAR 系統本身,進而強化安全控管。
- RBAC:使用者授權將更精細,並透過 IAM 管理。環境和 SOC 角色會繼續在 SOAR 模組中,使用識別資訊提供者 (IdP) 群組管理。
- 稽核記錄:稽核記錄會更詳細,並在 Cloud 稽核記錄中管理。
- 新網址 (僅限 SOAR):SOAR 獨立使用者會收到新的網址 (新網域),用於存取 SOAR。
問:Google 如何通知客戶/合作夥伴這項遷移作業?
所有客戶和合作夥伴都會看到產品內彈出式視窗,其中包含遷移日期和表單連結。系統會提示他們確認遷移日期和時段。
問:SOAR 繫結至 Google Cloud 專案後,基礎架構費用會改變嗎?
不會,費用不會受到影響。前端應該不會有任何變化。專案不會執行任何新資源,因此不會產生相關費用。
問:如何將專案連結至 SOAR?
Google 會將 SOAR 專案遷移至 Google Cloud 專案。如果您是 Unified SecOps 客戶,我們已有您的 Google Cloud 專案 ID。如果您是 SOAR 獨立客戶,則須提供 Google Cloud 專案 ID。
問:如果客戶已部署 Google SecOps,我們應該使用與 SIEM 相同的專案 ID,還是需要另外建立專案?
如要統一 Google SecOps 部署作業 (一個 SIEM、一個 SOAR),請使用與 SIEM 相關聯的現有 Google Cloud 專案 ID。這樣一來,您就能統一管理管理流程,例如 RBAC 和記錄。
問:如果 Google SecOps 執行個體有特殊考量 (例如 VPC Service Controls (VPC-SC)),需要採取哪些步驟?
如要啟用遷移功能,您必須在 VPC-SC 政策中定義輸入和輸出規則。如果您的 Google Cloud 專案已啟用 VPC Service Controls,請與支援團隊聯絡,取得這些特定規則的詳細指引。
VPC-SC 不支援兩項 API 功能:
- Webhook
- 應對手冊核准連結
問:如何確認遷移作業是否成功?
依序前往「SOAR Settings」>「License Management」,確認是否成功完成。 第 1 階段結束後,系統版本號碼後方會顯示 Google.com。 將 SOAR 權限遷移至 IAM 角色的第 2 階段完成後,系統版本號碼後方會顯示「Google.com」和「CloudIAM Enabled」。
停機時間和持續性
問:遷移期間是否會停機?影響為何?
可以。預期的停機時間如下:
- SOAR 獨立客戶最多 2 小時。
- Google SecOps 客戶最多 1.5 小時。
在這段期間,您將無法登入平台。SOAR 服務 (包括擷取、playbook、工作) 將暫停,但 SIEM 服務會在背景繼續執行。
問:SOAR 服務恢復運作後,是否會自動擷取停機期間產生的資料?
可以。系統恢復上線後,擷取作業和應對手冊就會恢復運作,並處理停機期間產生或擷取的任何快訊。
問:停機時間開始時,執行中的應對手冊會受到什麼影響?
應對手冊服務會在遷移開始前關閉,部分執行中的應對手冊可能會失敗,需要手動重新啟動,或在遷移完成後繼續執行。
問:如果遷移期間發生問題,是否有復原或應變計畫?
可以。遷移程序會完整保留現有的 SOAR 執行個體 (但會關閉)。如果遷移程序未順利完成,我們可以切換回現有執行個體,並移除新執行個體。這項復原程序最多需要 30 分鐘。我們會進行廣泛測試並密切監控,同時安排值班人員待命,確保遷移順利完成。
如果遷移後發生存取問題,可能是驗證設定有誤。您需要與識別資訊、IDP 或 Google Cloud 管理員協調,使用疑難排解指南找出並解決問題。如果問題持續發生,或與存取權無關,請提交支援單記錄問題,並追蹤解決進度。
問:何時可以遷移至 Chronicle API 端點?遷移順序為何?
執行個體完成遷移階段 1 後 (Google.com 顯示在「SOAR 設定」>「License Manager」),Chronicle API 端點就會啟用,您可按照任何順序和自己的步調遷移元件,包括外部 API 指令碼、遠端代理程式、Content Hub 整合、Webhook 和 IAM 權限,甚至在點選「啟用 IAM」之前就能進行。在 2027 年 3 月 31 日前,舊版 siemplify-soar.com API 端點和 AppKey 驗證機制會與 Chronicle API 並行運作,不會造成停機。
如要將外部指令碼或自訂整合服務遷移至 Chronicle API,請按照下列步驟操作:
- 授予 IAM 權限並在「群組對應」中對應:將必要的預先定義 Chronicle IAM 角色授予服務帳戶或 Workload Identity Federation 主體,或先執行 SOAR IAM 遷移指令碼 (如要從現有 SOAR 權限群組產生自訂 IAM 角色),然後在「SOAR 設定」>「進階」>「群組對應」中對應帳戶。按一下「啟用 IAM」後,Google SecOps UI 也會更新,在「Webhook」頁面顯示更新後的
chronicle.googleapis.com網址。 - 更新端點和驗證機制:更新外部指令碼和自訂整合,使用 OAuth 2.0 驗證機制呼叫對應的 Chronicle API 端點。
驗證和權限
問:如何遷移 SOAR 權限群組和權限?
您將在 Google Cloud 控制台使用遷移指令碼,將現有權限群組遷移至 IAM 自訂角色。指令碼也會將自訂角色指派給使用者 (適用於 Cloud Identity 客戶) 或 IdP 群組 (適用於員工身分聯盟客戶)。
問:如果我不想遷移自訂權限群組,只想使用預先定義的角色,該怎麼辦?
您可以選擇不採用自動遷移功能,改為手動將 IdP 群組對應至 Cloud IAM 角色。
問:我們是 SOAR 獨立客戶,使用自訂 SAML 供應商,並手動驗證。如果我們將這項設定變更為 IdP 群組,以便進行 IdP 對應,對現有使用者帳戶會有什麼影響?
假設現有使用者符合其中一個群組,且權限對應正確,則現有使用者帳戶應該不會受到任何影響。不過,如果使用者未對應至群組,就無法登入。 如果權限對應方式不同,使用者會根據新的對應方式獲得新權限。
問:MSSP 使用多個識別資訊提供者時,是否有特定先決條件?
如果客戶在 SOAR 外部驗證頁面設定多個識別資訊提供者,應定義員工身分聯盟來進行驗證,並為每個提供者建立獨立的工作團隊集區。每個提供者都與不同的子網域相關聯。詳情請參閱 MSSP 遷移指南。
問:如何驗證 Chronicle API?
按照「向 Chronicle API 驗證」一文的操作說明進行。
問:存取新版 SOAR API 需要哪些新 IP?
您不需要將任何 IP 位址加入許可清單,即可存取 Chronicle API。您也可以選擇將 Google 服務 IP 範圍和 Google Cloud 資源 IP 範圍中指定的 IP 位址範圍,加入許可清單。
記錄和監控
問:我們已完成第一階段遷移,但 Cloud 稽核記錄中未顯示 SOAR 事件。
- 第 1 階段 (Google.com) 完成後,您可以在 Logging 中查看 SOAR 作業記錄 (
resource.labels.namespace_name="chronicle-soar"下的教戰手冊、Python、ETL 和labels.auth_deprecation="true"警告)。如需設定和查詢操作說明,請參閱「收集 SOAR 平台記錄」。 - Cloud 稽核記錄 (
cloudaudit.googleapis.com):完成階段 1 後,稽核記錄仍會儲存在 SOAR 平台的「稽核」頁面。完成第 2 階段 (啟用 Google Cloud IAM 並將 API 呼叫遷移至chronicle.googleapis.com) 後,SOAR 使用者和 API 稽核事件就會顯示在 Google Cloud 專案的 Cloud 稽核記錄中。在 2027 年 3 月 31 日前,任何仍使用舊版siemplify-soar.com端點的呼叫,都會記錄在內部 SOAR「稽核」頁面,並在 Logging 中發出labels.auth_deprecation="true"警告記錄。
問:如果客戶將 SOAR 資料傳送至代管 BigQuery (BQ) 執行個體,遷移後還能存取這些 BigQuery 資料嗎?
可以。現有的代管 BigQuery 會繼續運作。
物流與支援
問:我可以選擇其他遷移時段嗎?
不行,您無法在建議時段以外的時間遷移。
問:遷移期間,我們會收到即時狀態更新嗎?
遷移程序開始和結束時,您都會收到電子郵件通知。
問:如果遷移後發生問題,該與誰聯絡?
如果遷移後發生存取問題,可能是驗證設定有誤。您需要與識別資訊、IDP 或 Google Cloud 管理員協調,使用疑難排解指南找出並解決問題。如果問題持續發生,或與存取權無關,請提交支援單記錄問題,並追蹤解決進度。
將 SOAR 權限群組遷移至 IAM
以下章節說明將權限遷移至 IAM 期間和之後常見的問題。
遷移工具和指令碼問題
問:為什麼我無法在 Google Cloud 控制台中查看或載入遷移指令碼?
可能原因有兩個:
缺少權限:使用者帳戶必須在 Google Cloud 和 Google SecOps 執行個體中具備足夠權限,才能使用遷移工具。請務必使用具備 Google Cloud 必要 IAM 角色的帳戶登入,且該帳戶必須是 Google SecOps SOAR 的認可使用者。如果 Google Cloud 和 SOAR 使用不同帳戶,可能會導致授權失敗。如果您具備必要權限,卻仍無法載入遷移指令碼,請提交支援單。
SIEM 未使用 Cloud IAM:如果您是 Google SecOps 整合式客戶,請務必使用 IAM 管理平台 SIEM 端的角色和權限。詳情請參閱舊版 RBAC 至功能 RBAC 遷移指南。
問:嘗試執行遷移指令碼時發生錯誤。我該怎麼做?
錯誤 -「群組不存在」:使用
add-iam-policy-binding commands時,請務必在--member標記中使用完整的群組電子郵件地址 (例如your-group@example.com),而非僅使用簡短的群組名稱。與既有角色相關的錯誤:繫結至已有條件式繫結的主體時,可能會發生衝突。如要解決這個問題,請重新執行指令碼,並務必選取「無」,而非「指定新條件」。
遷移後存取問題
問:為什麼在 IAM 遷移後,嘗試存取特定頁面或功能 (例如 Playbook 或 IDE) 時,會收到「403 Forbidden」錯誤?
遷移後出現 403 錯誤,可能代表指派給使用者的 Google Cloud IAM 角色缺少 Google SecOps 平台 SOAR 端所需的權限。如果您使用自訂 IAM 角色,通常會發生這種情況。
查看 Google SecOps 角色和權限。請確認自訂 IAM 角色具備存取必要 SOAR 功能的所有權限。
您也可以使用瀏覽器的開發人員工具,找出傳回 403 錯誤的特定 API 呼叫。回應酬載會記錄缺少的權限,介面中也會顯示通知橫幅,詳細說明所需的存取權。
如果上述方法都無法解決問題,請建立支援單。
權限與角色
問:我手動執行 IAM 遷移作業,未使用提供的工具,現在發生權限問題。該如何解決這個問題?
手動遷移 IAM 有時可能會導致 SOAR 角色缺少必要權限。強烈建議您使用提供的遷移指令碼,確保所有必要權限都已正確設定。如果您仍打算手動遷移,請仔細查看 Google SecOps IAM 權限,建立具備必要權限的自訂角色。
問:遷移後,部分使用者在 SOAR 中的權限似乎比預期多。為什麼會有這項異動?
如果使用者或群組在遷移前已獲派預先定義的 Chronicle 廣泛 Google Cloud 角色,就可能發生這種情況。完成遷移後,Chronicle 預先定義的角色 (例如 chronicle.apiAdmin) 就會自動取得 SOAR 權限。舉例來說,Chronicle API 管理員角色現在會具備 SOAR 管理員權限。
為確保符合最小權限原則,請按照下列步驟操作:
- 在「IAM 角色」頁面中查看預先定義的角色 (包括 Chronicle API 管理員),找出所有指派的主體 (使用者和群組)。
- 確認只有需要 SOAR 權限的使用者獲派這些角色。
- 如要限制特定主體的 SOAR 存取權,請將主體從預先定義的角色中移除,並指派給明確排除 SOAR 管理員權限的自訂角色。
問:遷移作業已成功,但「群組對應」頁面仍顯示「權限群組」欄。為什麼?
遷移成功後,「群組對應」頁面仍會顯示「權限群組」欄,以確保回溯相容性。請勿刪除這些指派作業。該資料欄將於 2027 年 3 月 31 日前移除,不會對客戶造成任何影響。
最佳做法
- 使用遷移指令碼:請盡可能使用 Google Cloud 中的官方遷移指令碼,處理從 SOAR 權限群組轉換至 IAM 角色的作業。
- 查看 IAM 權限:熟悉不同 SOAR 函式和角色所需的 Google Cloud IAM 權限。
- 全面測試:遷移後,請測試不同使用者角色和人物誌的存取權,確保一切運作正常。
- 聯絡支援團隊:如果錯誤持續發生或出現非預期行為,請與支援團隊聯絡,並盡可能提供詳細資訊。
還有其他問題嗎?向社群成員和 Google SecOps 專家尋求解答。