Подключение Email профиля Microsoft Outlook | Официальная документация Webitel

Для подключения Email профиля Microsoft Outlook создается новый Email профиль.

На странице детали “Общее” заполняются данные согласно описанию. Выбирается тип аутентификации OAuth2.

Для подключения необходимо заполнить поля Client id, Client secret и Discovery url и сделать следующие:

Включить поддержку SMTP

Зайти на https://admin.microsoft.com/Adminportal/Home#/users и перейти на страницу “Активные пользователи”. Выбрать пользователя с чьей электронной почти будут обрабатываться письма(Рис. 1).

Активные пользователи.png — *Рис. 1. Страница “***Активные пользователи**”

Нажать на отображаемое имя. Откроется учетная запись. Выбрать вкладку “Почта” (Рис. 2).

Учетная запись.png — *Рис. 2. Учетная запись*

Нажать на “Управление приложениями электронной почты” (Рис. 3).

Управление приложениями электронной почты.png — *Рис. 3. Управление приложениями электронной почты*

Проверить отмечен ли чекбокс “SMTP с проверкой подлинности”. Если нет — отметить и нажмите кнопку “Сохранить изменения” (Рис. 4).

SMTP с проверкой подлиности.png — *Рис. 4. SMTP с проверкой подлинности*

Регистрация OAuth клиента и генерирование секретного ключа

Зайти на https://entra.microsoft.com/. Выбрать “Регистрация приложений” (Рис. 5).

Центр администрирования Microsoft Entra.png — *Рис. 5. Центр администрирования Microsoft Entra*

Выбрать “Новая регистрация” (Рис. 6).

Новая регистрация.png — *Рис. 6. Новая регистрация*

Заполнить поле “Имя”. Выбрать поддерживаний типом учетной записи “Учетная запись в любом каталоге организации (любой клиент Microsoft Entra ID - мультитенантное решение)”. В “URI перенаправления” выбрать “Веб” и в поле задать следующее (Рис. 7):

https://XXXXX.XXX.XX/endpoint/oauth2/outlook/callback

XXXXX.XXX.XX - заменяется на сервер клиента.

Эту ссылку также указать в поле “Discovery url” на странице детали “Общее” на стороне Webitel.

Нажать кнопку “Зарегистрировать”.

Регистрация приложения.png — *Рис. 7. Регистрация приложения*

Создается приложение. Скопировать данные с “Идентификатор приложения (клиент)”. Скопированные данные вставить в поле “Client id“ на странице детали “Общее” на стороне Webitel.

Нажать “Добавить сертификат или секрет” (Рис. 8).

Созданое приложение.png — *Рис. 8. Созданное приложение*

Открывается страница “Сертификаты и секреты”. Нажать на “Новый секрет клиента” (Рис. 9).

Новые секрет клиента.png — *Рис. 9. Сертификаты и секреты*

В “Добавить секрет клиента” задать описание и нажать кнопку “Добавить” (Рис. 10).

Добавить секрет клиента.png — *Рис. 10. Добавить секрет клиента*

Секрет клиента добавлен. На странице “Сертификаты и секреты” скопировать значение созданного секрета клиента (Рис. 11). Вставить это значение в поле “Client secret” на странице детали “Общее” на стороне Webitel.

Повторное копирование значения секрета клиента невозможно!

Секрет клиента.png — *Рис. 11. Секрет клиента*

Раздача прав

На странице приложения (Рис. 8) Открыть “Разрешения API” нажав на соответственную надпись в блоке “Управления”. Нажать на “Добавить разрешение” (Рис. 12).

Разрешение API.png — *Рис. 12. Разрешения API*

Открывается “Запрос разрешений API”. Нажать на “Интерфейсы API, используемые моей организацией”. Выбрать “Office 365 Exchange Online” (Рис. 13).

Интерфейсы API , используемые моей организацией.png — *Рис.13. Интерфейсы API, используемые моей организацией*

Выбрать “Разрешение приложения” (Рис. 14).

Office 365 Exchange Online.png — *Рис. 14. Office 365 Exchange Online*

Прокрутить вниз, найти и открыть “IMAP”. Отметить “IMAP.AccessAsApp” (Рис. 15).

IMAP.AccessAsApp.png — *Рис. 15. IMAP.AccessAsApp*

Прокрутить вниз, найти и открыть “SMTP”. Отметить “SMTP.SendAsApp” (Рис. 16).

SMTP.SendAsApp.png — *Рис. 16. SMTP.SendAsApp*

Нажать кнопку “Добавить разрешения”.

“Запрос разрешений API” закрывается. На странице “Разрешения API” нажать на “Предоставить согласие администратора для Webitel”. Открывается модальное окно для подтверждения (Рис. 17).

Предоставить согласие адинистратора для Webitel.png — *Рис. 17. Предоставить согласие администратора для Webitel*

Нажать кнопку “Да”.