Avanpost FAM/MFA+ : 5.1.2. Управление оповещениями

В Avanpost FAM имеется набор функциональностей, позволяющих гибко настраивать оповещения и уведомления пользователей. Используя данный инструментарий, администратор имеет возможность определять в каких ситуациях (например, смена телефонного номера, успешная регистрация, изменение пароля и т.п.) и какие типы уведомлений (SMS, Email, push-уведомления) будут направляться пользователю. Также администратор имеет возможность управлять структурой и наполнением различных уведомлений, редактируя HTML-шаблоны.

Представленные инструменты позволяют решать следующие задачи:

  • выполнять общую настройку политик оповещения пользователей;
  • определять типы ситуаций, в которых пользователю направляется оповещение;
  • определять типы оповещений, направляемых пользователю;
  • осуществлять настройку шаблонов уведомлений, отправляемых пользователям;
  • настраивать шаблоны уведомлений изменения пароля.

Для получения информации о настройках SMTP-провайдеров рекомендуется обратиться к статье Настройка метода Email OTP.

Управление политиками оповещения пользователей

Функциональность управления политиками оповещения пользователей позволяет осуществить гибкую настройку правил, по которым пользователю будут отправляться уведомления.

Функциональность позволяет устанавливать правила для следующих способов оповещения пользователей:

  • электронная почта;
  • push-уведомления;
  • SMS-сообщения.

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

  • успешная регистрация пользователя;
  • успешная авторизация пользователя;
  • изменение учетных данных (Email, номер телефона);
  • изменение пароля.

В случае смены пароля на стороне внешнего LDAP-каталога и последующего обновления данного пароля в FAM (например, в процессе аутентификации) уведомление пользователю не направляется. Уведомление о смене пароля направляется пользователю исключительно в случае изменения пароля средствами FAM (в личном кабинете пользователя или в интерфейсе административной консоли).

Для настройки следует перейти в режиме "Сервис" в раздел "Настройки отправки уведомлений и OTP-кодов" в подраздел "Настройки оповещений пользователей". Подраздел содержит следующую информацию и возможности:

  • Реестр с существующими правилами оповещения:
    • Наименование Название существующих правил оповещения пользователей;
    • Кнопка "Сделать по умолчанию" Нажать, чтобы созданное правило назначить по умолчанию (правило, назначенное по умолчанию, отмечено статусом "По умолчанию");
  • Кнопку "Добавить новую настройку правил оповещения" Нажать, чтобы создать новые правила оповещения.

Для добавления новых правил оповещения требуется нажать кнопку "Добавить новую настройку правил оповещения" и задать следующие параметры.

ПараметрОписание
НаименованиеНазвание создаваемых правил оповещений пользователей
Email (отправка уведомлений на электронную почту)

Отправлять приветственное сообщение при регистрации

При включенном чекбоксе на email пользователя отправляется уведомление после регистрации в Avanpost FAM. 

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

Отправлять пользователю сообщение о смене адреса электронной почты, указанной для учетной записи

При включенном чекбоксе пользователю отправляется уведомление о смене email учетной записи на адрес электронной почты, который был привязан до изменений.

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

Отправлять пользователю сообщение о смене номера телефона, указанного для учетной записи

При включенном чекбоксе на email пользователя отправляется уведомление о смене номера телефона пользователя.

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

Отправлять пользователю сообщение о смене пароля учетной записи

При включенном чекбоксе на email пользователя отправляется уведомление о смене пароля УЗ.

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

Отправлять пользователю сообщение об успешном входе в систему

При включенном чекбоксе на email пользователя отправляется уведомление об успешном входе в Avanpost FAM.

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

Push (отправка уведомлений в мобильное приложение Avanpost Authenticator)

Отправлять приветственное сообщение при регистрации

