Мониторинг срока действия сертификатов в Windows

[victor]

Можно сертификат передавать как параметр:

ExternalParameter = HTTPS.CertificateExpireDate(*): powershell.exe -file "\\Scripts\test.ps1" -cert "$1"

и в скрипте имя сертификата получать из переменной.

На стороне сервера будет что-то вроде

HTTPS.CertificateExpireDate(cert1)

[filimonic]

Спасибо.
Получилось сделать вот такой мониторинг: Выбрать все сертификаты в хранилище ОС (LocalMachine\My), выбрать среди них тот, которых протухает ближе всего, выдать мониторингу цифру "дней до истечения сертификата".
Недостатком является то, что я не вижу, какой именно сертификат протухает.

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

Я предположил что это можно сделать с помощью ExternalTable. Верно ли?
Вывод скрипта, судя по инструкции, должен быть таким:

CertificateName|CertificateTTLDays
*.site111.com|200
*.site222.com|120
_ALL_CERTS_|120

И ожидаю что в NetXMS будут видны все сертификаты для конкретного сервера.

К сожалению из документации строка ExternalTable совершенно мне не понятна

ExternalTable=dciName:instanceColumns=columnName;description=description;separator=|:command

А "живых" примеров использования у меня найти не получилось.
Что в этой строке есть что - вообще не понятно. Прошу как-то помочь.

Спасибо за вашу работу.

[victor]

В ExternalTable идет три поля, разделенных : - имя таблицы, параметры, и команда. Параметры разделяются ; и могут быть такими:

separator= символ - разделитель, по умолчанию запятая.
instanceColumns= колонка/колонки в которых содержится уникальный идентификатор для строки.
description= описание таблицы.

Второй вариант - это использовать instance discovery. Тогда остается параметр для получения срока действия сертификата, и делается ExternalList который выдает список всех сертификатов в системе, и используется для instance discovery. Тогда для каждого сертификата будет создан отдельный DCI, на котором уже могут быть трешолды как обычно.

[Retif]

@victor said in Мониторинг срока действия сертификатов в Windows:

Второй вариант - это использовать instance discovery. Тогда остается параметр для получения срока действия сертификата, и делается ExternalList который выдает список всех сертификатов в системе, и используется для instance discovery. Тогда для каждого сертификата будет создан отдельный DCI, на котором уже могут быть трешолды как обычно.

Вот этот вариант мне нравится. Только полностью разобраться не могу что-то все равно.

Что я хочу. Чтобы эти отдельные DCI создались с именем (Description?), в котором будет присутствовать имя сертификата (например friendly name). Ну а значением будет количество дней, то же самое, что сейчас скриптом отдается. И дальше уже всё как с ExternalParameter.

Реализация не очень понятна.

1. Я создаю параметр CertificateExpireDate, в нем указываю в качестве параметра HTTPS.CertificateExpireDate(*) со звездочкой в скобках - это значит с инстансами?

2. На вкладке Instance Discovery я выбираю в качестве метода Agent List? А в List Name что писать, HTTPS.CertificateExpireDate?

3. В конфиге агента, я вместо

ExternalParameter = HTTPS.CertificateExpireDate: powershell.exe -file "\\server\Scripts\test.ps1"

пишу

ExternalList = HTTPS.CertificateExpireDate(*): powershell.exe -file "\\server\Scripts\test.ps1"

4. А в скрипте... тут не очень понятно. Я получаю все имена сертификатов и для каждого количество дней. А как возвращать это для NetXMS, чтобы оно преобразовалось в  имена и значения этих DCI?

З.Ы.  И можно какой-нибудь живой пример не для сертификатов, а для чего угодно с этими инстансами и ExternalList?

[victor]

Здесь понадобится два скрипта. Делается примерно так:

1. Делаем список HTTPS.Certificates

ExternalList = HTTPS.Certificates:script1.cmd

Скрипт должен выдавать список сертификатов, каждый в своей строчке.

2. Изменяем параметр HTTPS.CertificateExpireDate чтобы он принимал имя сертификата:

