> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/guide/uvedomleniya/uvedomlenie-po-e-mail/podklyuchenie-gmail.md). # Подключение Gmail Gmail можно подключить к iEXExchanger через SMTP и использовать для отправки системных писем клиентам и администраторам. Поддерживаются три варианта: * обычный адрес Gmail вида `example@gmail.com`; * корпоративная почта Google Workspace вида `support@example.com`; * Google Workspace SMTP Relay для серверной отправки с разрешённого IP-адреса. iEXExchanger использует Gmail только для отправки писем. Входящие сообщения из почтового ящика система не загружает и не обрабатывает. {% hint style="info" %} Общие переключатели E-mail, адрес службы поддержки, получатели административных писем, события и их приоритеты настраиваются отдельно на странице «Уведомление по E-mail». В этой инструкции рассматриваются только подготовка Google-аккаунта и подключение Gmail к iEXExchanger. {% endhint %} {% content-ref url="/pages/OkKDfMApGsB2m3bvCsHg" %} [Уведомление по E-mail](/guide/uvedomleniya/uvedomlenie-po-e-mail.md) {% endcontent-ref %} ## Какой вариант выбрать | Вариант | Когда использовать | Подключение | | ------------------------------- | ---------------------------------------------------- | --------------------------------------- | | **Обычный Gmail** | Тестирование и небольшое количество писем | `smtp.gmail.com` + пароль приложения | | **Google Workspace** | Рабочая почта обменного пункта на собственном домене | `smtp.gmail.com` + пароль приложения | | **Google Workspace SMTP Relay** | Серверная отправка организации с постоянного IP | `smtp-relay.gmail.com` + разрешённый IP | Для рабочего обменного пункта предпочтительнее использовать Google Workspace и отдельный служебный адрес. Например: ``` support@example.com notifications@example.com noreply@example.com ``` Не используйте личную почту владельца или сотрудника, если можно создать отдельный аккаунт специально для iEXExchanger. ## Обычный Gmail Обычный Gmail можно использовать для первоначальной настройки или небольшого проекта. Если отдельного аккаунта ещё нет: 1. Создайте новый Google-аккаунт с Gmail. 2. Используйте отдельный адрес для системных писем. 3. Добавьте способы восстановления доступа. 4. Войдите в Gmail. 5. Проверьте возможность обычной отправки через веб-интерфейс. Пример: ``` project.notifications@gmail.com ``` Для постоянной рабочей отправки с брендом обменного пункта удобнее использовать Google Workspace на собственном домене. ## Google Workspace Google Workspace позволяет использовать почту на основном домене проекта. Например: ``` support@example.com ``` или: ``` notifications@example.com ``` {% stepper %} {% step %} ### Подтверждение домена Добавьте домен в Google Workspace и подтвердите владение через Google Admin Console. {% content-ref url="/pages/p1Gm5iDWlX7fh95MUVut" %} [Файлы подтверждений](/guide/sait/faily-podtverzhdenii.md) {% endcontent-ref %} {% content-ref url="/spaces/uyjsNtEAtO6Sby8CHWyD/pages/43DGhWN1Ki1aj8RrllVR" %} [Настройка DNS](/help-center/administrirovanie/seti-i-bezopasnost/cloudflare/nastroika-dns.md) {% endcontent-ref %} Google предоставит DNS-запись, которую необходимо добавить в DNS-зону домена. Используйте значение, которое отображается именно в вашей Google Admin Console. Не копируйте TXT-запись подтверждения из чужих примеров. {% endstep %} {% step %} ### Настройка входящей почты Если корпоративный ящик должен также принимать входящие письма, настройте MX-записи домена в соответствии с требованиями Google Workspace. Для новых подключений Google может использовать: ``` Тип: MX Хост: @ Приоритет: 1 Значение: smtp.google.com ``` Если существующий домен Google Workspace уже использует старые MX-записи Google, начинающиеся с `aspmx`, менять рабочую конфигурацию только ради перехода на новый формат не требуется. После настройки DNS активируйте Gmail для домена в Google Admin Console. Изменения DNS могут применяться не сразу. {% endstep %} {% step %} ### Создание отдельного пользователя В Google Admin Console откройте раздел управления пользователями и создайте отдельный аккаунт для iEXExchanger. Например: ``` notifications@example.com ``` или: ``` support@example.com ``` После создания войдите в Gmail под этим пользователем и завершите первоначальную настройку аккаунта. Пароль приложения необходимо создавать именно для этого пользователя. {% endstep %} {% endstepper %} ## SPF, DKIM и DMARC Для Google Workspace на собственном домене рекомендуется настроить SPF, DKIM и DMARC. Они влияют на проверку подлинности отправителя и доставляемость писем. {% stepper %} {% step %} ### SPF Если домен отправляет почту только через Google Workspace, используется правило Google: ``` v=spf1 include:_spf.google.com ~all ``` {% hint style="warning" %} Не создавайте несколько SPF-записей для одного домена. Если SPF уже существует для другого сервиса, добавьте Google в существующее правило {% endhint %} {% endstep %} {% step %} ### DKIM В Google Admin Console откройте настройки Gmail и раздел аутентификации электронной почты. Для выбранного домена: 1. Создайте DKIM-ключ. 2. Скопируйте полученную DNS-запись. 3. Добавьте её в DNS домена. 4. Вернитесь в Google Admin Console. 5. Запустите DKIM-аутентификацию. Используйте имя и значение, созданные именно для вашего домена. Если DNS-провайдер поддерживает ключи длиной 2048 бит, используйте этот вариант. {% endstep %} {% step %} ### DMARC DMARC рекомендуется настраивать после того, как SPF и DKIM уже работают. Сначала можно использовать политику наблюдения и проверить, какие сервисы отправляют письма от имени домена. Не включайте строгую политику отклонения до проверки всех источников отправки, используемых проектом. {% endstep %} {% endstepper %} *** ## Двухэтапная аутентификация Для подключения через `smtp.gmail.com` необходимо подготовить пароль приложения Google. Для этого в подключаемом аккаунте должна быть доступна двухэтапная аутентификация. Откройте настройки безопасности Google. В разделе способов входа: 1. Откройте **«Двухэтапная аутентификация»**. 2. Включите её. 3. Настройте основной способ подтверждения. 4. Добавьте резервный способ восстановления доступа. Если используется управляемый аккаунт Google Workspace и настройка недоступна, обратитесь к администратору организации. ## Создание пароля приложения Пароль приложения используется вместо основного пароля Google-аккаунта при SMTP-авторизации. {% hint style="warning" %} Не указывайте основной пароль Google-аккаунта в iEXExchanger. Устаревший режим «Доступ небезопасных приложений» использовать не нужно. {% endhint %} Войдите под тем аккаунтом, который будет использоваться для отправки. Откройте раздел **«Пароли приложений»**. Затем: 1. Подтвердите вход, если Google запросит его. 2. Укажите название: ``` iEXExchanger SMTP ``` 3. Создайте пароль. 4. Скопируйте полученное значение. Пароль приложения показывается только при создании. В iEXExchanger вставьте его без дополнительных пробелов. {% stepper %} {% step %} ### Если «Пароли приложений» недоступны Раздел может отсутствовать, если: * двухэтапная аутентификация не включена; * аккаунт использует ограничения, несовместимые с паролями приложений; * включена программа усиленной защиты Google; * используется управляемый рабочий или учебный аккаунт; * администратор Google Workspace запретил пароли приложений. Если для Google Workspace пароли приложений использовать нельзя, рассмотрите SMTP Relay. {% endstep %} {% step %} ### После изменения основного пароля Google может отозвать существующие пароли приложений после изменения основного пароля аккаунта. Если SMTP перестал работать после смены пароля: 1. Создайте новый пароль приложения. 2. Откройте Gmail-подключение в iEXExchanger. 3. Введите новый пароль. 4. Выполните тестовую отправку. {% endstep %} {% endstepper %} ## Создание подключения в iEXExchanger В панели управления откройте: **«Настройки» — «Общие настройки» — «Уведомления» — «Подключения»**
Затем: 1. Нажмите **«Добавить»**. 2. В поле **«Тип подключения»** выберите **«SMTP»**. 3. В поле **«Название»** укажите **«Gmail»** или **«Google Workspace»**. 4. Нажмите **«Создать»**. 5. Найдите созданное подключение. 6. Нажмите на его название. Новое подключение создаётся как черновик и не используется для рабочих писем до завершения настройки. ## SMTP-настройки Gmail Для обычного Gmail и Google Workspace через `smtp.gmail.com` используйте:
ПолеЗначение
«SMTP-сервер»smtp.gmail.com
«Порт»465
«Шифрование»SSL
«Логин»Полный E-mail Google-аккаунта
«Пароль»Пароль приложения
«E-mail отправителя»Тот же адрес, что используется для входа
«Имя отправителя»Название обменного пункта или службы поддержки
После заполнения параметров подключение можно проверить до включения в рабочую отправку. ### Логин Всегда указывайте полный адрес почтового аккаунта. Для обычного Gmail: ``` project.notifications@gmail.com ``` Для Google Workspace: ``` support@example.com ``` Не указывайте только часть адреса до `@`. ### Пароль В поле **«Пароль»** укажите созданный пароль приложения Google. Не используйте: * основной пароль аккаунта; * пароль другого Google-пользователя; * старый пароль приложения после его отзыва. ### E-mail отправителя Для первой настройки используйте тот же адрес, что и в поле **«Логин»**. Для обычного Gmail: ``` Логин: project.notifications@gmail.com E-mail отправителя: project.notifications@gmail.com ``` Для Google Workspace: ``` Логин: support@example.com E-mail отправителя: support@example.com ``` Такой вариант проще проверить и он исключает проблемы с неподтверждённым адресом отправителя. ### Имя отправителя В поле **«Имя отправителя»** укажите название, которое должен видеть получатель. Например: ``` Example Exchange ``` или: ``` Служба поддержки Example Exchange ``` Имя отправителя не заменяет E-mail и не используется для SMTP-авторизации. ### Порт и шифрование Основной вариант: ``` Порт: 465 Шифрование: SSL ``` Если сервер не может установить соединение через `465`, используйте альтернативную связку: ``` Порт: 587 Шифрование: TLS ``` Не смешивайте порт и тип шифрования: ``` 465 — SSL 587 — TLS ``` Не используйте **«Без шифрования»** для рабочего Gmail-подключения. ## Отправка с другого адреса Для первоначальной настройки используйте одинаковые значения **«Логин»** и **«E-mail отправителя»**. Если требуется войти как: ``` main@example.com ``` но отправлять письма как: ``` support@example.com ``` сначала настройте этот адрес в Gmail. Откройте: **«Настройки» — «Все настройки» — «Аккаунты и импорт» — «Отправлять письма как»** Добавьте и подтвердите необходимый адрес. Только после этого используйте его в **«E-mail отправителя»**. Пароль приложения при этом создаётся для основного аккаунта, который указан в **«Логин»**. ## Проверка подключения До завершения теста можно оставить **«Подключение включено»** выключенным. В форме подключения найдите: **«E-Mail для проверки»** Затем: 1. Укажите адрес, к которому у вас есть доступ. 2. Нажмите **«Отправить тест»**. 3. Дождитесь результата. 4. Проверьте папку «Входящие». 5. Проверьте «Спам». 6. Для обычного Gmail дополнительно проверьте вкладку «Промоакции», если она используется. 7. Проверьте адрес отправителя. 8. Проверьте имя отправителя. Кнопка **«Отправить тест»** сначала сохраняет текущие настройки, а затем выполняет реальную отправку. После успешной проверки: 1. Включите **«Подключение включено»**. 2. Нажмите **«Сохранить»**. ## Проверка из списка подключений После сохранения вернитесь на страницу: **«Уведомления» — «Подключения»** Найдите Gmail-подключение. Откройте **«Другие действия»** и выберите: **«Проверить»**
Если параметры работают, состояние подключения должно обновиться без ошибки. После изменения SMTP-сервера, порта, пароля или адреса отправителя выполняйте новую проверку. *** ## Google Workspace SMTP Relay SMTP Relay предназначен для организаций Google Workspace и подходит для серверной отправки, особенно если сервер iEXExchanger использует постоянный внешний IP-адрес. Для этого варианта не используется `smtp.gmail.com`. Используется: ``` smtp-relay.gmail.com ``` ## Что требуется для SMTP Relay Понадобятся: * Google Workspace; * административный доступ к организации; * почтовый адрес на собственном домене; * постоянный внешний IP сервера iEXExchanger; * возможность исходящего подключения к порту `587`. Нужен именно внешний IP, с которого сервер устанавливает соединение с Google. Не используйте: * IP Cloudflare; * IP компьютера администратора; * IP браузера пользователя. ## Настройка SMTP Relay в Google Workspace Откройте Google Admin Console. Перейдите: **«Приложения» — «Google Workspace» — «Gmail» — «Маршрутизация»** Найдите: **«Служба ретрансляции SMTP»** Затем: 1. Создайте новую настройку. 2. Укажите название, например `iEXExchanger`. 3. В разрешённых отправителях выберите подходящий вариант для пользователей вашего домена. 4. В качестве способа аутентификации разрешите почту только с указанных IP-адресов. 5. Добавьте внешний IP сервера iEXExchanger. 6. Включите обязательное TLS. 7. Сохраните изменения. Настройки Google Workspace могут применяться не мгновенно. ## SMTP Relay в iEXExchanger Создайте отдельное подключение **«SMTP»**. Используйте: | Поле | Значение | | ------------------------ | ------------------------- | | **«Название»** | `Google Workspace Relay` | | **«SMTP-сервер»** | `smtp-relay.gmail.com` | | **«Порт»** | `587` | | **«Шифрование»** | `TLS` | | **«Логин»** | Оставьте пустым | | **«Пароль»** | Оставьте пустым | | **«E-mail отправителя»** | Разрешённый адрес домена | | **«Имя отправителя»** | Название обменного пункта | Такой вариант работает по разрешённому IP сервера. Не заполняйте логин и пароль, если в Google Workspace используется только IP-аутентификация. {% hint style="warning" %} Не используйте `aspmx.l.google.com` вместо SMTP Relay для обычных системных уведомлений iEXExchanger. Этот сервер имеет другой сценарий использования и не является заменой `smtp-relay.gmail.com` для полноценной внешней отправки. {% endhint %} ## Проверка SMTP Relay В поле **«E-Mail для проверки»** укажите доступный E-mail. Выполните: **«Отправить тест»** Если Google отклоняет relay-подключение, проверьте: * внешний IP сервера; * настройки разрешённых отправителей; * TLS; * адрес отправителя; * применились ли изменения Google Workspace. После успешного теста включите **«Подключение включено»** и сохраните подключение. ## Ограничения Gmail Gmail имеет ограничения на количество отправляемых сообщений. Обычный Gmail предназначен прежде всего для обычной пользовательской почты, а не для большого объёма автоматических транзакционных уведомлений. При превышении лимитов Google может временно ограничить исходящую отправку. Для обычного Gmail ограничение может срабатывать при большом количестве отправленных писем за сутки. Google Workspace и SMTP Relay имеют собственные ограничения, которые зависят от способа отправки и типа аккаунта. Если обменный пункт регулярно отправляет большой объём транзакционных писем, используйте специализированный почтовый сервис, рассчитанный на такую нагрузку. ## Завершение настройки E-mail Рабочее Gmail-подключение ещё не означает, что все системные письма включены. После успешного теста откройте общую инструкцию **«Уведомление по E-mail»** и настройте: {% content-ref url="/pages/OkKDfMApGsB2m3bvCsHg" %} [Уведомление по E-mail](/guide/uvedomleniya/uvedomlenie-po-e-mail.md) {% endcontent-ref %} * **«Отправка уведомлений»**; * **«Уведомления по E-mail»**; * **«E-Mail адрес службы поддержки»**; * **«E-Mail адреса администраторов»**; * клиентские события; * административные события; * приоритеты уведомлений. ## Google сообщает о неправильном пароле Проверьте: * в **«Логин»** указан полный E-mail; * используется пароль приложения; * пароль приложения создан для этого же Google-аккаунта; * двухэтапная аутентификация не была отключена; * основной пароль аккаунта не менялся после создания пароля приложения; * пароль приложения не был отозван. Если есть сомнения, создайте новый пароль приложения и повторите тест. ## Раздел «Пароли приложений» отсутствует Проверьте: * включена ли двухэтапная аутентификация; * не запрещены ли пароли приложений политикой организации; * не используется ли управляемый рабочий или учебный аккаунт; * не включён ли режим усиленной защиты, несовместимый с таким способом. Для Google Workspace при невозможности использовать пароли приложений рассмотрите SMTP Relay. ## Ошибка подключения или timeout Проверьте основную конфигурацию: ``` SMTP-сервер: smtp.gmail.com Порт: 465 Шифрование: SSL ``` Если соединение не устанавливается, проверьте: ``` SMTP-сервер: smtp.gmail.com Порт: 587 Шифрование: TLS ``` Также проверьте, разрешает ли сервер обменного пункта исходящие SMTP-соединения. Некоторые хостинг-провайдеры ограничивают исходящий SMTP-трафик. Если оба варианта недоступны, обратитесь к системному администратору или хостинг-провайдеру. ## Отправитель заменяется другим адресом Для первой настройки используйте один и тот же адрес: ``` Логин: support@example.com E-mail отправителя: support@example.com ``` Если необходимо использовать другой адрес, сначала добавьте и подтвердите его в Gmail через **«Отправлять письма как»**. Без этого Google может изменить адрес отправителя или отклонить отправку. ## Тест проходит, но рабочие письма не отправляются Если **«Отправить тест»** завершается успешно, SMTP-подключение работает. Дополнительно проверьте в iEXExchanger: * включено ли **«Подключение включено»**; * включена ли **«Отправка уведомлений»**; * включены ли **«Уведомления по E-mail»**; * включено ли нужное событие; * сохранены ли настройки событий; * существует ли корректный E-mail получателя. Повторно изменять SMTP-параметры без причины в такой ситуации не требуется. ## Письма попадают в спам Для Google Workspace проверьте: * SPF; * DKIM; * DMARC; * адрес отправителя; * состояние домена; * частоту отправки. Успешный SMTP-тест подтверждает, что Google принял письмо для отправки, но не гарантирует его попадание в папку **«Входящие»**. ## SMTP Relay возвращает ошибку Проверьте: * правильный ли внешний IP добавлен в Google Workspace; * не изменился ли IP сервера; * разрешён ли используемый отправитель; * включено ли TLS; * используется ли `smtp-relay.gmail.com`; * прошло ли достаточно времени после изменения конфигурации Google Workspace. ## Изменение сохранённого пароля iEXExchanger не показывает полный ранее сохранённый пароль приложения. При повторном открытии подключения: * пустое поле **«Пароль»** сохраняет существующее значение; * новое значение заменяет ранее сохранённый пароль. Если вы изменяете только имя отправителя или другой параметр, повторно вводить пароль не требуется. Если пароль приложения был отозван: 1. Создайте новый пароль Google. 2. Откройте SMTP-подключение. 3. Введите новое значение. 4. Нажмите **«Отправить тест»**. 5. Убедитесь, что письмо получено. ## Письма отправляются с задержкой Если тестовые письма отправляются нормально, но рабочие события задерживаются, причина может находиться в фоновой обработке iEXExchanger. Попросите технического администратора проверить: * Laravel Horizon; * очереди уведомлений; * Redis; * планировщик Laravel; * журналы ошибок уведомлений. Для такой проверки не требуется передавать пароль приложения Google. ## Рекомендации по безопасности Для production используйте отдельный Google-аккаунт или пользователя Google Workspace. Не подключайте личный аккаунт владельца проекта, если можно создать отдельный служебный ящик. Рекомендуется: * включить двухэтапную аутентификацию; * настроить способы восстановления доступа; * создать отдельный пароль приложения для iEXExchanger; * не публиковать пароль приложения; * не передавать его в переписке; * не добавлять пароль на скриншоты; * не хранить пароль в документации; * отозвать пароль сразу после подозрения на компрометацию; * после смены основного пароля проверить SMTP; * для SMTP Relay разрешать только фактический IP сервера. Если пароль приложения стал известен третьим лицам: 1. Отзовите его в Google-аккаунте. 2. Создайте новый. 3. Обновите пароль в iEXExchanger. 4. Выполните тестовую отправку. ## Проверка настройки Для обычного Gmail или Google Workspace через `smtp.gmail.com` подключение настроено правильно, если: * создан отдельный почтовый аккаунт; * для Workspace подтверждён домен; * почтовый ящик работает; * для Workspace настроены необходимые DNS-записи; * включена двухэтапная аутентификация; * создан отдельный пароль приложения; * используется `smtp.gmail.com`; * используется `465 + SSL` или `587 + TLS`; * в **«Логин»** указан полный E-mail; * **«E-mail отправителя»** разрешён Google; * указано **«Имя отправителя»**; * тестовое письмо успешно отправлено; * тестовое письмо получено; * включено **«Подключение включено»**; * подключение сохранено; * в общей системе E-mail включены необходимые события и глобальные параметры. Для SMTP Relay дополнительно убедитесь, что: * используется Google Workspace; * известен постоянный внешний IP сервера; * IP добавлен в **«Служба ретрансляции SMTP»**; * используется `smtp-relay.gmail.com`; * используется порт `587`; * выбрано **«TLS»**; * адрес отправителя разрешён правилом Google Workspace; * тестовая отправка через Relay завершилась успешно. После успешной проверки Gmail готов использоваться как почтовое подключение iEXExchanger.