Configura el instalador y Docker
En este documento, se describe cómo configurar un agente, lo que incluye cómo ver y cambiar las opciones de configuración. También se explica cómo establecer la configuración de proxy para la comunicación entre el agente y el publicador, y las integraciones.
Administra la configuración del agente remoto
Para realizar cambios en un agente, sigue estos pasos:
- Accede a la máquina del agente con SSH.
- Ve al directorio
/home/siemplify_agent/agent_source. Si usas Docker, asegúrate de estar dentro del contenedor. - Ejecuta el siguiente comando para ver todas las opciones de configuración principales de la utilidad
cli:python agent_cli.py -h
Ejecuta el comando
printenvpara verificar los valores actuales de las configuraciones que se usan de forma activa. Usa el formato
set_optionpara cambiar el valor de una sola opción de configuración principal:- Usa el comando
update_environmentpara modificar un conjunto más amplio de parámetros de configuración almacenados como variables de entorno:- Consulta la lista de variables de entorno disponibles para su modificación:
- Cambia el valor de uno de estos parámetros de configuración:
python agent_cli.py update_environment -h
python agent_cli.py update_environment VARIABLE_NAME VALUE
Por ejemplo:
python agent_cli.py update_environment_status RETRANSMISSION_LOOP_INTERVAL_SECONDS 30
python agent_cli.py set_verify_ssl_slave false
Variables de entorno del agente remoto
En la siguiente tabla, se proporciona información detallada sobre las variables de entorno que se pueden configurar con el comando python agent_cli.py update_environment:
| Opción | Descripción | Valores |
|---|---|---|
TASK_TIMEOUT |
Establece el tiempo de espera (en segundos) para las tareas que el agente extrajo, pero no ejecutó. | Tiempo (en segundos) |
SERVER_API_ROOT |
Es la dirección principal del servidor de la API de Publisher. Define desde dónde el agente extrae las tareas y dónde publica los resultados. Si tu política de firewall no permite entradas de dominio con comodines, puedes usar este nombre de host del publicador específico del usuario en tus reglas de lista de entidades permitidas de salida. Para obtener más información, consulta Requisitos de red y firewall. | Dirección de la API |
SERVER_API_TOKEN |
Es el token de autenticación que se usa para todas las solicitudes que se envían al publicador. | Token de la API del servidor (cadena) |
VERIFY_SSL |
Determina si el agente debe conectarse a un publicador solo si presenta un certificado SSL firmado. | Booleano (True o False) |
RETRANSMISSION_LOOP_INTERVAL_SECONDS |
Establece el retraso (en segundos) entre las verificaciones para confirmar que el publicador
recibió el CASE_ACK de un paquete de conector. |
Tiempo (en segundos) |
RETRANSMISSION_SAVE_PERIOD_DAYS |
Es el tiempo máximo (en días) que un paquete de conector puede permanecer en la carpeta de retransmisión
antes de que se borre, suponiendo que no se haya recibido el CASE_ACK. |
Tiempo (en días) |
RETRANSMISSION_FOLDER_MAX_SIZE_MB |
Es el tamaño máximo (en MB) que puede alcanzar la carpeta de retransmisión antes de que el agente comience a borrar los paquetes de conector más antiguos para mantener el límite. | Tamaño (MB) |
VERIFY_SSL_SLAVE |
Si se establece en True, el agente requiere que el publicador secundario
tenga un certificado SSL firmado antes de establecer la comunicación. |
Booleano (True o False) |
PROXY_ADDRESS |
Es la dirección IP del servidor proxy que usa el agente para comunicarse con el publicador principal. | Dirección IP del proxy |
AGENT_KEY |
Es una clave encriptada que el agente usa para desencriptar los paquetes extraídos del publicador y encriptar los resultados antes de volver a publicarlos. | Clave de agente encriptada |
SERVER_API_ROOT_SLAVE |
Es la dirección del servidor secundario de la API de Publisher desde donde el agente extrae las tareas y publica los resultados. | Dirección de la API |
PROXY_ADDRESS_SLAVE |
Es la dirección IP del servidor proxy que usa el agente para comunicarse con el publicador secundario. | Dirección IP del proxy |
DEPLOYMENT_TYPE |
Indica el método de instalación que se usó para el agente. | Docker o Installer (cadena) |
Configura un proxy de agente-publicador
Configura un servidor proxy para controlar toda la comunicación entre el servicio del agente remoto y el publicador. Esta configuración solo se aplica al canal de comunicación entre el agente y el publicador.
Para configurar un proxy de agente-publicador, sigue estos pasos:
- Ejecuta el comando
update_environmenten la máquina del agente para configurar un proxy en un agente implementado existente: - Descarga el paquete y, luego, edita el archivo
.envpara incluir la dirección del proxy: - Agrega la dirección del proxy como una variable de entorno (`-e`) al comando de Docker antes de ejecutar la implementación:
python3 /opt/SiemplifyAgent/agent_cli.py update_environment PROXY_ADDRESS https://{proxy_host}
PROXY_ADDRESS=https://{proxy_host}
-e PROXY_ADDRESS=https://{proxy_host}
Configura un proxy de integración
En este procedimiento, se define la configuración de proxy para las integraciones que se ejecutan en el agente remoto, lo que garantiza que el tráfico de integración se enrute a través del servidor proxy especificado.
Para configurar un proxy de integración, agrega las variables requeridas al entorno del agente antes de ejecutar el comando de Docker:
| Variable | Descripción | Ejemplo |
|---|---|---|
HTTP_PROXY |
Dirección de proxy para solicitudes HTTP | https://{HTTP_PROXY} |
HTTPS_PROXY |
Dirección de proxy para solicitudes HTTPS | https://{HTTPS_PROXY} |
NO_PROXY |
Lista separada por comas de nombres de host o IPs para omitir el enrutamiento de proxy | https://{NO_PROXY} |
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.