При включенном чекбоксе в приложении Avanpost Authenticator отправляется приветственное push-уведомление о регистрации в Avanpost FAM. 
Отправлять пользователю сообщение о смене адреса электронной почты, указанной для учетной записиПри включенном чекбоксе в приложении Avanpost Authenticator отправляется push-уведомление при смене email, привязанного к УЗ пользователя.
Отправлять пользователю сообщение о смене номера телефона, указанного для учетной записиПри включенном чекбоксе в приложении Avanpost Authenticator отправляется push-уведомление при смене номера телефона, привязанного к УЗ пользователя.
Отправлять пользователю сообщение о смене пароля учетной записиПри включенном чекбоксе в приложении Avanpost Authenticator отправляется push-уведомление при смене пароля от аккаунта пользователя.
Отправлять пользователю сообщение об успешном входе в системуПри включенном чекбоксе в приложении Avanpost Authenticator отправляется push-уведомление при успешном входе в систему.
SMS (отправка уведомлений по SMS)

Отправлять пользователю сообщение о смене пароля учетной записи

При включенном чекбоксе на номер телефона, привязанный к УЗ, отправляется SMS при смене пароля от аккаунта пользователя.

Для сохранения настроенной политики оповещения нажать кнопку "Сохранить", для отказа от изменений кнопку "Отменить".

Для редактирования ранее созданных правил оповещения требуется перейти в профиль, нажав на наименование искомого правила в разделе "Настройки оповещений пользователей".  В профиле следует нажать, внести необходимые изменения и нажать кнопку "Сохранить" для сохранения изменений или кнопку "Отменить" для отказа от изменений. Для удаления ранее созданных правил оповещения следует нажать кнопку и подтвердить действие.

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

Управление почтовыми уведомлениями

Avanpost FAM предоставляет администратору функциональность настройки сообщений, отправляемых на электронную почту новых пользователей продукта. Создание и редактирование оповещений возможно следующими способами:

  • редактированием шаблонов оповещений в административной консоли Avanpost FAM;
  • редактированием HTML-шаблонов (для приветственных сообщений). 

Редактирование шаблонов оповещений в административной консоли проводится в подразделе "Редактор шаблонов уведомлений" раздела "Настройки отправки уведомлений и OTP-кодов", доступного из режима "Сервис". Подраздел содержит следующую информацию и возможности:

  • Реестр шаблонов уведомлений:
    • Наименование Название шаблона;
    • Заголовок — Заголовок шаблона;
  • Кнопка "Создать" — Нажать для создания нового шаблона уведомлений.

Для создания нового шаблона уведомлений требуется нажать кнопку "Создать" в разделе "Редактор шаблонов уведомлений" и задать значения следующих параметров.

ПараметрОписание
НаименованиеЗадать уникальное название шаблона уведомлений.
ЗаголовокВвести заголовок уведомления.
HTMLВвести текст шаблона, используя синтаксис языка разметки HTML5.

Для сохранения шаблона оповещения нажать кнопку "Сохранить", для отказа от изменений кнопку "Отменить".

Редактирование и дополнительные действия с шаблоном доступны из его профиля, переход в который осуществляется из раздела "Редактор шаблонов уведомлений". Доступны следующие действия с шаблоном:

  • Редактирование ранее настроенных параметров;
  • Добавление/удаление вложений;
  • Удаление шаблона;
  • Рассылка шаблона выбранным пользователям/группам пользователей.

Для редактирования требуется нажать кнопку. Для редактирования доступны следующие параметры:

  • Наименование Название шаблона;
  • Заголовок Заголовок шаблона;
  • HTML Текст шаблона;
  • Вложение Дополнительное вложение в оповещение: для добавления вложения в оповещение нажать кнопку и указать путь к прикрепляемому файлу.

Для сохранения шаблона оповещения нажать кнопку "Сохранить", для отказа от изменений кнопку "Отменить". Для удаления шаблона следует нажать кнопку и подтвердить действие.

Для рассылки выбранного шаблона следует нажать кнопку   в его профиле и перейти в интерфейс "Рассылка шаблона", обладающий следующим набором данных и возможностей:

  • Реестр пользователей, которым будет рассылаться оповещение:
    • Пользователь ФИО и логин пользователя;
    • Email — Электронная почта пользователя;
    • Удалить  — Нажать , чтобы удалить пользователя из рассылки;
  • Кнопка "Добавить пользователей" — Нажать, чтобы добавить пользователей из отрывшегося списка (в открывшемся интерфейсе установить галочки насчет искомых пользователей и нажать кнопку "Сохранить");
  • Реестр групп, пользователям из которых будет рассылаться оповещение:
    • Группа — Название группы;
    • Удалить  — Нажать , чтобы удалить группу из рассылки;
  • Кнопка "Добавить группы" — Нажать, чтобы добавить группы из отрывшегося списка  (в открывшемся интерфейсе установить галочки насчет искомых групп и нажать кнопку "Сохранить");
  • Кнопка "Разослать" — Нажать, чтобы отправить сообщение адресатам.

