遷移遠端代理程式驗證基礎架構
本文說明如何使用 Google Cloud 服務帳戶遷移遠端代理程式基礎架構。這項遷移作業只會影響驗證基礎架構,您不必遷移或更換遠端代理程式執行個體或主機。
事前準備
請確認您已具備以下條件:
- 在 Google Cloud中建立服務帳戶所需的權限。
- 建立服務帳戶金鑰所需的角色。
- 遠端代理程式最低需求版本為 2.6.2。
網路和 Private Service Connect 需求
遷移驗證基礎架構後,遠端代理程式會透過標準 Google API 與 Chronicle API 通訊,而非舊版 *.siemplify-soar.com 端點。
傳出端點許可清單
確認防火牆允許從遠端代理主機到下列端點的 TCP 通訊埠 443 傳出 HTTPS 流量:
- 允許傳出 HTTPS 流量至 Google Security Operations Chronicle API 位置端點 (
<var>REGION</var>-chronicle.googleapis.com,在ONE_PLATFORM_URL_DOMAIN中設定,例如asia-southeast1-chronicle.googleapis.com) 和租戶發布者主機名稱 (SERVER_API_ROOT)。 - 允許傳出 HTTPS 流量至 Google Cloud 驗證端點:
oauth2.googleapis.com(用於服務帳戶權杖交換)、sts.googleapis.com和iamcredentials.googleapis.com(用於透過 Workload Identity Federation 進行無金鑰驗證)。 - 允許傳出 HTTPS 流量傳送至用於 Podman 或 Docker 部署作業的容器登錄檔,例如
*.pkg.dev(包括us-docker.pkg.dev) 和gcr.io(用於 Artifact Registry) 或docker.io。
詳情請參閱「網路和防火牆需求」。
Private Service Connect 設定
如果遠端代理程式透過私人連線連至 Google API (例如從地端部署網路、Amazon Web Services (AWS) 或 Microsoft Azure 透過 Cloud Interconnect 或 Cloud VPN 連線),請完成下列設定:
- 在虛擬私有雲中,為 Google API 建立 Private Service Connect 端點 (使用
all-apis或vpc-sc套件)。如需操作說明,請參閱「設定 Google API 的 Private Service Connect」。 - 設定私人 DNS,讓必要端點解析為 Private Service Connect 端點 IP 位址。在 Google Cloud中,為
googleapis.com設定 Cloud DNS 私人區域。在Google Cloud以外,請使用條件式 DNS 轉送或私人託管區域 (例如 AWS Route 53)。 - 在所有遠端代理程式遷移完畢前,請保留任何舊版 SOAR Private Service Connect 連線 (
<var>TENANT</var>.siemplify-soar.com的生產端服務連結)。
建立服務帳戶
服務帳戶是一種特殊的 Google 帳戶,可供應用程式用來執行已授權的 API 呼叫。
如要建立服務帳戶,請按照下列步驟操作:
- 前往 Google Cloud 控制台的「Service Accounts」(服務帳戶) 頁面。 前往「Service Accounts」(服務帳戶)
- 按一下「Create Service Account」(建立服務帳戶)。
- 在「服務帳戶詳細資料」部分,執行下列操作:
- 輸入服務帳戶名稱。
- 輸入服務帳戶說明。
- 按一下「建立並繼續」。
- 在「Permissions」(權限) 部分,執行下列操作:
- 在「Select a role」(選取角色) 清單中,選取「Chronicle SOAR Remote Agent」角色。
- 按一下「繼續」。
- 在「將這個服務帳戶的存取權限授予使用者」部分,點選「完成」。
建立服務帳戶金鑰
必須提供服務帳戶金鑰,才能驗證遠端代理程式。如要建立這個金鑰,請按照下列步驟操作:
- 前往 Google Cloud 控制台的「Service Accounts」(服務帳戶) 頁面。 前往「Service Accounts」(服務帳戶)
- 按一下您建立的服務帳戶名稱。
- 按一下「Keys」(金鑰) 分頁標籤。
- 依序點選「新增金鑰」>「建立新的金鑰」。
- 選取「JSON」做為金鑰類型,然後按一下「建立」。
A JSON file containing the key is downloaded to your computer. - 按一下 [關閉]。
安全儲存金鑰檔案
下載服務帳戶金鑰後,您必須將金鑰移至要執行遠端代理程式的主機。
Podman
- 在電腦上找出下載的 JSON 檔案。
- 將檔案儲存在主機上的安全位置,讓代理程式程序可以存取。
-
在主機上輸入代理服務帳戶金鑰的完整路徑。
AGENT_SERVICE_ACCOUNT_PATH
Docker
- 在電腦上找出下載的 JSON 檔案。
- 將檔案儲存在主機上的安全位置,讓代理程式程序可以存取。
-
在主機上輸入代理服務帳戶金鑰的完整路徑。
AGENT_SERVICE_ACCOUNT_PATH
安裝程式
- 在電腦上找出下載的 JSON 檔案。
- 將檔案儲存在下列位置:
AGENT_SERVICE_ACCOUNT_PATH
- 請記下這個檔案的完整路徑,設定遠端代理程式時會用到。
對應遠端代理程式服務帳戶
為遠端代理程式建立服務帳戶後,您必須在平台中授權,確保代理程式能與 Google SecOps 順利通訊。
如要將服務帳戶存取權或 Workload Identity Federation 存取權授予 Google SecOps,您必須將身分對應至平台的存取控管參數。這項對應作業是必要步驟,可為身分提供必要的 SOC 角色和環境存取權,以便執行自動化工作或 API 作業。
- 依序前往「設定」>「存取管理」>「群組對應」。
- 按一下「新增」圖示 。
在「Add Mapping」(新增對應) 對話方塊中填寫欄位,將身分對應至平台的存取控管參數。
- 在「IdP / User group」(IdP/使用者群組) 欄位中,輸入下列其中一項:
- 服務帳戶的完整電子郵件地址 (如果身分是使用 Cloud Identity 設定)。
- Workload Identity 主體字串 (如果身分是透過員工身分聯盟設定)。
設定下列存取控管欄位:
欄位 說明 權限群組 選取權限群組,定義身分可存取的模組和子模組。 資安營運中心 (SOC) 角色 選取 SOC 角色,定義身分的角色 (例如第 1 級)。 環境 選取該身分可存取的環境或環境群組 (例如「所有環境」)。 群組成員 視需要輸入必要的使用者電子郵件地址。每新增一個電子郵件地址,就按下 Enter 鍵。 受限制的動作 選取受限動作,限制模組內的特定操作。
- 在「IdP / User group」(IdP/使用者群組) 欄位中,輸入下列其中一項:
按一下「新增」。
設定遠端代理程式驗證至 Google Cloud
Podman
如要部署新的代理程式,請參閱「使用 Podman 部署代理程式」。
如要升級代理程式,請參閱「使用 Podman 升級代理程式」一文。
Docker
如要部署新的代理程式,請參閱「使用 Docker 部署代理程式」。
如要升級代理程式,請參閱「使用 Docker 升級代理程式」一文。
安裝程式
如要部署新的代理程式,請參閱「使用 CentOS 部署代理程式」或「使用 RHEL 部署代理程式」。
如要升級代理程式,請參閱「使用 CentOS 升級代理程式」或「使用 RHEL 升級代理程式 」
遷移現有代理的環境變數
依序前往「SOAR Settings」>「Advanced」>「Remote Agents」 ,然後在所需遠端代理上點選「View More」。
從「Docker Command」(Docker 指令) 欄位複製下列值,並貼到下列指令中。
您會在遷移程序中使用這些值:
-
ONE PLATFORM URL DOMAIN版本的服務設定。ONE_PLATFORM_URL_DOMAIN
-
ONE PLATFORM URL PROJECT版本的服務設定。ONE_PLATFORM_URL_PROJECT
-
ONE PLATFORM URL LOCATION版本的服務設定。ONE_PLATFORM_URL_LOCATION
-
ONE PLATFORM URL INSTANCE版本的服務設定。ONE_PLATFORM_URL_INSTANCE
Podman
如要遷移遠端代理程式環境變數,請按照下列步驟操作:
-
列出執行中的 Podman 容器。
podman ps -
輸入代理的容器 ID:
CONTAINER_ID
-
貼上先前程序中的下列環境變數,然後執行這個指令:
podman exec CONTAINER_ID sh -c 'printf "export ONE_PLATFORM_URL_DOMAIN=ONE_PLATFORM_URL_DOMAIN\nexport ONE_PLATFORM_URL_PROJECT=ONE_PLATFORM_URL_PROJECT\nexport ONE_PLATFORM_URL_LOCATION=ONE_PLATFORM_URL_LOCATION\nexport ONE_PLATFORM_URL_INSTANCE=ONE_PLATFORM_URL_INSTANCE\nexport GOOGLE_APPLICATION_CREDENTIALS=/opt/SiemplifyAgent/agent-key.json" >> /home/siemplify_agent/.bash_profile'
Docker
如要遷移遠端代理程式環境變數,請按照下列步驟操作:
-
列出執行中的 Docker 容器。
docker ps -
輸入代理的容器 ID:
CONTAINER_ID
-
貼上先前程序中的下列環境變數,然後執行這個指令:
docker exec CONTAINER_ID sh -c 'printf "export ONE_PLATFORM_URL_DOMAIN=ONE_PLATFORM_URL_DOMAIN\nexport ONE_PLATFORM_URL_PROJECT=ONE_PLATFORM_URL_PROJECT\nexport ONE_PLATFORM_URL_LOCATION=ONE_PLATFORM_URL_LOCATION\nexport ONE_PLATFORM_URL_INSTANCE=ONE_PLATFORM_URL_INSTANCE\nexport GOOGLE_APPLICATION_CREDENTIALS=/opt/SiemplifyAgent/agent-key.json" >> /home/siemplify_agent/.bash_profile'
安裝程式
如要遷移遠端代理程式環境變數,請按照下列步驟操作:
貼上先前程序中的下列環境變數,然後執行這個指令:
cat << EOF >> /home/siemplify_agent/.bash_profile export ONE_PLATFORM_URL_DOMAIN=ONE_PLATFORM_URL_DOMAIN export ONE_PLATFORM_URL_PROJECT=ONE_PLATFORM_URL_PROJECT export ONE_PLATFORM_URL_LOCATION=ONE_PLATFORM_URL_LOCATION export ONE_PLATFORM_URL_INSTANCE=ONE_PLATFORM_URL_INSTANCE export GOOGLE_APPLICATION_CREDENTIALS=/opt/SiemplifyAgent/agent-key.json EOF
將服務帳戶遷移至遠端代理程式
完成這個步驟,且遠端代理中已有所有環境變數後,遷移作業即完成,遠端代理會透過 Google Cloud進行通訊。
Podman
如要遷移遠端代理程式驗證基礎架構,請按照下列步驟操作:
-
列出執行中的 Podman 容器。
podman ps -
輸入代理的容器 ID:
CONTAINER_ID
-
執行下列指令,將服務帳戶金鑰複製到容器中的專屬路徑。
podman cp AGENT_SERVICE_ACCOUNT_PATH CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
使用下列指令,變更容器中服務帳戶金鑰的擁有者:
podman exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
執行下列指令來套用變更:
podman restart CONTAINER_ID
Docker
如要遷移遠端代理程式驗證基礎架構,請按照下列步驟操作:
-
列出執行中的 Docker 容器。
docker ps -
輸入代理的容器 ID:
CONTAINER_ID
-
執行下列指令,將服務帳戶金鑰複製到容器中的專屬路徑。
docker cp AGENT_SERVICE_ACCOUNT_PATH CONTAINER_ID:/opt/SiemplifyAgent/agent-key.json
使用下列指令,變更容器中服務帳戶金鑰的擁有者:
docker exec -u 0 CONTAINER_ID chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
執行下列指令來套用變更:
docker restart CONTAINER_ID
安裝程式
如要遷移遠端代理程式驗證基礎架構,請按照下列步驟操作:
-
將服務帳戶移至預期路徑
mv AGENT_SERVICE_ACCOUNT_PATH /opt/SiemplifyAgent/agent-key.json
-
使用下列指令,變更容器中服務帳戶金鑰的擁有者:
chown siemplify_agent:siemplify_agent /opt/SiemplifyAgent/agent-key.json
-
執行下列指令,重新啟動代理程式服務:
supervisorctl restart siemplify_agent
還有其他問題嗎?向社群成員和 Google SecOps 專業人員尋求解答。