12. Ограничение проверок агента
Обзор
Можно управлять тем, какие ключи элементов данных Zabbix агенту или Zabbix агенту 2 резрешено или запрещено использовать при выполнении проверок элементов данных, удалённых команд или скриптов.
Чтобы это сделать, используйте эти параметры конфигурации агента для для задания разрешающих/запрещающих правил:
AllowKey=<шаблон>DenyKey=<шаблон>
<Шаблон> должен содержать один ключ элемента данных и поддерживает подстановочный знак (*).
Подстановочный знак соответствует любому количеству любых символов в данной позиции, и может использоваться для сопоставления как ключа элемента данных, так и параметров (например, vfs.file.*[*]).
Для улучшения безопасности рекомендуется использовать точные ключи элементов данных, а не подстановочные символы. Более подробную информацию смотрите в разделе Обеспечение безопасности разрешающих/запрещающих правил.
Важные примечания
-
Все элементы данных
system.runпо умолчанию запрещены (даже еслиDenyKeyпуст), как если бы было заданоDenyKey=system.run[*]в качестве последнего правила. Поэтому можно разрешить определенные элементы данныхsystem.run, не запрещая явно остальные элементы данныхsystem.run. Этот неявный запрет применяется только кsystem.run; для всех остальных ключей правила разрешения не действуют, если после них нет правила запрета. -
Используйте
AllowKey, чтобы разрешить только необходимые элементы данных, аDenyKeyв качестве последнего правила — чтобы запретить все остальные. Это безопаснее, чем полагаться только на правила запрета, поскольку в новых версиях агента Zabbix могут появиться ключи элементов данных, не охваченные правиламиDenyKey. -
Если вы используете
DenyKey, запрещайте ключи элементов данных целиком, а не отдельные файлы или команды. Правила, нацеленные на определенные параметры, можно обойти; например, обход пути (vfs.file.contents["../../../../etc/passwd"]) позволяет прочитать файл, доступ к которому должно было блокировать правило для его прямого пути. Подробнее см. в разделе Защита правил разрешения и запрета. -
Конфигурация
AllowKeyиDenyKeyне влияет на параметры агентаHostnameItem,HostMetadataItemилиHostInterfaceItem. -
Запрещенные элементы данных становятся неподдерживаемыми без каких-либо указаний на то, что они были запрещены; например:
- Параметр командной строки агента Zabbix
--print (-p)не отображает ключи запрещенных элементов данных. - Параметр командной строки агента Zabbix
--test (-t)возвращает сообщение "Unsupported item key." для ключей запрещенных элементов данных. - При включенном журналировании (
LogRemoteCommands=1) файл журнала агента Zabbix не регистрирует удаленные команды.
- Параметр командной строки агента Zabbix
Порядок правил Allow/Deny
Можно указать неограниченное количество правил AllowKey или DenyKey, но их порядок имеет значение.
- Правила проверяются по очереди, сверху вниз.
- Как только ключ элемента данных соответствует правилу, элемент данных разрешается или запрещается; а проверка правил прекращается.
Например, при проверке ключа vfs.file.contents[/etc/passwd] правила обрабатываются следующим образом:
AllowKey=vfs.file.contents[/tmp/app.log] # Шаблон ключа элемента данных не даёт соответствия, агент переходит к следующему правилу.
AllowKey=vfs.file.contents[/etc/passwd] # Шаблон ключа элемента данных даёт соответствие; агент разрешает проверку элемента данных и прекращает проверку правил.
DenyKey=vfs.file.*[*] # Агент игнорирует правило, поскольку проверка правил была прекращена.
Следующий порядок правил запретит проверку элемента данных:
DenyKey=vfs.file.*[*] # Шаблон ключа элемента данных даёт соответствие; агент запрещает проверку элемента данных и прекращает проверку правил.
AllowKey=vfs.file.contents[/etc/passwd] # Агент игнорирует правило, поскольку проверка правил была прекращена.
AllowKey=vfs.file.contents[/tmp/app.log] # Агент игнорирует правило, поскольку проверка правил была прекращена.
Примеры
Следующие примеры демонстрируют распространенные шаблоны конфигурации для AllowKey и DenyKey.
Разрешение конкретных проверок и команд
Разрешить проверку только двух элементов данных vfs.file и двух команд 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.*[*]
Указание DenyKey=system.run[*] не является необходимым, поскольку все остальные команды system.run по умолчанию запрещены.
Разрешение скриптов
Разрешение Zabbix агенту выполнять скрипты на узле сети всеми доступными способами:
- Глобальные скрипты, которые могут быть выполнены через веб-интерфейс или посредством API (этот метод всегда использует ключ
system.run[myscript.sh]) - Удалённые команды из операций действия (этот метод всегда использует ключ
system.run[myscript.sh,nowait]) - Элементы данных Zabbix агента
system.runсо скриптом, например:system.run[myscript.sh]system.run[myscript.sh,wait]system.run[myscript.sh,nowait]
AllowKey=system.run[myscript.sh,*]
Чтобы управлять параметром wait/nowait, вам нужно установить другое правило.
Например, вы можете разрешить только элементы данных system.run[myscript.sh,wait], исключая таким образом другие способы:
AllowKey=system.run[myscript.sh,wait]
Обеспечение безопасности разрешающих/запрещающих правил
В этом примере показано, как обезопасить чрезмерно разрешительные правила AllowKey или DenyKey.
Consider the following rules:
AllowKey=system.run["C:\Program^ Files\Zabbix^ Agent^ 2\scripts\test.bat*"]
DenyKey=vfs.file.*
DenyKey=system.cpu.load[*]
В Windows, вам нужно экранировать пробелы в путях с помощью символа «карет» (^).
Эти правила содержат подстановочный символ (*), который может быть использован неверно:
- Скрипт
test.batможет выполняться с любыми аргументами, включая те, которые для этого не предназначены. - Шаблон
vfs.file.*соответствует только ключам элементов данных без параметров; однако, для всех элементы данныхvfs.fileтребуются параметры. - Шаблон
system.cpu.load[*]соответствует только ключам элементов данных с параметрами; однако, для элементов данныхsystem.cpu.loadпараметры не требуются.
Чтобы сделать эти правила безопасными, явно разрешите выполнение test.bat только с конкретными аргументами, а также запретите правильные шаблоны ключей элементов данных; например:
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[*]
Можно протестировать эти правила, выполняя следующие команды, которые будут возвращать 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]
Примеры шаблонов
В следующей таблице показано, как сопоставляются шаблоны ключей элементов данных:
- Ключ соответствует шаблону только в том случае, если он удовлетворяет всем условиям в столбце Соответствует.
- Параметры должны быть полностью заключены в квадратные скобки (например,
vfs.file.contents[*иvfs.file.contents*utf8]являются недопустимыми шаблонами).
Рекомендуется использовать AllowKey, чтобы явно разрешить доступ только к необходимым файлам и командам, а DenyKey — чтобы запретить целые ключи элементов данных (см. раздел Важные примечания).
| Шаблон | Соответствует | Примеры |
|---|---|---|
* |
Любой ключ с параметрами или без них | |
vfs.file.* |
Ключ начинается с vfs.file.Без параметров |
Соответствует:vfs.file.sizevfs.file.contentsНе соответствует: vfs.file.contents[]vfs.file.size[/var/log/app.log] |
vfs.*.contents |
Ключ начинается с vfs.Ключ заканчивается на .contentsБез параметров |
Соответствует: vfs..contentsvfs.mount.point.file.contentsНе соответствует: vfs.contentsvfs.file.contents[] |
vfs.file.*[*] |
Ключ начинается с vfs.file.Любые параметры или пустые параметры |
Соответствуетvfs.file.get.custom[]vfs.file.size[/var/log/app.log, utf8]Не соответствует: vfs.file.get.custom |
vfs.file.contents |
Ключ — vfs.file.contentsБез параметров |
Соответствует:vfs.file.contentsНе соответствует: vfs.file.contents[/etc/passwd] |
vfs.file.contents[] |
Ключ — vfs.file.contents[]Пустые параметры |
Соответствует:vfs.file.contents[]Не соответствует: vfs.file.contents |
vfs.file.contents[*] |
Ключ — vfs.file.contentsЛюбые параметры или пустые параметры |
Соответствует:vfs.file.contents[/path/to/file]Не соответствует: vfs.file.contents |
vfs.file.contents[/etc/passwd,*] |
Ключ — vfs.file.contentsПервый параметр — /etc/passwdЛюбой, пустой или отсутствующий последующий параметр |
Соответствует:vfs.file.contents[/etc/passwd,]vfs.file.contents[/etc/passwd,utf8]vfs.file.contents[/etc/passwd]Не соответствует: vfs.file.contents[] |
vfs.file.contents[*passwd*] |
Ключ — vfs.file.contentsРовно один параметр, содержащий passwd |
Соответствует:vfs.file.contents[/etc/passwd]Не соответствует: vfs.file.contents[/etc/passwd,]vfs.file.contents[/etc/passwd,utf8] |
vfs.file.contents[*passwd*,*] |
Ключ — vfs.file.contentsПервый параметр содержит passwdЛюбой или пустой второй параметр |
Соответствует:vfs.file.contents[/etc/passwd,]vfs.file.contents[/etc/passwd,utf8]vfs.file.contents[/etc/passwd]Не соответствует: vfs.file.contents[/tmp/test] |
vfs.file.contents[/etc/passwd,utf8] |
Ключ — vfs.file.contentsПервый параметр — /etc/passwdВторой параметр — utf8 |
Соответствует:vfs.file.contents[/etc/passwd,utf8]Не соответствует: vfs.file.contents[/etc/passwd,]vfs.file.contents[/etc/passwd,utf16] |