Сбор статистики по обученным аутентификаторам пользователей

Информация

Скрипт для сбора статистики вы можете скачать по этой ссылке. 

Предварительные требования

• Установленный модуль Active Directory для PowerShell в Windows Server.
• Работоспособный сервер Indeed AM. 
• Пользователь, от имени которого будет запускаться скрипт, должен обладать минимальными глобальными правами  Инспектор в системе Indeed AM.

Как работает скрипт

Работа скрипта состоит из нескольких этапов:

1. Скрипт перебирает идентификаторы политик из массива конфигурационного файла Config.ps1.
2. С помощью метода /api/v5/policy/get запрашивается информация о политике.
3. Из свойства области действия запрашивается информация по настроенным объектам с помощью метода /api/v5/userCatalog/getObjects.
4. Из полученных объектов запрашиваются пользователи:
   • С помощью командлета PowerShell Get-ADGroup в функции getUsersCN файла Base/AdditionalFunctions/GetUsers.ps1 для группы Active Directory.  
   • С помощью командлета PowerShell Get-ADUser в функции getUsersOU файла Base/AdditionalFunctions/GetUsers.ps1 для подразделения Active Directory. 
5. По полученным пользователям составляется отчет по состоянию аутентификаторов, которые указаны в переменной AuthForReport файла Config.ps1.
   • С помощью метода /api/v5/authenticator/findByUserIds запрашивается информация со всеми внутренними GUID аутентификаторов пользователя.
   • С помощью метода /api/v5/authenticator/getUserAuth запрашивается информация по конкретному GUID. 
6. С помощью функции addDataToCSV файла Base/AdditionalFunctions/CsvReport.ps1 собирается таблица в формате CSV.

Настройка

Для работы скрипта необходимо сконфигурировать файл Config.ps1, который находится в корне папки со скриптом. 

В файле:

• $serverUrl — URL сервера Indeed AM. Обязательный параметр.

• $logsOnFile — включение\отключение логирования в файл. Обязательный параметр. По умолчанию включено.

• $logsOnConsole — включение\отключение логирования в консоль. Обязательный параметр. По умолчанию отключено.  

• $apiVersion — версия API, используемая в скрипте. Обязательный параметр. Значение по умолчанию: v5.

• $policyIds —  идентификаторы политик, из области действия которых запрашиваются пользователи. 

• $AuthForReport — в переменной указываются GUID аутентификаторов Indeed и их название для отчета. Название может быть произвольным. Значения указываются в следующем формате: 'GUID' = "Наименование".

  Пример настройки для Indeed Key и Passcode

  $AuthForReport      = @{
      'F696F05D-5466-42b4-BF52-21BEE1CB9529' = 'Passcode'
      'DEEF0CB8-AD2F-4B89-964A-B6C7ECA80C68' = 'Push-уведомление в Indeed Key'
  }

• $csvPathToReport — путь до CSV-файла отчета. По умолчанию файл создается в папке скрипта по пути Reports\Statistics.

Пример работы

1. Для запуска скрипта запустите файл main.ps1.

2. В процессе работы скрипта по пути из переменной $csvPathToReport будет создан файл формата CSV. 

   Примечание

   Пользователи добавляются в отчёт последовательно.