9. Проверки через SSH

Обзор

SSH проверки выполняются без какого-либо агента. Zabbix агент не требуется для проверок, выполняемых по SSH.

Для выполнения SSH проверок Zabbix сервер должен быть изначально сконфигурирован с поддержкой SSH2 (libssh2 или libssh). Смотрите также: Требования.

Настройка

Аутентификация по паролю

Проверки SSH предоставляют два метода аутентификации: пара логин пользователя/пароль и на основе файла ключа.

Если вы не собираетесь использовать ключи, то (помимо привязки библиотеки libssh2/libssh к Zabbix при компиляции из исходных кодов) никакой дополнительной настройки не требуется.

Аутентификация по ключу

Чтобы для элементов данных SSH использовать аутентификацию по ключу, необходимо произвести некоторые изменения в конфигурации сервера.

Откройте файл конфигурации сервера Zabbix (zabbix_server.conf) из-под root и найдите следующую строку:

# SSHKeyLocation=

Раскомментируйте её и укажите полный путь к папке, где размещены открытые и закрытые ключи (public and private keys):

SSHKeyLocation=/home/zabbix/.ssh

Затем сохраните файл и перезапустите сервер Zabbix.

Здесь /home/zabbix — домашняя папка для учётной записи пользователя zabbix, а .ssh — папка внутри неё, куда по умолчанию с помощью команды ssh-keygen [en] будут сгенерированы открытые и закрытые ключи.

Обычно при установке сервера Zabbix из пакетов на разных дистрибутивах ОС создается аккаунт пользователя zabbix с домашней папкой в не очень стандартных местах, например, /var/lib/zabbix (как для системных аккаунтов).

До начала создания ключей рассмотрите вариант перемещения домашней папки в более известное место (интуитивно ожидаемое). Этот вариант будет соответствовать параметру SSHKeyLocation конфигурации Zabbix сервера, упомянутому выше.

Для изменения этой настройки у учётной записи пользователя zabbix все работающие процессы, которые его используют, потребуется остановить:

systemctl stop zabbix-agent
       systemctl stop zabbix-server

Чтобы изменить местоположение домашней папки с попыткой переместить её (если папка существует), вы должны выполнить команду:

usermod -m -d /home/zabbix zabbix

Вполне возможно, что домашняя папка не существует в старом месте, поэтому в новом месте её необходимо создать. Безопасная попытка, чтобы сделать это:

test -d /home/zabbix || mkdir /home/zabbix

Чтобы быть уверенным, что всё безопасно, можно выполнить дополнительные команды для установки разрешений к домашней папке:

chown zabbix:zabbix /home/zabbix
       chmod 700 /home/zabbix

Теперь можно снова запустить ранее остановленные процессы:

systemctl start zabbix-agent
       systemctl start zabbix-server

Теперь шаги генерирования открытых и закрытых ключей можно выполнить следующими командами (для лучшей читабельности запросы команд закомментированы):

sudo -u zabbix ssh-keygen -t rsa
       # Generating public/private rsa key pair.
       # Enter file in which to save the key (/home/zabbix/.ssh/id_rsa):
       /home/zabbix/.ssh/id_rsa
       # Enter passphrase (empty for no passphrase):
       <оставьте пустым>
       # Enter same passphrase again: 
       <оставьте пустым>
       # Your identification has been saved in /home/zabbix/.ssh/id_rsa.
       # Your public key has been saved in /home/zabbix/.ssh/id_rsa.pub.
       # The key fingerprint is:
       # 90:af:e4:c7:e3:f0:2e:5a:8d:ab:48:a2:0c:92:30:b9 zabbix@it0
       # The key's randomart image is:
       # +--[ RSA 2048]----+
       # ||
       # |.|
       # |o|
       # | .o|
       # |+. S|
       # |.+o =|
       # |E .* =|
       # |=o . ..* .|
       # |... oo.o+|
       # +-----------------+

Диалог настройки командной строки

Этот шаг необходимо выполнить только один раз для каждого хоста, который будет наблюдаться с использованием SSH проверок.

При использовании следующей команды файл открытого ключа может быть установлен на удалённый хост 10.10.10.10, для того чтобы потом можно было выполнять SSH проверки при помощи аккаунта root (для лучшей читабельности подсказки команды закомментированы):

sudo -u zabbix ssh-copy-id [email protected]
       # The authenticity of host '10.10.10.10 (10.10.10.10)' can't be established.
       # RSA key fingerprint is 38:ba:f2:a4:b5:d9:8f:52:00:09:f7:1f:75:cc:0b:46.
       # Are you sure you want to continue connecting (yes/no)?
       yes
       # Warning: Permanently added '10.10.10.10' (RSA) to the list of known hosts.
       # [email protected]'s password:
       <введите пароль пользователя root>
       # Теперь попытайтесь зайти на машину с помощью "ssh '[email protected]'",
       # и проверьте, чтобы убедиться, что мы не добавили лишние нежелательные ключи.

Теперь можно проверить вход по SSH с использованием закрытого ключа по умолчанию (/home/zabbix/.ssh/id_rsa) учётной записи пользователя zabbix:

sudo -u zabbix ssh [email protected]

Если вход успешен, то часть настройки в командной строке завершена и удалённую сессию по SSH можно закрыть.

Настройка элемента данных

Фактически выполняемые команда(ы) необходимо поместить в поле Выполняемый скрипт при настройке элемента данных. Можно выполнять несколько команд одну за другой, размещая каждую на новой строке. В этом случае возвращаемые значения также будут отформатированы как многострочные.

Все обязательные поля ввода отмечены красной звёздочкой.

Поля, которые требуют информацию, специфичную для элементов данных SSH: