配置安装程序和 Docker

支持范围:

本文档介绍了如何配置代理,包括如何查看和更改配置选项。此外,还介绍了如何为代理与发布者之间的通信以及集成配置代理设置。

管理远程代理配置

如需更改代理,请按以下步骤操作:

  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 证书时才连接到发布商。 布尔值(True 或 False)
RETRANSMISSION_LOOP_INTERVAL_SECONDS 设置两次检查之间的时间延迟(以秒为单位),以确认发布者收到了连接器软件包的 CASE_ACK。 时间(秒)
RETRANSMISSION_SAVE_PERIOD_DAYS 连接器软件包在被删除之前可以在重新传输文件夹中保留的最长时间(以天为单位),前提是尚未收到 CASE_ACK。 时间(天)
RETRANSMISSION_FOLDER_MAX_SIZE_MB 重新传输文件夹在代理开始删除最旧的连接器软件包以维持边界之前可以达到的最大大小(以 MB 为单位)。 大小 (MB)
VERIFY_SSL_SLAVE 如果设置为 True,则代理会要求辅助发布者在建立通信之前拥有已签名的 SSL 证书。 布尔值(True 或 False)
PROXY_ADDRESS 代理用于与主发布者通信的代理服务器的 IP 地址。 代理 IP 地址
AGENT_KEY 代理用于解密从发布者拉取的软件包并在发布结果之前对其进行加密的加密密钥。 已加密的代理密钥
SERVER_API_ROOT_SLAVE 辅助 Publisher API 服务器地址,代理会从中拉取任务并将结果发布到该地址。 API 地址
PROXY_ADDRESS_SLAVE 代理用于与辅助发布者通信的代理服务器的 IP 地址。 代理 IP 地址
DEPLOYMENT_TYPE 指明代理所用的安装方法。 Docker 或 Installer(字符串)

配置代理-发布者代理

配置代理服务器,以处理远程代理服务与发布者之间的所有通信。此配置仅适用于代理-发布者通信渠道。

如需配置 Agent-Publisher 代理,请按以下步骤操作:

  1. 在代理机器上运行 update_environment 命令,以在现有已部署代理上配置代理:
  2. python3 /opt/SiemplifyAgent/agent_cli.py update_environment PROXY_ADDRESS https://{proxy_host}
  3. 下载该软件包,然后修改 .env 文件以添加代理地址:
  4. PROXY_ADDRESS=https://{proxy_host}
  5. 在运行部署之前,将代理地址作为环境变量 (`-e`) 添加到 Docker 命令中:
  6. -e PROXY_ADDRESS=https://{proxy_host}。

配置集成代理

此过程会为在远程代理上运行的集成定义代理设置,以确保集成流量通过指定的代理服务器进行路由。

如需配置集成代理,请在运行 Docker 命令之前将所需变量添加到代理的环境中:

变量 说明 示例
HTTP_PROXY HTTP 请求的代理地址 https://{HTTP_PROXY}
HTTPS_PROXY HTTPS 请求的代理地址 https://{HTTPS_PROXY}
NO_PROXY 要绕过代理路由的主机名/IP 地址逗号分隔列表 https://{NO_PROXY}

需要更多帮助?获得社区成员和 Google SecOps 专业人士的解答。