Политики оповещения
События, отправленные с компонентов 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).
Примеры:
Примечание
Примеры составлены для случая, когда редактируется политика оповещения Пользователей. Для
редактирования политики оповещения Операторов следует указывать параметр -Type Operator и
НЕ использовать параметр –GroupId <ID группы>.
Получение политики оповещения Пользователей по уровням:
# Получение глобальной политики:
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, следующее его заполнение для
данного события перезапишет все указанные способы доставки. Т.е. при изменении данного параметра
каждый раз нужно указывать все необходимые способы доставки.
Отключение оповещения обо всех событиях
Для того чтобы отключить оповещение обо всех событиях необходимо в параметре Notifier передать пустой список типов оповещения.
Примечание
Отключение оповещения обо всех событиях необходимо выполнить перед настройкой оповещение только о выделенных событиях.
Set-DssNotificationPolicy -Type User -AllNotificationEvents -GroupId 1 -Notifier @()