Редактирование HTML-шаблонов приветственных сообщений позволяет решать следующие задачи:

  • передавать настраиваемые приветственные сообщения с логином или доменом/логином пользователей, добавленных через административную консоль FAM Server;
  • передавать настраиваемые приветственные сообщения с логином пользователей, зарегистрировавшихся самостоятельно.

Для передачи логина (или домена/логина) УЗ в приветственном E-mail самостоятельно зарегистрировавшемуся пользователю следует:

  1. Перейти в шаблон расположенный changepasswordlink.html по пути public\templates\default и доступный для редактирования на языке разметки HTML5.
  2. Добавить в шаблон блок кода в соответствии с шаблоном ниже (допускается использование иного приветственного сообщения, вставка ссылок. настройка приветствия по логину или по домену/логину): в примере при наличии у пользователя домена передается приветствие с доменом/логином, при отсутствии - только с логином.
<!--
<p> 
Hello 
    [{ if .Domain }]
        [{ .Domain }]\[{ .Username }]
    [{ else }]
        [{ .Username }]
    [{end}]
</p>
-->

<a href="[{$path}][{.PasswordChangeLink}]">[{.PasswordChangeLinkMessage}]</a>
<hr>
[{.PasswordChangeLinkMessageIgnore}]

Для передачи логина УЗ в приветственном E-mail самостоятельно зарегистрировавшемуся пользователю следует:

  1. Перейти в шаблон selfregistration-emailmessage.html, расположенный по пути /public/templates/default и доступный для редактирования на языке разметки HTML5.
  2. Отредактировать шаблон в соответствии с шаблоном ниже (допускается использование иного приветственного сообщения, вставка ссылок).
[{ $path := path }]
<!-- <p>Welcome, your login: <b> [{.Login}]</b></p> -->
<a href="[{$path}][{.Link}]">[{.ConfirmationLink}]</a>

Настройка шаблонов восстановления пароля

Avanpost FAM предоставляет администратору возможность настройки сообщений, направляемых пользователям при восстановлении пароля. Для настройки сообщений следует перейти из режима "Сервис" в раздел "Настройки отправки уведомлений и OTP-кодов", подраздел "Шаблон письма восстановления пароля". Для корректировки имеющихся настроек следует нажать кнопку .

Подраздел содержит следующие параметры, используемые для настройки шаблона: 

ПараметрОписаниеПеременная в шаблоне
Тема письмаТекстовое поле, содержащее заголовок письма.

Нет

ПриветствиеТекстовое поле, содержащее вводную информацию о назначении письма.{{.Greeting}}
Текст письма о восстановлении пароля

Текстовое поле, содержащее основное сообщение и код восстановления.

Для ввода кода восстановления следует использовать плейсхолдер [{ .Code }])

{{.RestorePasswordMailBody}} – основное сообщение;

{{.Code}} – код восстановления, генерируемый на стороне FAM

Текст ссылки для смены пароляПоле, содержащее текст гиперссылки (например, «Ссылка для смены пароля»).{{.PasswordChangeLinkMessage}}
Сообщение об игнорированииТекстовое поле, содержащее информацию на случай, если пользователь не инициировал сброс.{{.PasswordChangeLinkMessageIgnore}}
HTML-шаблон

HTML-шаблон, позволяющий выстроить структуру сообщения, направляемого пользователю. Администратор может переработать шаблон (например, изменив последовательность плейсхолдеров). Пример используемого шаблона:

[{ $path := path }]
[{.Greeting}]

[{.RestorePasswordMailBody}] [{ .Code }]
<a href="[{$path}][{.PasswordRestoreLink}]">[{.PasswordChangeLinkMessage}]</a>
<hr>
[{.PasswordChangeLinkMessageIgnore}]

После внесения изменения следует нажать кнопку "Сохранить", для отказа от изменений кнопку "Отмена".


Обсуждение