Настройка Microsoft Outlook (oAuth2)

Настройка почты для сервиса Outlook (outlook.com; hotmail.com)

Настройки внутри Microsoft Entra

Регистрация приложения

1. Войдите в центр администрирования Microsoft Entra.

Главная страница центра администрирования Microsoft Entra

1. Перейдите в раздел "Entra ID" -> "App registrations". Далее нажмите "New registration" для регистрации нового приложения.

Регистрация нового приложения

1. Выберите следующие параметры для Вашего приложения:

• Name - укажите название для Вашего приложения.

• Supported account types - выберите параметр "Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant)".

Параметры приложения

1. Укажите Redirect URl:

• Select a platform - выберите "Web".

• URl:

https://192.168.100.71/pbxcore/api/v3/mail-settings/oauth2-callback

Замените 192.168.100.71 на адрес Вашей MikoPBX.

Далее нажмите "Register".

Параметры Redirect URl

1. Будет созданно приложения. Сохраните client ID, в будущем он понадобится для настройки внутри веб-интерфейса MikoPBX.

Главная страница созданного приложения

Выдача разрешений и создание Client secret

1. Из главной страницы приложения перейдите в "Manage" -> "API permissions".

Раздел "API permissions"

1. Нажмите "Add a permission".

Добавление разрешения

1. В разделе "Microsoft Graph" выберите "Delegated Permissions". В поиске введите "SMTP". Поставьте галочку напротив "SMTP.Send".

Выдача разрешения "SMTP.Send"

1. Так же в поиске введите "offline". Поставьте галочку напротив "offline_access".

Нажмите "Add permissions".

Выдача разрешения "offline_access"

1. Далее перейдите в раздел "Certificates & secrets" -> "Client secrets". Нажмите "New client secret".

Создание нового Secret ID

1. Задайте необходимые параметры:

• Description - произвольное описание.

• Expires - срок на который Вы выпускаете этот client secret. Он понадобится нам для аутентификации приложения в MikoPBX.

После истечения срока, созданный client secret перестанет функционировать и необходимо будет повторить процесс создания нового ключа и подключения к MikoPBX.

После создания, значение Client Secret будет показано всего один раз. Не забудьте скопировать его в Web-интерфейс MikoPBX.

Нажмите "Add".

Параметры для создания нового client secret

1. Скопируйте "Value" (не SecretID!). Он понадобится для настройки в веб-интерфейсе MikoPBX.

Копирование Value созданного ранее Client secret

Выдача разрешений пользователю

Для корректной работы приложения, Вам необходимо выдать разрешение на использования SMTP протокола для пользователя, чью почту Вы авторизовываете в ходе текущей насройки. Для этого выполните следующие шаги:

1. Перейдите в центр администрирования организации (ссылка).

Главная страница Microsoft Admin Center

1. Перейдите в раздел "Users" -> "Active Users". Нажмите на имя пользователя, под учетной записью которого произодится создание приложения.

Раздел "Active Users" в Microsoft Admin Center

1. В учетной записи, перейдите в раздел "Mail" и выберите "Manage email apps".

Раздел "Mail" в учетной записи пользователя

1. Убедитесь, что "Authenticated SMTP" разрешен. Сохраните изменения, нажав "Save changes".

Разрешение Authenticated SMTP для выбранного пользователя

Настройки внутри MikoPBX

1. Перейдите в Web-интерфейс MikoPBX. Далее "Система" -> "Почта и уведомления" -> "Настройки SMTP".

Заполните все необходимые данные:

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

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

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

• Провайдер OAuth2 - Microsoft/Outlook.

• Идентификатор приложения (Client ID), Секретный ключ (Client Secret) - данные из Microsoft Entra.

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

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

Настройки SMTP в Web-интерфейсе MikoPBX

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

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

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

Успешная OAuth2 авторизация (Microsoft/Outlook)