Формирование отчета о защите тенантов

Процедура формирования отчета автоматизирована средствами REST API Сервера интеграции.

В запросе к REST API вы можете передавать следующие параметры формирования отчета:

• идентификатор тенанта, о защите которого вы хотите получить отчет;
• дата и время начала периода, за который вы хотите получить отчет;
• дата и время окончания периода, за который вы хотите получить отчет.

Если в запросе не указан идентификатор тенанта, отчет будет включать в себя данные обо всех виртуальных машинах, которые находились под защитой в указанный период. В том числе, о виртуальных машинах, которые не принадлежат тенантам.

Если в запросе не указан период формирования отчета, в отчет войдут данные с самой ранней из дат, зафиксированных в базе данных Сервера интеграции, и до текущего момента.

Для получения достоверной информации в отчетах при формировании отчетного периода рекомендуется следовать правилам:

• задавать отчетный период с точностью до дня;
• устанавливать окончание отчетного периода не менее чем через 60 минут от текущего момента.

В результате выполнения процедуры формирования отчета возвращается идентификатор отчета. В зависимости от версии Сервера интеграции отчет сохраняется по следующему пути:

• /var/opt/kaspersky/viis/common/reports – защищенная служебная директория Сервера интеграции на базе Linux.
• %ProgramData%\Kaspersky Lab\VIISLA\protectionPeriodsReports – защищенная служебная папка Сервера интеграции на базе Windows.

Отчет хранится по умолчанию 24 часа с момента формирования. Чтобы получить отчет, вам нужно использовать идентификатор отчета в запросе к REST API для выгрузки отчета.

Вы можете настроить срок хранения отчета с помощью параметра ProtectionPeriodsRecordsLifetimeDays в секции Multitenancy в конфигурационном файле Сервера интеграции appsettings.json. В зависимости от версии Сервера интеграции файл расположен по следующему пути:

• /var/opt/kaspersky/viis/common/ – файл Сервера интеграции на базе Linux.
• %ProgramFiles(x86)%\Kaspersky Lab\Kaspersky VIISLA\ – файл Сервера интеграции на базе Windows.

Данные в отчете представлены построчно. В каждой строке содержится информация об одном периоде защиты виртуальной машины в следующем формате:

{идентификатор тенанта};{название тенанта};{идентификатор виртуальной машины};{имя виртуальной машины};{дата и время включения защиты};{дата и время выключения защиты}

где:

• {идентификатор тенанта} – идентификатор тенанта, которому принадлежит виртуальная машина. Если виртуальная машина не принадлежит ни одному тенанту, в поле ничего не указывается.
• {название тенанта} – название тенанта, заданное при создании тенанта. Если виртуальная машина не принадлежит ни одному тенанту, в поле ничего не указывается.
• {идентификатор виртуальной машины} – идентификатор виртуальной машины, которая находилась под защитой Kaspersky Security.
• {имя виртуальной машины} – имя виртуальной машины, которая находилась под защитой Kaspersky Security.
• {дата и время включения защиты} – дата и время начала периода защиты виртуальной машины.
• {дата и время выключения защиты} – дата и время окончания периода защиты виртуальной машины.

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