Политики оповещения
События, отправленные с компонентов DSS при помощи настроенных ранее плагинов, доставляются на Сервис рассылки уведомлений. Здесь происходит получение информации о доступных способах доставки (Email, SMS, PUSH), а также контактной информации из профиля Пользователя или Оператора, которому должно быть доставлено уведомление. Для получения данной информации необходимо настроить политику оповещения для Пользователей и Операторов.
Политика оповещения Пользователей
Политика оповещения Пользователей состоит из трех уровней:
- глобального,
- уровня группы,
- уровня Пользователя (настройка доступна только через веб- и REST-интерфейсы).
Политика оповещения Пользователей заполняется при помощи командлета Set-DssNotificationPolicy и представляет собой набор следующих настроек:
| Параметр | Тип | Описание |
|---|---|---|
| Type | User |
Определяет, для кого настраивается политика. |
| Notifiers | SMS, Email, PUSH (1 или несколько через запятую) |
Список назначений для отправки уведомлений о событиях, указанных в параметре Notifiers. |
| GroupID | int | Идентификатор группы, если необходимо настроить политику уровня группы. |
| NotificationEvents | AllNotificationEvents ИЛИ Notifiers {}(пустой список) ИЛИ Notifiers (1 или несколько через запятую) |
Набор событий, о которых необходимо оповещать. |
| AllowChangeByOperator | bool | Определяет, может ли Оператор изменять политику оповещения Пользователя в веб-интерфейсе. |
| AllowChangeByUser | bool | Определяет, может ли Пользователь изменять политику оповещения в веб-интерфейсе. |
| AllowOverride | bool | Определяет, может ли политика быть переопределена на более низком уровне иерархии. |
Примечание
В зависимости от того, политика какого уровня настраивается — глобального уровня или уровня группы —
необходимо также соответственно использовать параметр –GroupId со значением идентификатора
настраиваемой группы. Для заполнения глобальной политики специальный параметр указывать не требуется.
Если в иерархии политик есть политика с AllowOverride = false, настройки политики уровнем ниже
не имеют силы. Если все политики в иерархии имеют AllowOverride = true, параметры
AllowChangeByUser и AllowChangeByOperator используются из политики группы, а настройка самого
оповещения применяется индивидуально для каждого Пользователя (настраивается в
Веб-интерфейсе Пользователя).
Примечание
Перед изменением настроек политики оповещения при помощи командлетов (глобальный уровень
или уровень группы), убедитесь, что на уровень выше не применялось значение AllowOverride = false.
Политика оповещения Операторов
Политика оповещения Операторов состоит из двух уровней:
- глобального,
- уровня Оператора (настройка доступна только через веб- и REST-интерфейсы).
Политика оповещения Пользователей заполняется при помощи командлета Set-DssNotificationPolicy и представляет собой набор следующих настроек:
| Параметр | Тип | Описание |
|---|---|---|
| Type | Operator |
Определяет, для кого настраивается политика. |
| Notifiers | SMS, Email (1 или оба через запятую) |
Список назначений для отправки уведомлений о событиях, указанных в параметре Notifiers. |
| NotificationEvents | AllNotificationEvents ИЛИ {}(пустой список) ИЛИ Notifiers (1 или несколько через запятую) |
Набор событий, о которых необходимо оповещать. |
| AllowChangeByOperator | bool | Определяет, может ли Оператор изменять политику оповещения в веб-интерфейсе. |
| AllowOverride | bool | Определяет, может ли политика быть переопределена на более низком уровне иерархии. |
Если в глобальной политике имеется значение AllowOverride = false, настройки политики уровня
Оператора на веб-интерфейсе будут недоступны. Если глобальная политика AllowOverride = true,
параметр AllowChangeByOperator применяется индивидуально для каждого Оператора
(настраивается в его личном кабинете на веб-интерфейсе или при помощи REST API).
Примеры:
Оповещение Пользователей
Получение политики оповещения Пользователей по уровням
# Получение глобальной политики:
Get-DssNotificationPolicy -Type User
# Если в выводе данной команды содержится AllowOverride = False,
# настройки уровня группы не имеют силы.
# Получение политики группы Пользователей
Get-DssNotificationPolicy -Type User -GroupId 1
# Если в выводе данной команды содержится AllowOverride = False,
# Пользователь не сможет изменить политику доступа к операциям в Веб-
# интерфейсе.
# Просмотр списка событий с указанием настроенных способов доставки для каждого события:
(Get-DssNotificationPolicy -Type User ).EventNotifiers
Настройка политики оповещения Пользователей без возможности редактирования
Данный пример позволяет настроить оповещение Пользователей. При этом Пользователи НЕ могут изменять список событий, о которых они получают оповещения.
# Оповещать Пользователей о всех событиях:
Set-DssNotificationPolicy -Type User -AllNotificationEvents -Notifiers SMS,Email -AllowOverride 0
# НЕ оповещать Пользователей ни о каких событиях:
Set-DssNotificationPolicy -Type User -AllNotificationEvents -Notifiers @() -AllowOverride 0
# Указать набор событий, о которых необходимо оповещать Пользователей:
Set-DssNotificationPolicy -Type User -NotificationEvents CertificateCreated,DeviceConfirmed -Notifiers SMS,Email
ИЛИ
Set-DssNotificationPolicy -Type User -NotificationEvents 1, 2 -Notifiers SMS,Email
# Выбор способа доставки для всех событий SMS и Email:
Set-DssNotificationPolicy –Type User -AllNotificationEvents -Notifiers SMS,Email
Примечание
В случае, если необходимо изменить политику группы, следует добавлять параметр –GroupId <ID
группы>.
Примечание
Если для какого-либо события уже был задан параметр -Notifiers, следующее его заполнение для
данного события перезапишет все указанные способы доставки. Т.е. при изменении данного параметра
каждый раз нужно указывать все необходимые способы доставки.
Настройка политики оповещения Пользователей с возможностью редактирования
Данный пример позволяет настроить оповещение Пользователей. При этом Пользователи могут изменять список событий, о которых они получают оповещения, в Веб-интерфейсе Пользователя.
$allowChangeByUser = $true
$groupId = <Идентификатор группы Пользователей>
Set-DssNotificationPolicy -AllowOverride 1
Set-DssNotificationPolicy -AllowOverride 1 -IdpId (Get-DssIdentityProvider -IssuerName realsts).Id
Set-DssNotificationPolicy -AllowOverride 1 -GroupId $groupId -AllowChangeByUser $allowChangeByUser
Полный список событий и их кодов.
Оповещение Операторов
Примечание
Для редактирования политики оповещения Операторов следует указывать параметр -Type Operator
и > НЕ использовать параметр –GroupId <ID группы>.
Получение политики оповещения Операторов
# Получение глобальной политики:
Get-DssNotificationPolicy -Type Operator
# Если в выводе данной команды содержится AllowOverride = False,
# Оператор не сможет самостоятельно настраивать политику в своем
# личном кабинете на веб-интерфейсе.
# Просмотр списка событий с указанием настроенных способов доставки для каждого события:
(Get-DssNotificationPolicy -Type Operator ).EventNotifiers
Настройка политики оповещения Операторов без возможности редактирования
Данный пример позволяет настроить оповещение Операторов. При этом Операторы НЕ могут изменять список событий, о которых они получают оповещения.**
# Оповещать Операторов о всех событиях:
Set-DssNotificationPolicy -Type Operator -AllNotificationEvents -Notifiers SMS,Email -AllowOverride 0
# НЕ оповещать Операторов ни о каких событиях:
Set-DssNotificationPolicy -Type Operator -AllNotificationEvents -Notifiers @() -AllowOverride 0
# Указать набор событий, о которых необходимо оповещать Операторов:
Set-DssNotificationPolicy -Type User -NotificationEvents CertificateCreated,DeviceConfirmed -Notifiers SMS,Email
ИЛИ
Set-DssNotificationPolicy -Type User -NotificationEvents 1, 2 -Notifiers SMS,Email
# Выбор способа доставки для всех событий SMS и Email:
Set-DssNotificationPolicy –Type User -AllNotificationEvents -Notifiers SMS,Email
Настройка политики оповещения Операторов с возможностью редактирования
Данный пример позволяет настроить оповещение Пользователей. При этом Пользователи могут изменять список событий, о которых они получают оповещения, в Веб-интерфейсе Пользователя.
$allowChangeByUser = $false
$allowChangeByOperator = $true
$groupId = 1
Set-DssNotificationPolicy -AllowOverride 1
Set-DssNotificationPolicy -AllowOverride 1 -IdpId (Get-DssIdentityProvider -IssuerName realsts).Id
Set-DssNotificationPolicy -AllowOverride 1 -GroupId $groupId -AllowChangeByUser $allowChangeByUser -AllowChangeByOperator $allowChangeByOperator
Отключение оповещения обо всех событиях
Для того чтобы отключить оповещение обо всех событиях, необходимо указать флаг
AllNotificationEvents и в параметре Notifier передать пустой список типов оповещения.
Set-DssNotificationPolicy -Type <User ИЛИ Operator> -AllNotificationEvents -GroupId <ID группы, если -type User> -Notifier @()