ExternalParameter = HTTPS.CertificateExpireDate(*): powershell.exe -file "\\server\Scripts\test.ps1" -certname $1

Насколько я знаю power shell можно будет в скрипте получить имя сертификата в переменной certname. Дальше в скрипте все как сейчас.

3. Делаем DCI на сервере:
   Параметр

HTTPS.CertificateExpireDate({instance})

Instance discovery method: agent list
Имя списка: HTTPS.Certificates

[Retif]

Супер, всё получилось! Спасибо! Я почему-то думал, что ExternalList, он вместо ExternalParameter, а они вместе, оказывается.

Как-то так вышло:

Пара вопросов возникла еще:

1. Сейчас ExternalList отвечает в формате "(Название) - (Идентификатор)", соответственно, в ExternalParameter этот текст передается в таком же виде и в интерфейсе отображается в таком же виде.
   Это неудобно визуально, потому что идентификатор (THUMBPRINT) большой и бесполезный для отображения.
   Можно ли как-то через ExternalList получить отдельно две части - название и идентификатор, в ExternalParameter передавать только идентификатор, а отображать только название?

2. Нужно изменить конфиг агента на группе серверов. Не для всех, а только для каких-то, например для находящихся в контейнере. Для этого нужно использовать Agent configuration policy? Прочитал документацию про это, но что-то не понял, можно ли сделать на группу серверов. Или правильней для всех серверов одинаковый мастер-конфиг с netxms подтягивать, просто не использовать потом, что не нужно?

3. В макросах для Event Processing не смог получить количество дней, которое выдается в Value DCI-инстанса. %<currentValue> и %<dciValue> что-то пустоту выдают.

---

[Retif]

Ап...

[victor]

@retif said in Мониторинг срока действия сертификатов в Windows:

1. Сейчас ExternalList отвечает в формате "(Название) - (Идентификатор)", соответственно, в ExternalParameter этот текст передается в таком же виде и в интерфейсе отображается в таком же виде.
   Это неудобно визуально, потому что идентификатор (THUMBPRINT) большой и бесполезный для отображения.
   Можно ли как-то через ExternalList получить отдельно две части - название и идентификатор, в ExternalParameter передавать только идентификатор, а отображать только название?

Можно использовать instance discovery filter - там можно вернуть отдельно значение instance и отдельно instance name, например так:

instance = $1;
if (instance ~= "(.*) - (.*)")
{
   return %(true, instance, $1);
}
return true;

и в поле description для DCI использовать {instance-name} вместо {instance}.

@retif said in Мониторинг срока действия сертификатов в Windows:

2. Нужно изменить конфиг агента на группе серверов. Не для всех, а только для каких-то, например для находящихся в контейнере. Для этого нужно использовать Agent configuration policy? Прочитал документацию про это, но что-то не понял, можно ли сделать на группу серверов. Или правильней для всех серверов одинаковый мастер-конфиг с netxms подтягивать, просто не использовать потом, что не нужно?

Да, можно использовать политику и наложить на несколько серверов. Как вариант - использовать функцию автоматического наложения, по аналогии с шаблонами.

@retif said in Мониторинг срока действия сертификатов в Windows:

3. В макросах для Event Processing не смог получить количество дней, которое выдается в Value DCI-инстанса. %<currentValue> и %<dciValue> что-то пустоту выдают.

Это при обработке события по срабатыванию threshold?

[Retif]

@victor said in Мониторинг срока действия сертификатов в Windows:

Это при обработке события по срабатыванию threshold?

Да, именно.

@victor said in Мониторинг срока действия сертификатов в Windows:

Можно использовать instance discovery filter - там можно вернуть отдельно значение instance и отдельно instance name, например так:

instance = $1;
if (instance ~= "(.*) - (.*)")
{
   return %(true, instance, $1);
}
return true;

и в поле description для DCI использовать {instance-name} вместо {instance}.

Да, так всё получилось, спасибо

[Retif]

По результатам темы написал статью на хабр: https://habr.com/ru/post/460193/