Настройка Gmail (oAuth2)

Настройка почты для сервиса gmail

Для настройки OAuth 2.0 в Google требуется использовать URL-адрес станции. Самый простой способ — создать DNS-запись на локальном сервере или добавить соответствие IP-адреса и доменного имени в файл hosts на устройстве, с которого выполняется настройка.

Настройки аккаунта Google

1. Перед началом настройки, необходимо поменять некоторые параметры аккаунта Google. Для этого перейдите на страницу управления (ссылка).

Страница упрвления аккаунтом Google

1. Перейдите в раздел "Безопасность и вход в аккаунт". Убедитесь, что у Вас настроена двухэтапная аутентификация.

Настройка двухэтапной аутентификации

1. Перейдите в консоль Google Cloud, в раздел "APIs & Services" (ссылка). Создайте проект под текущую задачу.

Раздел "APIs & Services" в Google Cloud

1. Перейдите в библиотеку APIs (раздел "Library").

Раздел "Library" в APIs & services

1. Введите в поиске: "gmail api". Перейдите в карточку Gmail API.

Gmail API в библиотеке Google Cloud

1. Нажмите "Enable" для подключения.

Подключение API

1. Перейдите на главную страницу APIs & Services. Далее "OAuth consent screen".

Раздел "OAuth consent screen" в APIs & Services

1. Создайте проект (нажмите "Get started"). Заполните произвольное название и Вашу почту. В качестве Audience выберите "Internal". Нажмите "Create" для завершения.

Параметр "Audience" в создании проекта

1. Вернитесь на главную страницу APIs & Services. Далее в раздел "Credentials". Нажмите "Create credentials". Выберите "OAuth client ID" для создания.

Создание нового OAuth client ID

1. В качестве Application type, выберите "Web application". Далее введите произвольное название. Нажмите "Create".

Создание нового OAuth client ID

1. Добавьте новый "Authorized redirect URI".

Формат:

https://mikopbx.station.com/pbxcore/api/v3/mail-settings/oauth2-callback

Замените "mikopbx.station.com" на URl Вашей станции.

Добавление нового URl для перевода

1. Будет создан OAuth client. Сохраните ClientID и Client secret себе в заметки. В будущем эти данные понадобятся для подключения.

Успешно созданный клиент

Настройки в MikoPBX

1. Перейдите в раздел "Система" -> "Почта и уведомления":

Раздел "Почта и уведомления" в MikoPBX

1. Далее, "Настройки SMTP". Заполните следующие параметры:

• Адрес отправителя, Имя отправителя - Ваша почта и от какого имени будут отправляться письма.

• Тип аутентификации - OAuth2.

• SMTP логин - Ваша почта.

• Провайдер OAuth2 - Google/Gmail.

• Идентификатор приложения (Client ID), Секретный ключ (Client Secret) - данные, которые сохранены из Google Cloud (12 пункт из прошлого раздела в этой инструкции).

Все остальные настройки оставьте по умолчанию. Более подробное описание Вы можете найти в главное статье о параметрах почты (ссылка).

После этого нажмите "Сохранить"!

Параметры почты для подключения Gmail

1. Нажмите на синюю кнопку "Подключить через OAuth2". Далее выберите Ваш аккаунт Gmail.

Выбор аккаунта Google

1. Подтвердите вход: нажмите "Continue".

Продолжения авторизации

1. Подтвердите выдачу необходимых разрешений. (Нажмите "Allow").

Выдача разрешений

При успешной авторизации, вы увидите следующее окно.

Успешная авторизация

Решение возможных проблем

Access blocked: Authorization Error (Error 400: invalid_request)

Ошибка 400: invalid_request

Решение: впишите URl адрес станции в Веб-интерфейсе MikoPBX: "Сеть и Firewall" -> "Сетевые интерфейсы". Перейдите в раздел "Топология сети" и впишите имя хоста в поле "Внешнее имя хоста вашего маршрутизатора". (Включите "Эта станция расположена за NAT маршрутизатором")

Решение проблемы