12 Restringir comprobaciones del agente
Resumen
Puede controlar qué claves de item Zabbix agent o agent 2 tiene permitido o denegado usar al ejecutar comprobaciones de item, comandos remotos o scripts.
Para ello, utilice estos parámetros de configuración del agent para definir reglas de अनुमति/denegación:
AllowKey=<pattern>DenyKey=<pattern>
El <pattern> debe contener una sola clave de item y admite comodines (*).
El comodín coincide con cualquier número de caracteres en su posición y puede usarse para hacer coincidir claves de item o parámetros (por ejemplo, vfs.file.*[*]).
Para mejorar la seguridad, se recomienda usar claves de item exactas en lugar de comodines. Para más detalles, consulte Securing allow/deny rules.
A diferencia de otros parámetros de configuración del agent, puede especificar un número ilimitado de parámetros AllowKey o DenyKey.
Notas importantes
-
Todos los items
system.runse deniegan de forma predeterminada (incluso cuandoDenyKeyestá vacío), como si se hubiera establecidoDenyKey=system.run[*]como la última regla. Por este motivo, puede permitir itemssystem.runespecíficos sin denegar explícitamente los demás itemssystem.run. Esta denegación implícita solo se aplica asystem.run; para todas las demás claves, las reglas de permiso no tienen efecto a menos que después de ellas haya una regla de denegación. -
Use
AllowKeypara permitir únicamente los items necesarios yDenyKeycomo última regla para denegar todos los demás. Esto es más seguro que depender únicamente de reglas de denegación, ya que las nuevas versiones del Zabbix agent pueden introducir claves de item que no estén contempladas en sus reglasDenyKey. -
Si usa
DenyKey, deniegue claves de item completas en lugar de archivos o comandos específicos. Las reglas dirigidas a parámetros específicos pueden eludirse; por ejemplo, el recorrido de rutas (vfs.file.contents["../../../../etc/passwd"]) puede leer un archivo que una regla para su ruta directa pretendía bloquear. Para obtener más información, consulte Protección de las reglas de permiso/denegación. -
La configuración de
AllowKeyyDenyKeyno afecta a los parámetros del agentHostnameItem,HostMetadataItemniHostInterfaceItem. -
Los items denegados pasan a ser no soportados sin ninguna indicación de que se hayan denegado; por ejemplo:
- El parámetro de línea de comandos
--print (-p)del Zabbix agent no mostrará las claves de item denegadas. - El parámetro de línea de comandos
--test (-t)del Zabbix agent devolverá "Unsupported item key." para las claves de item denegadas. - Cuando el registro está activado (
LogRemoteCommands=1), el archivo de registro del Zabbix agent no registrará los comandos remotos denegados.
- El parámetro de línea de comandos
Orden de las reglas de permitir/denegar
Puede especificar un número ilimitado de reglas AllowKey o DenyKey, aunque su orden es importante.
- Las reglas se evalúan una por una, de arriba a abajo.
- Cuando una clave de item coincide con una regla, se permite o deniega, y la evaluación de reglas se detiene.
Por ejemplo, al evaluar vfs.file.contents[/etc/passwd], las reglas se procesan de la siguiente manera:
AllowKey=vfs.file.contents[/tmp/app.log] # El patrón de clave de item no coincide, el agent pasa a la siguiente regla.
AllowKey=vfs.file.contents[/etc/passwd] # El patrón de clave de item coincide; el agent permite la comprobación del item y detiene la evaluación de reglas.
DenyKey=vfs.file.*[*] # El agent ignora la regla, ya que la evaluación se ha detenido.
El siguiente orden de reglas denegará la comprobación del item:
DenyKey=vfs.file.*[*] # El patrón de clave de item coincide; el agent deniega la comprobación del item y detiene la evaluación de reglas.
AllowKey=vfs.file.contents[/etc/passwd] # El agent ignora la regla, ya que la evaluación se ha detenido.
AllowKey=vfs.file.contents[/tmp/app.log] # El agent ignora la regla, ya que la evaluación se ha detenido.
Ejemplos
Los siguientes ejemplos muestran patrones de configuración comunes para AllowKey y DenyKey.
Permitir comprobaciones y comandos específicos
Permitir solo dos comprobaciones de vfs.file y dos comandos system.run:
AllowKey=vfs.file.contents[/tmp/app.log]
AllowKey=vfs.file.size[/tmp/app.log]
AllowKey=system.run[/usr/bin/uptime]
AllowKey=system.run[/usr/bin/df -h /]
DenyKey=vfs.file.*[*]
No es necesario establecer DenyKey=system.run[*], porque todos los demás comandos system.run se deniegan por defecto.
Permitir scripts
Permitir que el agent de Zabbix ejecute scripts en los hosts a través de todos los métodos disponibles:
- Scripts globales que pueden ejecutarse en el frontend o a través de la API (este método siempre utiliza la clave
system.run[myscript.sh]) - Comandos remotos desde operaciones de acción (este método siempre utiliza la clave
system.run[myscript.sh,nowait]) system.runitems del agent de Zabbix con el script, por ejemplo:system.run[myscript.sh]system.run[myscript.sh,wait]system.run[myscript.sh,nowait]
AllowKey=system.run[myscript.sh,*]
Para controlar el parámetro wait/nowait, debe establecer una regla diferente.
Por ejemplo, puede permitir solo los items system.run[myscript.sh,wait], excluyendo así otros métodos:
AllowKey=system.run[myscript.sh,wait]
Asegurar las reglas allow/deny
Este ejemplo muestra cómo asegurar reglas AllowKey o DenyKey demasiado permisivas.
Considere las siguientes reglas:
AllowKey=system.run["C:\Program^ Files\Zabbix^ Agent^ 2\scripts\test.bat*"]
DenyKey=vfs.file.*
DenyKey=system.cpu.load[*]
En Windows, debe escapar los espacios en la ruta utilizando un acento circunflejo (^).
Estas reglas contienen un comodín (*), que puede ser mal utilizado:
- El script
test.batpuede ejecutarse con cualquier argumento, incluidos los no deseados. - El patrón
vfs.file.*solo coincide con claves de item sin parámetros; sin embargo, todos los itemsvfs.filerequieren parámetros. - El patrón
system.cpu.load[*]solo coincide con claves de item con parámetros; sin embargo, los itemssystem.cpu.loadno requieren parámetros.
Para asegurar estas reglas, permita explícitamente la ejecución de test.bat solo con argumentos específicos y deniegue los patrones correctos de claves de item; por ejemplo:
AllowKey=system.run["C:\Program^ Files\Zabbix^ Agent^ 2\scripts\test.bat status"]
AllowKey=system.run["C:\Program^ Files\Zabbix^ Agent^ 2\scripts\test.bat version"]
DenyKey=vfs.file.*[*]
DenyKey=system.cpu.load
DenyKey=system.cpu.load[*]
Puede probar las reglas ejecutando los siguientes comandos, que devolverán ZBX_NOTSUPPORTED.
cd "C:\Program Files\Zabbix Agent 2"
zabbix_agent2.exe -t system.run["C:\Program^ Files\Zabbix^ Agent^ 2\scripts\test.bat debug"]
zabbix_agent2.exe -t vfs.file.size["C:\ProgramData\MyApp\config.ini"]
zabbix_agent2.exe -t vfs.file.contents["C:\Windows\System32\drivers\etc\hosts"]
zabbix_agent2.exe -t system.cpu.load
zabbix_agent2.exe -t system.cpu.load[all,avg1]
Ejemplos de patrones
La siguiente tabla muestra cómo se comparan los patrones de las claves de item:
- Una clave coincide con el patrón solo si cumple todas las condiciones de la columna Coincide con.
- Los parámetros deben estar completamente encerrados entre corchetes (por ejemplo,
vfs.file.contents[*yvfs.file.contents*utf8]son patrones no válidos).
Se recomienda utilizar AllowKey para permitir explícitamente el acceso únicamente a los archivos y comandos necesarios, y DenyKey para denegar claves de item completas (consulte Notas importantes).
| Patrón | Coincide con | Ejemplos |
|---|---|---|
* |
Cualquier clave con o sin parámetros | |
vfs.file.* |
La clave comienza por vfs.file.Sin parámetros |
Coincide con:vfs.file.sizevfs.file.contentsNo coincide con: vfs.file.contents[]vfs.file.size[/var/log/app.log] |
vfs.*.contents |
La clave comienza por vfs.La clave termina en .contentsSin parámetros |
Coincide con: vfs..contentsvfs.mount.point.file.contentsNo coincide con: vfs.contentsvfs.file.contents[] |
vfs.file.*[*] |
La clave comienza por vfs.file.Cualquier parámetro o parámetros vacíos |
Coincide convfs.file.get.custom[]vfs.file.size[/var/log/app.log, utf8]No coincide con: vfs.file.get.custom |
vfs.file.contents |
La clave es vfs.file.contentsSin parámetros |
Coincide con:vfs.file.contentsNo coincide con: vfs.file.contents[/etc/passwd] |
vfs.file.contents[] |
La clave es vfs.file.contents[]Parámetros vacíos |
Coincide con:vfs.file.contents[]No coincide con: vfs.file.contents |
vfs.file.contents[*] |
La clave es vfs.file.contentsCualquier parámetro o parámetros vacíos |
Coincide con:vfs.file.contents[/path/to/file]No coincide con: vfs.file.contents |
vfs.file.contents[/etc/passwd,*] |
La clave es vfs.file.contentsEl primer parámetro es /etc/passwdCualquier parámetro posterior, vacío o ninguno |
Coincide con:vfs.file.contents[/etc/passwd,]vfs.file.contents[/etc/passwd,utf8]vfs.file.contents[/etc/passwd]No coincide con: vfs.file.contents[] |
vfs.file.contents[*passwd*] |
La clave es vfs.file.contentsExactamente un parámetro que contiene passwd |
Coincide con:vfs.file.contents[/etc/passwd]No coincide con: vfs.file.contents[/etc/passwd,]vfs.file.contents[/etc/passwd,utf8] |
vfs.file.contents[*passwd*,*] |
La clave es vfs.file.contentsEl primer parámetro contiene passwdCualquier segundo parámetro o un parámetro vacío |
Coincide con:vfs.file.contents[/etc/passwd,]vfs.file.contents[/etc/passwd,utf8]vfs.file.contents[/etc/passwd]No coincide con: vfs.file.contents[/tmp/test] |
vfs.file.contents[/etc/passwd,utf8] |
La clave es vfs.file.contentsEl primer parámetro es /etc/passwdEl segundo parámetro es utf8 |
Coincide con:vfs.file.contents[/etc/passwd,utf8]No coincide con: vfs.file.contents[/etc/passwd,]vfs.file.contents[/etc/passwd,utf16] |