Разрешенные и запрещенные отправители

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

Права доступа, необходимые приложению для работы с правилами:

• ya360_admin:mail_write_routing_rules — просмотр и изменение;
• ya360_admin:mail_read_routing_rules — просмотр.

Термины

Правило доменной политики — инструкция, которая описывает, какое Действие нужно выполнить с письмом при выполнении Условия. Каждому правилу вы можете давать название и краткое описание того, для чего оно предназначено.

Действие — операция над письмом.

Письмо можно:

• отклонить — не доставлять в ящик получателя вне зависимости от результата проверки Спамообороной;
• принять с отметкой спама — поместить в папку «Спам» почтового ящика получателя;
• принять — доставить получателю, даже если Спамооборона Почты распознала письмо как спам.

Условие — алгоритм проверки отправителя письма на соответствие заданным параметрам. Для одного условия проверку запрещенных или разрешенных отправителей можно задавать через указание одного из списков:

• полных электронных адресов;
• доменов;
• IP-адресов и масок подсетей.

Максимальное количество элементов в одном списке — 200.

Особенности работы со списком правил

• Обновить список правил можно только целиком. Если вы хотите добавить какое-то правило, сначала выгрузите существующий список правил и обновите его, а затем загрузите весь список заново.
• Порядок правил в списке имеет значение — чем выше правило к началу списка, тем выше его приоритет. То есть для каждого входящего письма условия проверяются по порядку, начиная с первого правила. Если для отправителя проверка очередного условия успешна, к письму применяется текущее правило, а дальнейшая проверка прекращается.
• Для каждого правила в списке указывается признак активности: для того, чтобы отключить правило его не обязательно удалять из списка, достаточно просто установить признаку активности значение false.
• Правила доменной политики распространяются только на сотрудников с аккаунтами на домене организации. На остальных пользователей, например владельца организации с почтой вида login@yandex.ru или приглашенных пользователей с аккаунтами на Яндексе, правила не действуют.
• Максимальное количество правил доменной политики в списке — 200.

Endpoints

• Просмотреть список правил
• Задать список правил