> For the complete documentation index, see [llms.txt](https://book.konstantinsecurity.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://book.konstantinsecurity.com/readme/architect/monitoring/zabbix/ssl-certificates-zabix.md).
# SSL certificates Zabix
*«Ничто не вечно под луной» Уильям Шекспир*
Если вы отвечаете за работоспособность сайтов, то эта статья поможет вам и вашим клиентам своевременно продлить срок регистрации доменов и вовремя обновить SSL-сертификаты.
Конечно, владельцы сайтов получат по электронной почте извещения о необходимости продления услуг, однако их легко не заметить или проигнорировать. И если просроченный сертификат можно заменить бесплатным Let’s Encrypt за несколько минут, то на восстановление работоспособности домена, у которого снято делегирование, может уйти больше суток. Все это время сайт не будет работать, что принесет вашим клиентам убытки.
Кроме того, после окончания срока регистрации и освобождения доменное имя может быть зарегистрировано кем угодно. В результате клиенту придется либо выкупать домен обратно, либо регистрировать и продвигать новый домен.
На сервисе SAAS интернет-магазинов нужно контролировать сотни доменов. Дополнительно задача контроля усложняется тем обстоятельством, что все время открываются новые сайты, а старые могут закрываться. Поэтому тут не обойтись без автоматизации, которую можно реализовать при помощи Zabbix.
Как и предыдущих статьях нашей серии про Zabbix, мы сначала рассмотрим ручные методы контроля, а затем перейдем к описанию шаблона и скриптов контроля для Zabbix.
## Ручной контроль срока действия сертификата SSL
Срок действия сертификата можно проверить в браузере, а также в командной строке ОС. Рассмотрим оба способа.
### Проверка срока действия сертификата SSL в браузере
Любой пользователь может узнать срок действия сертификата сайта, открытого в браузере. Для этого в Chrome, например, ему достаточно щелкнуть мышкой символ замка в адресной строке браузера, расположенный слева от URL сайта, выбрать строку **Безопасное подключение** и щелкнуть строку **Действительный сертификат**. После этого на экране появится окно с информацией о сертификате, подключенном к сайту (рис. 1).
Рис. 1. Информация о сертификате, подключенном к сайту
В нижней части этого окна в блоке **Действителен** указан диапазон дат, в пределах которого сертификат будет работоспособен. Попытки подключения к сайту после завершения этого срока приведут к появлению у пользователей предупреждающих сообщений или даже к невозможности работы с сайтом.
Аналогичный способ посмотреть срок действия сертификата есть и в других браузерах. В Firefox, например, нужно щелкнуть символ замка слева от URL сайта, выбрать строку **Защищенное соединение**, а затем выбрать строку **Подробнее**. Далее нужно щелкнуть кнопку **Посмотреть сертификат**. В блоке **Срок действия** вы найдете информацию о диапазоне дат, в пределах которого сертификат будет действительным.
Аналогичные способы проверки сертификатов есть и в браузерах смартфонов.
### Проверка срока действия сертификата SSL в командной строке
В интернете нетрудно найти способ проверки сроков действия сертификата, установленного на сайте, из командной строки с помощью программы openssl.
Например, следующая команда покажет в консоли диапазоны дат, в пределах которых будет действителен сертификат сайта [firstvds.ru](http://firstvds.ru/), использующего протокол https на порту 443:
```
$ echo | openssl s_client -servername firstvds.ru -connect firstvds.ru:443 2>/dev/null | openssl x509 -noout -dates 2>/dev/null
notBefore=Jun 29 00:00:00 2020 GMT
notAfter=Aug 28 12:00:00 2022 GMT
```
Сертификат действителен с даты **notBefore** и до даты **notAfter**.
Если вас интересует только дата, до которой будет работать сертификат, используйте такую команду:
```
$ echo | openssl s_client -servername firstvds.ru -connect firstvds.ru:443 2>/dev/null | openssl x509 -noout -dates 2>/dev/null | grep notAfter | cut -d'=' -f2
Aug 28 12:00:00 2022 GMT
```
Чтобы организовать несложную проверку сертификатов из командной строки, используйте скрипт get\_ssl\_info.sh, [доступный на Github](https://github.com/AlexandreFrolov/shop2you_zabbix_monitoring/blob/main/get_ssl_info.sh):
```
#!/bin/sh
SERVER=$1
PORT=$2;
EXPIRE_DATE=`echo | openssl s_client -servername $SERVER -connect $SERVER:$PORT 2>/dev/null | openssl x509 -noout -dates 2>/dev/null | grep notAfter | cut -d'=' -f2`
echo $EXPIRE_DATE
```
При запуске передайте ему доменное имя сайта и номер порта:
```
$ bash get_ssl_info.sh firstvds.ru 443
Aug 28 12:00:00 2022 GMT
```
## Ручной контроль срока окончания регистрации доменного имени
Узнать, до какой даты оплачена регистрация доменного имени, и когда доменное имя будет освобождено, можно с помощью команды whois. Просто передайте этой команде проверяемое доменное имя:
```
$ whois firstvds.ru
% By submitting a query to TCI's Whois Service
% you agree to abide by the following terms of use:
% https://www.tcinet.ru/documents/whois.pdf (in Russian)
domain: FIRSTVDS.RU
nserver: ns-1179.awsdns-19.org.
nserver: ns-1806.awsdns-33.co.uk.
nserver: ns-413.awsdns-51.com.
nserver: ns-547.awsdns-04.net.
state: REGISTERED, DELEGATED, VERIFIED
org: CJSC "The First"
registrar: REGTIME-RU
admin-contact: https://whois.webnames.ru
created: 2002-08-06T20:00:00Z
paid-till: 2023-08-07T21:00:00Z
free-date: 2023-09-08
source: TCI
Last updated on 2022-07-29T07:46:32Z
```
Параметр **paid-till** содержит дату и время окончания регистрации доменного имени, а параметр **free-date** — дату его освобождения.
## Мониторинг с помощью Zabbix
Используя приведенные выше команды и программу zabbix\_sender, описанную в предыдущей статье серии, можно организовать мониторинг сроков окончания действия сертификатов и регистрации доменных имен. В случае SAAS-сервиса интернет-магазинов ситуация осложняется тем, что доменов, подлежащих мониторингу сотни, постоянно добавляются новые и иногда исчезают старые.
Для получения списка доменных имен активных интернет-магазинов мы используем вызов внутренней CRM сервиса SAAS. Далее, на основе этого списка с помощью программного интерфейса Zabbix API создается или редактируется список элементов данных Items, содержащих информацию для мониторинга, а также список соответствующих триггеров.
Мы не можем опубликовать API проприетарной системы CRM сервиса SAAS, но вам в любом случае при постановке аналогичной задачи придется выполнять собственную интеграцию со своей CRM. Мы подскажем, где это нужно сделать в опубликованном скрипте мониторинга.
Что же касается описания Zabbix API, то для версии 6.2 [вы найдете ее здесь](https://www.zabbix.com/documentation/6.2/en/manual/api). На русском языке описание API доступно для версии 6.0 [вот тут](https://www.zabbix.com/documentation/6.0/ru/manual/api).
## Программа domain\_monitor.pl
Программа domain\_monitor.pl выполняет все описанные выше функции по динамическому формированию списка элементов данных и триггеров в соответствии со списком работающих интернет-магазинов. Далее она получает информацию обо всех контролируемых доменах и сертификатах, а потом отправляет ее на сервер Zabbix.
Эту программу [можно скачать здесь](https://github.com/AlexandreFrolov/shop2you_zabbix_monitoring/blob/main/domain_monitor_free_version.pl).
### Загрузка файла конфигурации
Сразу после запуска программа загружает файл конфигурации, содержащий реквизиты доступа к Zabbix API:
```
use File::Slurp;
…
my $zbx = LoadFile('/home/frolov/zabbix_domain_monitoring/config/zabbix-server.yaml');
my $zabbix_server_ip = $zbx->{ zabbix_server_ip };
Здесь функции LoadFile нужно передать полный путь к файлу конфигурации в формате YAML следующего вида:
zabbix_server_url: http://zabbix.domain.ru/api_jsonrpc.php
zabbix_server_login: Admin
zabbix_server_password: *********
zabbix_server_ip: ***.***.***.***
```
В параметре zabbix\_server\_url укажите URL для доступа к вашему серверу Zabbix для отправки HTTP POST запросов к файлу api\_jsonrpc.php.
Через параметры zabbix\_server\_login и zabbix\_server\_password следует передать логин и пароль доступа к API. Вы можете использовать здесь реквизиты доступа администратора Zabbix или другого пользователя, обладающего необходимыми правами.
И, наконец, параметр zabbix\_server\_ip задает адрес IP вашего сервера Zabbix.
### Подключение к Zabbix API
Загрузив файл конфигурации, программа domain\_monitor.pl открывает соединение с сервером Zabbix через API с помощью функции zabbix\_open:
```
my $z = zabbix_open($zbx);
```
Функции для обращения к Zabbix API будут отписаны ниже в разделе «Функции для работы с API Zabbix» этой статьи.
### Получение информации о доменах работающих интернет-магазинов
На следующем шаге программа domain\_monitor.pl получает из встроенной CRM ссылку на хэш, содержащий информацию обо всех доменах интернет-магазинов, работающих на момент запуска программы на SAAS-сервисе (открытых сайтов):
```
$all_sites = get_opened_domains_from_billing();
```
Вам нужно будет реализовать эту функцию самостоятельно, так как для получения хэша доменов она обращается к встроенной CRM сервиса SAAS.
### Получение информации о контролируемых доменах от Zabbix
Получив хэш доменов работающих интернет-магазинов, программа формирует хэш всех доменов, которые на момент запуска уже контролируются при помощи Zabbix. Для этого вызывается функция get\_all\_monitored\_domains:
```
my $domains_group_name = 'Shop2YOU Domains';
my $all_monitored_domains = get_all_monitored_domains($z, $domains_group_name);
```
Для работы с доменными именами сервиса на сервере Zabbix была создана группа «Shop2YOU Domains». Вам нужно будет создать группу, например, с названием вашего сервиса или компании.
Соединение с Zabbix API передается функции get\_all\_monitored\_domains в качестве первого параметра, а имя группы —в качестве второго параметра.
Таким образом, в переменной all\_sites хранится ссылка на хэш со всеми доменами, которые работают, а в переменной all\_monitored\_domains — с доменами, которые находятся на мониторинге. Эти данные загружены на момент запуска программы domain\_monitor.pl.
### Актуализация контролируемых доменов
Теперь нужно актуализировать в Zabbix список доменов, добавив туда отсутствующие с момента предыдущей проверки элементы Items и триггеры, а также удалив ненужные элементы для интернет-магазинов, которые прекратили свою работу.
Первая из этих задач решается функцией create\_missing\_domain\_in\_zabbix, а вторая — функцией delete\_closed\_domains\_from\_zabbix.
Функции create\_missing\_domain\_in\_zabbix нужно передать ссылку на Zabbix API, имя группы, имя шаблона, который применяется для мониторинга доменов, ссылку на хэш с работающими доменами all\_sites, а также ссылку на контролируемые домены all\_monitored\_domains:
```
my $domains_template_name = 'Shop2YOU Domains Monitor';
create_missing_domain_in_zabbix($z, $domains_group_name, $domains_template_name, $all_sites, $all_monitored_domains);
```
Функции delete\_closed\_domains\_from\_zabbix передаются те же самые параметры:
```
delete_closed_domains_from_zabbix($z, $domains_group_name, $domains_template_name, $all_sites, $all_monitored_domains);
```
### Отправка текущей информации о доменах на сервер zabbix
Теперь, когда список контролируемых при помощи Zabbix доменов приведен в соответствие списку работающих сайтов из CRM сервиса SAAS, можно отправлять данные с текущей информацией о доменах на сервер Zabbix.
Эта операция выполняется в цикле по хэшу со всеми работающими доменами all\_sites:
```
foreach my $key (keys %$all_sites)
{
my $zkey;
my $zvalue;
my $trap_cmd;
if($key)
{
my $host_name = $all_sites->{$key}->{domain_name};
send_value_to_zabbix($zabbix_sender, $zabbix_server_ip, $host_name, 'days_before_domain_expire', $all_sites->{$key}->{ 'days_before_domain_expire' });
send_value_to_zabbix($zabbix_sender, $zabbix_server_ip, $host_name, 'days_before_ssl_expire', $all_sites->{$key}->{ 'days_before_ssl_expire' });
send_value_to_zabbix($zabbix_sender, $zabbix_server_ip, $host_name, 'domain_ssl_matches', $all_sites->{$key}->{ 'domain_ssl_matches' });
send_value_to_zabbix($zabbix_sender, $zabbix_server_ip, $host_name, 'domain_has_ssl', $all_sites->{$key}->{ 'domain_has_ssl' });
send_value_to_zabbix($zabbix_sender, $zabbix_server_ip, $host_name, 'whois_ok', $all_sites->{$key}->{ 'whois_ok' });
send_value_to_zabbix($zabbix_sender, $zabbix_server_ip, $host_name, 'a_found', $all_sites->{$key}->{ 'a_found' });
send_value_to_zabbix($zabbix_sender, $zabbix_server_ip, $host_name, 'dns_a', $all_sites->{$key}->{ 'a' });
send_value_to_zabbix($zabbix_sender, $zabbix_server_ip, $host_name, 'mx_found', $all_sites->{$key}->{ 'mx_found' });
send_value_to_zabbix($zabbix_sender, $zabbix_server_ip, $host_name, 'dns_mx', $all_sites->{$key}->{ 'mx' });
}
}
```
Отправка данных выполняется при помощи функции send\_value\_to\_zabbix. Как и в предыдущей статье нашей серии, для отправки запускается программа zabbix\_sender. Однако здесь каждый параметр отправляется отдельно:
```
sub send_value_to_zabbix($$$$$)
{
my $zabbix_sender=shift @;
my $zabbix_server_ip=shift @;
my $host_name=shift @;
my $zkey=shift @;
my $zvalue=shift @;
my $trap_cmd = $zabbix_sender.' -z '.$zabbix_server_ip.' -s '.$host_name.' -k '.$zkey.' -o "'.$zvalue.'"';
my @trapout = (); @trapout = split /\n/, `$trap_cmd`;
}
```
Через параметр -z программе zabbix\_sender передается адрес IP сервера Zabbix, через параметр -s передается имя хоста, которое в нашем случае соответствует проверяемому домену. Параметры -k и -o используются, соответственно, для передачи имени ключа и значения.
Изучив приведенный выше цикл по хэшу, вы узнаете, какая информация о доменах попадает на сервер:
* days\_before\_domain\_expire — количество дней до завершения регистрации домена;
* days\_before\_ssl\_expire — количество дней до завершения периода действия сертификата;
* domain\_ssl\_matches — сертификат на сайте соответствует доменному имени сайта;
* domain\_has\_ssl — к сайту подключен сертификат SSL;
* whois\_ok — команда whois вернула правильную информацию о домене;
* a\_found — в DNS домена обнаружена запись A;
* a — содержимое записи A для домена;
* mx\_found — в DNS домена обнаружена запись MX;
* mx — содержимое записи MX для домена
## Функция get\_domain\_info
Для организации собственной системы мониторинга доменов вам пригодится функция get\_domain\_info, которая вызывается функцией get\_opened\_domains\_from\_billing при получении хэша с данными о доменах открытых интернет-магазинов.
Функции get\_domain\_info нужно передать в качестве первого параметра доменное имя, а в качестве второго — порт, на котором работает проверяемый сайт (обычно 443). Функция записывает полученные данные в хэш domain\_info и возвращает этот хэш вызывающей функции (в нашем случае это get\_opened\_domains\_from\_billing).
Полный код функции [вы найдете на Github](https://github.com/AlexandreFrolov/shop2you_zabbix_monitoring/blob/main/domain_monitor_free_version.pl).
Прежде всего, функция get\_domain\_info записывает в хэш доменное имя, для которого она будет определять текущие параметры:
```
$domain_info->{ domain_name } = $domain_name;
```
### Получение данных о сертификате SSL
На следующем шаге функция определяет, подключен ли к сайту с этим доменным именем сертификат SSL. Для этого анализируются результаты выполнения следующей команды:
```
my $cmd = 'openssl s_client -servername '.$domain_name.' -connect '.$domain_name.':'.$ssl_port.' /dev/null';
my @rqout = ();
@rqout = split /\n/, `$cmd`;
if(scalar(@rqout) == 0)
{
$domain_info->{ domain_has_ssl }=0;
}
else
{
$domain_info->{ domain_has_ssl }=1;
…
}
```
Если на сервере нет сертификата для домена, в хэше по ключу domain\_has\_ssl записывается нулевое значение, в противном случае — значение единицы. Однако само по себе наличие выдачи результатов использованной здесь команды еще не говорит о валидности сертификата. Может быть такая ситуация, когда на сервере размещено несколько сайтов, и для сайта, у которого нет сертификата, будет получен сертификат другого сайта с этого же сервера.
Чтобы убедиться в соответствии доменного сертификата имени, на который выписан полученный сертификат, проверяем, упоминается ли проверяемое доменное имя в результатах выдачи следующей команды:
```
my $cmd_subj='echo | openssl s_client -servername '.$domain_name.' -connect '.$domain_name.':'.$ssl_port.' 2>/dev/null | openssl x509 -noout -subject';
my @subjout = ();
@subjout = split /\n/, `$cmd_subj`;
if(scalar(@subjout) != 0)
{
my $cn=@subjout[0];
if($cn=~/$domain_name/)
{
$domain_info->{ domain_ssl_matches }=1;
}
else
{
$domain_info->{ domain_ssl_matches }=0;
}
}
```
Если сертификат соответствует доменному имени, записываем в хэш для ключа domain\_ssl\_matches значение 1, если нет — значение 0. Несоответствие доменного имени сертификату в данном случае является поводом проверить сертификат данного сайта и настройку Web-сервера.
Для валидного сертификата функция get\_domain\_info получает количество дней до завершения его срока действия:
```
$cmd = 'echo | openssl s_client -servername '.$domain_name.' -connect '.$domain_name.':'.$ssl_port." 2>/dev/null | openssl x509 -noout -dates 2>/dev/null | grep notAfter | cut -d'=' -f2";
my @rqout2 = ();
@rqout2 = split /\n/, `$cmd`;
my $expires_data = str2time(@rqout2[0]);
my $current_data = time();
my $days_before_expire = int(($expires_data - $current_data) / 86400);
if($days_before_expire <= 0) { $days_before_expire = 0;}
$domain_info->{ days_before_ssl_expire }=$days_before_expire;
```
Полученное значение записывается в хэш по ключу days\_before\_ssl\_expire.
### Определение даты окончания регистрации доменного имени
Для того чтобы получить данные DNS для домена, мы используем функцию parse\_whois пакета Net::Whois::Parser:
```
my $info = parse_whois( domain => $domain_name );
my $domain_expiration_date='';
$domain_info->{ whois_ok } = 1;
if($info->{ paid_till })
{
$domain_expiration_date = $info->{ paid_till };
}
elsif ( $info->{ expiration_date })
{
$domain_expiration_date = $info->{ expiration_date };
}
elsif ( $info->{ registry_expiry_date })
{
$domain_expiration_date = $info->{ registry_expiry_date };
}
elsif ( $info->{ 'Registry Expiry Date' })
{
$domain_expiration_date = $info->{ 'Registry Expiry Date' };
}
else
{
$domain_info->{ whois_ok } = 0;
}
```
Прежде всего, функция get\_domain\_info пытается отыскать в результатах выдачи parse\_whois дату завершения регистрации доменного имени. В зависимости от сервера DNS эта дата может обозначаться в выдаче whois по-разному: «paid\_till», «expiration\_date», «registry\_expiry\_date» и «Registry Expiry Date». Не исключено, что бывают и другие варианты.
Если ни один из этих способов поиска даты завершения регистрации домена не приводит к успеху, для ключа whois\_ok записывается нулевое значение. В этом случае нужно исследовать домен вручную, и, возможно, дополнить приведенный выше фрагмент кода.
Но если дата найдена, то она преобразуется в количество дней до окончания регистрации и записывается в хэш по ключу days\_before\_domain\_expire:
```
my $expires_data = str2time($domain_expiration_date);
my $current_data = time();
my $days_before_expire = int(($expires_data - $current_data) / 86400);
$domain_info->{ days_before_domain_expire } = $days_before_expire;
if($days_before_expire < 0)
{
$domain_info->{ whois_ok } = 0;
}
```
### Получение записей A и MX из DNS
Следующий фрагмент функции get\_domain\_info используется для определения наличия в DNS записей A и MX для исследуемого домена с помощью функции get\_domain\_info\_from\_dns:
```
my $dns_info=get_domain_info_from_dns($domain_name);
if($dns_info->{ a_found })
{
my $a_str="";
my $a_counter=0;
my $dns_a_ref = $dns_info->{ address };
foreach my $dns_a (@$dns_a_ref)
{
if($a_counter > 0)
{
$a_str = $a_str.', '.$dns_a;
}
else
{
$a_str = $a_str.$dns_a;
}
$a_counter++;
}
$domain_info->{ a_found } = 1;
$domain_info->{ a } = $a_str;
}
else
{
$domain_info->{ a_found } = 0;
}
if($dns_info->{ mx_found })
{
my $mx_str="";
my $mx_counter=0;
my $mx_ref = $dns_info->{ mx };
foreach my $record (@$mx_ref)
{
my $pr = $record->preference;
my $ex = $record->exchange;
if($mx_counter > 0)
{
$mx_str = $mx_str.', '.$pr.' '.$ex;
}
else
{
$mx_str = $mx_str.$pr.' '.$ex;
}
$mx_counter++;
}
$domain_info->{ mx_found } = 1;
$domain_info->{ mx } = $mx_str;
}
else
{
$domain_info->{ mx_found } = 0;
}
```
Действия, выполняемые этим фрагментом кода, понятны и без дополнительных объяснений. Что же касается функции get\_domain\_info\_from\_dns, то она получает данные домена из DSN с помощью модуля Net::DNS::Resolver:
```
sub get_domain_info_from_dns($)
{
my $domain = shift @_;
my $res = Net::DNS::Resolver->new;
my $dinfo = {};
my @mx = mx($res, $domain);
if(@mx != 0)
{
$dinfo->{ mx_found } = 1;
$dinfo->{ mx } = \@mx;
}
else
{
$dinfo->{ mx_found } = 0;
$dinfo->{ mx_error } = $res->errorstring;
}
my $addr=();
my $rr = {};
my $query = {};
$dinfo->{ a_found } = 0;
$query = $res->search($domain);
if ($query)
{
foreach $rr ($query->answer)
{
next unless ($rr->type eq "A");
push @$addr, $rr->address;
$dinfo->{ a_found } = 1;
}
}
$dinfo->{ address } = $addr;
return($dinfo);
}
```
## Функции для работы с Zabbix API
Для работы с Zabbix API наша программа использует модуль Zabbix::Tiny: или .
По адресу есть решения для интеграции на разных языках программирования.
### zabbix\_open
Функция zabbix\_open вызывает конструктор модуля Zabbix::Tiny:
```
sub zabbix_open($)
{
my $z = shift @_;
my $zabbix = Zabbix::Tiny->new(
server => $z->{ zabbix_server_url },
password => $z->{ zabbix_server_password },
user => $z->{ zabbix_server_login },
ip => $z->{ zabbix_server_ip },
);
return $zabbix;
}
```
### get\_group\_id
Функция get\_group\_id получает от Zabbix API идентификатор группы по ее имени:
```
sub get_group_id($$)
{
my $z = shift @_;
my $group_name = shift @_;
my $params = {
output => [qw(groupid name)],
filter => { name => [$group_name] }
};
my $result = $z->do(
'hostgroup.get',
$params
);
return $result->[0]->{ groupid };
}
```
### get\_group\_hosts
Функция get\_group\_hosts возвращает хосты для группы с заданным именем и вызывается функцией get\_all\_monitored\_domains:
```
sub get_group_hosts($$)
{
my $z = shift @_;
my $group_name = shift @_;
my $gid = get_group_id($z, $group_name);
my $params = {
output => [qw(hostid name host)],
groupids => [$gid],
};
my $result = $z->do(
'host.get',
$params
);
return $result;
}
```
В нашем случае эти хосты представляют собой доменные имена, для которых нужно контролировать сертификаты SSL.
### get\_template\_id
Чтобы по имени шаблона получить его идентификатор, используется функция get\_template\_id:
```
sub get_template_id($$)
{
my $z = shift @_;
my $template_name = shift @_;
my $params = {
output => [qw(templateid name)],
filter => { name => [$template_name] }
};
my $result = $z->do(
'template.get',
$params
);
return $result->[0]->{ templateid };
}
```
### create\_host
Для мониторинга каждого доменного имени программа domain\_monitor.pl создает отдельный хост, вызывая для этого функцию create\_host:
```
sub create_host($$$$$)
{
my $z = shift @_;
my $host_name = shift @_;
my $name = shift @_;
my $group_name = shift @_;
my $template_name = shift @_;
my $gid = get_group_id($z, $group_name);
my $template_id = get_template_id($z, $template_name);
my $params = {
host => $host_name,
name => $name,
interfaces => [{type => 1, main => 1, useip => 1, ip => '127.0.0.1', dns => "", port => '443'}],
groups => [{ groupid => $gid }],
templates => [{ templateid => $template_id }],
};
my $result = $z->do(
'host.create',
$params
);
return $result;
}
```
В качестве параметров этой функции передаются соединение с сервером Zabbix, имя хоста (то есть имя контролируемого домена), имя группы и шаблона.
### get\_host\_id
Функция get\_host\_id возвращает идентификатор хоста, заданного своим именем:
```
sub get_host_id($$)
{
my $z = shift @_;
my $host_name = shift @_;
my $params = {
output => [qw(hostid name)],
filter => { name => [$host_name] }
};
my $result = $z->do(
'host.get',
$params
);
return $result->[0]->{ hostid };
}
```
### delete\_host
Если интернет-магазин закрылся, то его сайт нужно удалить из мониторинга. Функция delete\_host удаляет хост по его идентификатору:
```
sub delete_host($$)
{
my $z = shift @_;
my $hostid = shift @_;
my $params = [ $hostid ];
my $result = $z->do(
'host.delete',
$params
);
return $result;
}
```
### get\_all\_monitored\_domains
Чтобы получить все домены, которые находятся на мониторинге, программа domain\_monitor.pl вызывает функцию get\_all\_monitored\_domains. Она возвращает все хосты для группы с заданным именем:
```
sub get_all_monitored_domains($$)
{
my $z = shift @_;
my $group_name = shift @_;
return get_group_hosts($z, $group_name);
}
```
### create\_missing\_domain\_in\_zabbix
Функция create\_missing\_domain\_in\_zabbix добавляет хосты в мониторинг, пользуясь для этого ссылкой на хэш hosts и функцией create\_host:
```
sub create_missing_domain_in_zabbix($$$$$)
{
my $z=shift @_;
my $domains_group_name=shift @_;
my $domains_template_name=shift @_;
my $domains_from_billing=shift @_; # from Billing
my $domains_from_zabbix=shift @_; # from Zabbix
foreach my $key (keys %$domains_from_billing)
{
my $host_name;
my $name;
if($key)
{
$host_name = $domains_from_billing->{$key}->{domain_name};
my $pcode_used = $domains_from_billing->{$key}->{punycode_used};
if($pcode_used)
{
$name = $domains_from_billing->{$key}->{domain_name_from_billing};
}
else
{
$name = $domains_from_billing->{$key}->{domain_name};
}
my ($found, $zbx_hostid) = find_in_monitored_domains($host_name, $domains_from_zabbix);
if($found == 0)
{
print("$name to be CREATED \n");
Encode::_utf8_on($name);
my $hsts = create_host($z, $host_name, $name, $domains_group_name, $domains_template_name);
}
}
}
}
```
При этом учитывается, что имена доменов могут быть в кодировке Punyсode.
### delete\_closed\_domains\_from\_zabbix
И, наконец, функция delete\_closed\_domains\_from\_zabbix удаляет из мониторинга хосты, которые соответствуют сайтам прекративших свою работу интернет-магазинов:
```
sub delete_closed_domains_from_zabbix($$$$$)
{
my $z=shift @_;
my $domains_group_name=shift @_;
my $domains_template_name=shift @_;
my $domains_from_billing=shift @_; # from Billing
my $domains_from_zabbix=shift @_; # from Zabbix
foreach my $arg (@$domains_from_zabbix)
{
my $cdomain = $arg->{host};
my $zbx_hostid = $arg->{hostid};
my $found_in_billing=find_domain_in_billing($cdomain, $domains_from_billing);
if($found_in_billing == 0)
{
print("$cdomain NOT found in Billing, to be REMOVED. zbx_hostid = $zbx_hostid \n");
my $rc = delete_host($z, $zbx_hostid);
}
}
}
```
Вам нужно будет самостоятельно реализовать функцию find\_domain\_in\_billing для поиска таких сайтов в вашей CRM.
## Шаблон мониторинга доменов
Шаблон мониторинга доменных имен и сертификатов вы можете загрузить [из Github](https://github.com/AlexandreFrolov/shop2you_zabbix_monitoring/blob/main/shop2you_domains_monitoring_template.xml).
В этом шаблоне определены ключи, о которых мы говорили в нашей статье (рис. 2).
Рис. 2. Ключи в шаблоне мониторинга доменных имен и сертификатов
Триггеры показаны на рис. 3.
Рис. 3. Триггеры для мониторинга данных доменов и сертификатов
Здесь мы назначили среднюю серьезность только для триггеров **Domain registration expires in 30 days** (регистрация домена закончится через 30 дней) и **SSL expired in 7 days** (срок действия сертификата истекает через 7 дней). Остальные триггеры только для информации.
Вы, конечно, можете настроить эти триггеры по своему усмотрению.
## Запуск задания crontab
Для запуска программы проверки сроков регистрации доменных имен и срока действия сертификатов SSL подготовьте задание crontab, например, такое:
```
34 3 * * * /usr/bin/perl /home/frolov/zabbix_domain_monitoring/domain_monitor.pl
```
Здесь проверка запускается каждый день ночью, в 3 часа 34 минуты.
*Автор: Александр Фролов.*