設定安裝程式和 Docker

支援的國家/地區:

本文說明如何設定代理程式,包括如何查看及變更設定選項。本文也說明如何設定代理程式與發布商通訊和整合的 Proxy 設定。

管理遠端代理程式設定

如要變更代理程式,請按照下列步驟操作:

  1. 使用 SSH 登入代理程式電腦。
  2. 前往 /home/siemplify_agent/agent_source 目錄,如果您使用 Docker,請確認您位於容器內。
  3. 執行下列指令,查看 cli 公用程式的所有主要設定選項:
    python agent_cli.py -h

    執行 printenv 指令,檢查目前使用的設定值。

  4. 使用 set_option 格式變更單一主要設定選項的值:

  5. python agent_cli.py set_verify_ssl_slave false
  6. 使用 update_environment 指令修改以環境變數形式儲存的更廣泛設定:
    1. 查看可修改的環境變數清單:
    2. python agent_cli.py update_environment -h
    3. 變更下列任一設定的值:
    4. python agent_cli.py update_environment VARIABLE_NAME VALUE

      例如:

      python agent_cli.py update_environment_status RETRANSMISSION_LOOP_INTERVAL_SECONDS  30

遠端代理程式環境變數

下表詳細說明可使用 python agent_cli.py update_environment 指令設定的環境變數:

選項 說明
TASK_TIMEOUT 設定代理程式已提取但尚未執行的工作逾時時間 (以秒為單位)。 時間 (以秒為單位)
SERVER_API_ROOT 主要 Publisher API 伺服器位址。定義代理程式從何處提取工作,以及將結果發布至何處。 API 位址
SERVER_API_TOKEN 用於傳送給發布商的所有要求的驗證權杖。 伺服器 API 權杖 (字串)
VERIFY_SSL 決定代理程式是否必須連線至發布商,前提是發布商提供已簽署的 SSL 憑證。 布林值 (TrueFalse)
RETRANSMISSION_LOOP_INTERVAL_SECONDS 設定檢查間隔時間 (以秒為單位),確認發布者是否收到連接器套件的 CASE_ACK 時間 (以秒為單位)
RETRANSMISSION_SAVE_PERIOD_DAYS 假設系統尚未收到 CASE_ACK,連接器套件在刪除前,最多可在重新傳輸資料夾中保留的天數。 時間 (天)
RETRANSMISSION_FOLDER_MAX_SIZE_MB 重新傳輸資料夾的大小上限 (以 MB 為單位),達到上限後,代理程式就會開始刪除最舊的連接器套件,以維持界線。 大小 (MB)
VERIFY_SSL_SLAVE 如果設為 True,代理程式會要求次要發布者具備已簽署的 SSL 憑證,才能建立通訊。 布林值 (TrueFalse)
PROXY_ADDRESS 代理伺服器的 IP 位址,代理程式會使用這個位址與主要發布者通訊。 Proxy IP 位址
AGENT_KEY 代理程式用來解密從發布者提取的套件,以及加密結果再發布的加密金鑰。 加密的服務專員金鑰
SERVER_API_ROOT_SLAVE 次要 Publisher API 伺服器位址,代理程式會從該位址提取工作,並將結果發布至該位址。 API 位址
PROXY_ADDRESS_SLAVE 代理程式用來與次要發布者通訊的代理伺服器 IP 位址。 Proxy IP 位址
DEPLOYMENT_TYPE 指出代理程式的安裝方式。 DockerInstaller (字串)

設定 Agent-Publisher Proxy

設定 Proxy 伺服器,處理遠端代理程式服務與發布者之間的所有通訊。這項設定只會套用至代理程式與發布者之間的通訊管道。

如要設定 Agent-Publisher 代理程式,請按照下列步驟操作:

  1. 在代理程式機器上執行 update_environment 指令,在現有已部署的代理程式上設定 Proxy:
  2. python3 /opt/SiemplifyAgent/agent_cli.py update_environment PROXY_ADDRESS https://{proxy_host}
  3. 下載套件,然後編輯 .env 檔案,加入 Proxy 位址:
  4. PROXY_ADDRESS=https://{proxy_host}
  5. 執行部署作業前,請先將 Proxy 位址新增為 Docker 指令的環境變數 (`-e`):
  6. -e PROXY_ADDRESS=https://{proxy_host}

設定整合 Proxy

這個程序會定義在遠端代理程式上執行的整合 Proxy 設定,確保整合流量會透過指定的 Proxy 伺服器傳輸。

如要設定整合 Proxy,請在執行 Docker 指令前,將必要變數新增至代理程式的環境:

變數 說明 範例
HTTP_PROXY HTTP 要求的 Proxy 位址 https://{HTTP_PROXY}
HTTPS_PROXY HTTPS 要求的 Proxy 位址 https://{HTTPS_PROXY}
NO_PROXY 以半形逗號分隔的主機名稱/IP 清單,可略過 Proxy 路由 https://{NO_PROXY}

還有其他問題嗎?向社群成員和 Google SecOps 專業人員尋求答案。