---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.ru/dev/api360/doc/ru/ref/DomainPolicies/index.md
  - href: ru/ref/DomainPolicies/index.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/api360/doc/ru/llms.txt

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

<!-- markdownlint-disable-file -->

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

Права доступа, необходимые приложению для работы с правилами:
- `ya360_admin:mail_write_routing_rules` — просмотр и изменение;
- `ya360_admin:mail_read_routing_rules` — просмотр.

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

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

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

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

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

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

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

<!-- source: ru/_includes/mail-checks.md -->
{% cut "Схема обработки входящих писем" %}

```mermaid
graph TB
    P(["Входящее письмо"]):::orange
    A1["`Спамооборона,
которая учитывает в т.ч.
**список антиспама**
`"]:::blue
    A2["`Правила доменной политики,
    по которым формируется **список
    разрешенных и запрещенных отправителей**`"]:::blue
    A3["`**Правила обработки писем**`"]:::blue
    X((<font color = #ff4242 size=5> Х </font>))
    MB(["Ящик получателя"]):::orange
    AMB(["Другой ящик"]):::orange

    P --> A1
    A1 --> |malicious| X
    A1 -->  |ham, spam| A2
    A2 -->  |reject| X
    A2 -->  |"accept (в т.ч. accept+spam, accept+ham)"| A3
    A3 ==> MB
    A3 -->  |drop| X
    A3 -->  |forward| AMB

    click A1 "https://yandex.ru/dev/api360/doc/ru/ref/MailAntispamIpAllowlistService/"
    click A2 "https://yandex.ru/dev/api360/doc/ru/ref/DomainPolicies/"
    click A3 "https://yandex.ru/dev/api360/doc/ru/ref/RoutingService/"

    classDef orange fill:#ffeee7,stroke:#ffeee7,stroke-width:2px;
    classDef blue fill:#deebff,stroke:#deebff,stroke-width:2px,rx:5,ry:5;
    style X fill:#ffeee7,stroke:#ff4242,stroke-width:2px;
```

{% endcut %}
<!-- endsource: ru/_includes/mail-checks.md -->



## Endpoints

- [Просмотреть список правил](https://yandex.ru/dev/api360/doc/ru/ref/DomainPolicies/DomainPolicies_Get.md)
- [Задать список правил](https://yandex.ru/dev/api360/doc/ru/ref/DomainPolicies/DomainPolicies_Set.md)