> For the complete documentation index, see [llms.txt](https://kb.pvhostvm.ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-admin-guide/mfa/email.md).

# Email

МФА Email - метод двухфакторной аутентификации с отправкой верификационного кода по электронной почте.

Для создания МФА Email перейдите в раздел "Аутентификация" > "МФА", нажмите "Новый" и выберите тип "Email МФА".

## Основные настройки <a href="#main" id="main"></a>

<figure><img src="https://raw.githubusercontent.com/hostco-ru/hostvm/master/.gitbook/assets/MFA2.png" alt=""><figcaption></figcaption></figure>

**Имя** - наименование создаваемого МФА для отображения в системе.

**Кэширование устройства** - время кэширования устройства (в часах), в течение которого МФА повторно не требуется. Привязывается к пользователю.

**Срок действия кода МФА** - время в минутах, в течение которого можно использовать код МФА.

## SMTP сервер <a href="#smtp" id="smtp"></a>

<figure><img src="https://raw.githubusercontent.com/hostco-ru/hostvm/master/.gitbook/assets/MFA3.png" alt=""><figcaption></figcaption></figure>

**SMTP сервер** - IP-адрес или FQDN сервера SMTP. Если используется нестандартный порт, укажите его после двоеточия, например, `smtp.example.ru:587` .

**Безопасность** - используемый протокол шифрования:

* TLS
* SSL
* None

**Имя пользователя** - имя пользователя с доступом к серверу SMTP.

**Пароль** - пароль пользователя.

## Конфигурация <a href="#config" id="config"></a>

<figure><img src="https://raw.githubusercontent.com/hostco-ru/hostvm/master/.gitbook/assets/MFA4.png" alt=""><figcaption></figcaption></figure>

**Тема** - тема письма.

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

**Включить HTML** - если включено, будет использоваться HTML разметка писем.

**Политика для пользователей без МФА**:

* Allow user login — разрешить доступ пользователю;
* Deny user login — отказать в доступе пользователю;
* Allow user to login if their IP is in the network list — разрешить доступ пользователей, если их IP есть в списке сетей;
* Deny user to login if their IP is in the network list — запретить доступ пользователей, если их IP есть в списке сетей.

**Сети Email OTP** - список сетей для аутентификации через Email OTP.

**Текст письма** - текст письма с кодом верификации. Если пусто, будет использован текст по-умолчанию. Для использования в тексте доступны следующие переменные:

* {code}
* {username}
* {justUsername}
* {ip}

**HTML письма** - HTML письма с кодом верификации. Если пусто, будет использован HTML по-умолчанию. Для использования в HTML доступны следующие переменные:

* {code}
* {username}
* {justUsername}
* {ip}

После внесения необходимых настроек нажмите **"Сохранить"**.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-admin-guide/mfa/email.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.