Підключення Microsoft Outlook 365 до Odoo за допомогою Azure OAuth

Odoo сумісний із Microsoft Azure OAuth для Microsoft 365. Щоб надсилати та отримувати безпечні ел. листи з власного домену, усе, що потрібно, це налаштувати кілька параметрів на платформі Azure та на задній частині бази даних Odoo. Ця конфігурація працює з особистою адресою електронної пошти або адресою, створеною спеціальним доменом.

Дивись також

Microsoft Learn: зареєструйте додаток на платформі ідентифікації Microsoft

Дивись також

• Автентифікація входу в Microsoft Azure

• Синхронізація календаря Outlook

Налаштування на порталі Microsoft Azure

Створити новий додаток

Щоб розпочати, перейдіть на портал Microsoft Azure. Увійдіть за допомогою облікового запису Microsoft Outlook Office 365, якщо він є, інакше увійдіть за допомогою особистого обліковий запис Microsoft. Користувачеві з адміністративним доступом до налаштувань Azure потрібно підключитися та виконати наведену нижче конфігурацію. Далі перейдіть до розділу з позначкою Manage Microsoft Entra ID (формально Azure Active Directory).

Тепер натисніть Додати (+), розташоване у верхньому меню, а потім виберіть Реєстрація додатку. На екрані Реєстрація додатку перейменуйте Назва на Odoo або інше, що можна впізнати. У розділі Підтримувані типи облікових записів виберіть Облікові записи в будь-якому організаційному каталозі (будь-який каталог Microsoft Entra ID - Multitenant) і особисті облікові записи Microsoft (наприклад, Skype, Xbox).

У розділі URL-адреса перенаправлення виберіть Web як платформу, а потім введіть https://<web base url>/microsoft_outlook/confirm у полі URL. web.base.url може змінюватися залежно від URL-адреси, яка використовується для входу в базу даних.

Примітка

У документації про web.base.url пояснюється, як заморозити унікальну URL-адресу. У додатку Microsoft також можна додати різні URL-адреси перенаправлення.

Після додавання URL-адреси до поля Зареєструвати додаток, щоб вона була створена.

Дозволи API

Далі потрібно встановити Дозволи API. Odoo потребуватиме спеціальних дозволів API, щоб мати можливість читати (IMAP) і надсилати (SMTP) ел. листи в налаштуваннях Microsoft 365. Спочатку клацніть посилання Дозволи API, розташоване на панелі меню ліворуч. Потім натисніть кнопку (+) Add a Permission і виберіть Microsoft Graph у Commonly Used Microsoft APIs. Після цього виберіть параметр Делеговані дозволи.

У рядку пошуку знайдіть наступні Делеговані дозволи та натисніть Додати дозволи для кожного:

• SMTP.Send

• IMAP.AccessAsUser.All

Примітка

Дозвіл User.Read буде додано за умовчанням.

Призначити користувачів і групи

Після додавання дозволів API поверніться до Огляд Програми у верхній частині меню лівої бічної панелі.

Тепер додайте користувачів до цього додатку. Під оглядовою таблицею Essentials клацніть посилання Керований додаток в локальному каталозі або останню опцію в нижній правій частині таблиці.

У меню лівої бічної панелі виберіть Користувачі та групи. Потім натисніть (+) Додати користувача/групу. Залежно від облікового запису можна додати або Група та Користувач, або лише Користувач. Особисті облікові записи дозволять додавати лише Користувач.

У розділі Користувачі або Групи натисніть Не вибрано та додайте користувачів або групу користувачів, які надсилатимуть ел. листи з Обліковий запис Microsoft в Odoo. Додайте користувачів/групи, натисніть Вибрати, а потім Призначити їх додатку.

Create credentials

Тепер, коли додаток Microsoft Azure налаштовано, потрібно створити облікові дані для налаштування Odoo. До них належать ID клієнта і Секрет клієнта. Для початку ID клієнта можна скопіювати зі сторінки Огляд програми. Ідентифікатор клієнта або ID додатку знаходиться під Відображуваною назвою в огляді Essentials додатку.

Далі потрібно отримати Секретне значення клієнта. Щоб отримати це значення, клацніть Сертифікати та секрети в меню лівої бічної панелі. Потім потрібно створити Секрет клієнта. Щоб зробити це, натисніть кнопку (+) Секрет нового клієнта.

Вікно праворуч заповниться кнопкою з позначкою Додати секрет клієнта. У розділі Опис введіть Odoo Fetchmail або щось впізнаване, а потім встановіть термін дії.

Важливо

Новий Секрет клієнта потрібно буде створити та налаштувати, якщо термін дії першого закінчиться. У цьому випадку служба може бути перервана, тому слід зазначити дату закінчення терміну придатності та встановити якомога далі.

Потім натисніть Додати, коли ці два значення буде введено. Буде створено Секретне значення клієнта і ID секрета. Важливо скопіювати Значення або Секретне значення клієнта в блокнот, оскільки після виходу з цієї сторінки воно стане зашифрованим. ID секрета не потрібен.

Після цих кроків наступні елементи мають бути готові до налаштування в Odoo:

• ID клієнта (ID клієнта або ID додатку)

• Секрет клієнта (Значення або Секретне значення клієнта)

На цьому налаштування на стороні Microsoft Azure Portal завершено.

Налаштування в Odoo

Введіть облікові дані Microsoft Outlook

Спочатку відкрийте базу даних Odoo і перейдіть до модуля Додатки. Потім видаліть фільтр Додатки з панелі пошуку та введіть Outlook. Після цього встановіть модуль під назвою Microsoft Outlook.

Далі перейдіть до Налаштування ‣ Загальні налаштування та в розділі Обговорення переконайтеся, що прапорець Власні сервери електронної пошти позначено. Це заповнює новий параметр для Облікові дані Outlook.

Зберегти прогрес.

Потім скопіюйте та вставте ID клієнта (ID додатку) і Секрет клієнта (Секретне Значення Клієнта) у відповідні поля та Зберегти налаштування.

Налаштувати сервер вихідної пошти

На сторінці Загальні параметри під налаштуванням Користувацькі сервери електронної пошти натисніть посилання Сервери вихідної електронної пошти, щоб налаштувати обліковий запис Microsoft.

Потім створіть новий сервер електронної пошти та поставте прапорець біля Outlook. Далі введіть Назва (воно може бути будь-яким) і адресу електронної пошти Microsoft Outlook Ім’я користувача.

Якщо поле Фільтр Від порожнє, введіть домен або електронну адресу.

Потім натисніть Підключити обліковий запис Outlook.

Відкриється нове вікно Microsoft для завершення процесу авторизації. Виберіть відповідну адресу ел. пошти, яка налаштовується в Odoo.

Потім дозвольте Odoo отримати доступ до облікового запису Microsoft, натиснувши Так. Після цього сторінка повернеться до щойно налаштованого сервера вихідної пошти в Odoo. Конфігурація автоматично завантажує токен в Odoo, і тег із зазначенням Outlook Token Valid з’являється зеленим кольором.

Нарешті натисніть Тестувати з’єднання. Має з’явитися повідомлення про підтвердження. База даних Odoo тепер може надсилати безпечні ел. листи через Microsoft Outlook за допомогою автентифікації OAuth.

Конфігурація з одним сервером вихідної пошти

Налаштування єдиного сервера вихідної пошти є найпростішою конфігурацією, доступною для Microsoft Azure, і вона не вимагає розширених прав доступу для користувачів до бази даних.

Загальна адреса електронної пошти використовуватиметься для надсилання електронних листів усім користувачам у базі даних. Наприклад, його можна структурувати за допомогою аліаса notifications (notifications@example.com) або аліаса`contact` (contact@example.com). Ця адреса має бути встановлена як Фільтрація ВІД на сервері. Ця адреса також має відповідати комбінації клавіш {mail.default.from}@{mail.catchall.domain} у системних параметрах.

Дивись також

Відвідайте Документація з фільтрації Від для отримання додаткової інформації.

Примітка

Доступ до Параметри системи можна отримати, активувавши Режим розробника (режим налагодження) в меню Параметри ‣ Технічні ‣ Параметри ‣ Системні параметри.

У разі використання цієї конфігурації кожен електронний лист, надісланий із бази даних, використовуватиме адресу налаштованої поштової скриньки сповіщень. Однак слід зазначити, що ім’я відправника з’явиться, але його електронна адреса зміниться:

Example

Конфігурація єдиного сервера вихідної пошти:

• Сервер вихідної пошти ім’я користувача (логін) = notifications@example.com

• Сервер вихідної пошти Фільтрація ВІД = notifications@example.com

• mail.catchall.domain в системних параметрах = example.com

• mail.default.from у системних параметрах = notifications

Спеціальна для користувача (кілька користувачів) конфігурація

На додаток до загального сервера електронної пошти, окремі сервери електронної пошти можна налаштувати для користувачів у базі даних. Щоб ця конфігурація працювала, ці адреси електронної пошти мають бути встановлені як Фільтрація ВІД на кожному окремому сервері.

Ця конфігурація є складнішою з двох конфігурацій Microsoft Azure, оскільки вона вимагає, щоб усі користувачі, налаштовані на сервери електронної пошти, мали права доступу до налаштувань для встановлення з’єднання з сервером електронної пошти.

Встановлення

Для кожного користувача повинен бути налаштований окремий сервер електронної пошти. Фільтрація ВІД слід налаштувати так, щоб із цього сервера надсилалися лише електронні листи користувача. Іншими словами, лише користувач із адресою електронної пошти, що відповідає набору Фільтрація ВІД, може використовувати цей сервер.

Дивись також

Відвідайте Документація з фільтрації Від для отримання додаткової інформації.

резервний сервер має бути налаштований, щоб дозволити надсилання notifications. Фільтрація ВІД для цього сервера має мати значення {mail.default.from}@{mail.catchall.domain}.

Примітка

Доступ до Параметри системи можна отримати, активувавши Режим розробника (режим налагодження) в меню Параметри ‣ Технічні ‣ Параметри ‣ Системні параметри.

Важливо

Конфігурація для цього транзакційного сервера електронної пошти може працювати разом із вихідним сервером масової пошти. Фільтрація ВІД для сервера масової розсилки електронної пошти може залишатися порожнім, але його потрібно додати в налаштуваннях додатку Електронний маркетинг.

Дивись також

Щоб дізнатися більше про налаштування сервера електронної пошти для масової розсилки, відвідайте Надсилання електронних листів через зовнішній сервер SMTP.

Example

Конфігурація сервера вихідної пошти для кількох користувачів:

• Поштова скринька користувача #1

  • Сервер вихідної пошти #1 username (login) = john@example.com

  • Сервер вихідної пошти #1 Фільтрація ВІД = john@example.com

• Поштова скринька користувача #2

  • Сервер вихідної пошти #2 username (login) = jane@example.com

  • Сервер вихідної пошти #2 Фільтрація ВІД = jane@example.com

• Поштова скринька сповіщень

  • Сервер вихідної пошти #3 username (login) = notifications@example.com

  • Сервер вихідної пошти #3 Фільтрація ВІД = notifications@example.com

• Параметри системи

  • mail.catchall.domain в системних параметрах = example.com

  • mail.default.from у системних параметрах = notifications

Налаштувати сервер вхідної пошти

Обліковий запис вхідної електронної пошти має бути налаштований подібно до облікового запису вихідної електронної пошти. Перейдіть до Сервери вхідної пошти в Технічне меню та Створити нову конфігурацію. Поставте прапорець або виберіть кнопку поруч із Автентифікація Outlook OAuth і введіть Ім’я користувача Microsoft Outlook. Натисніть Підключити обліковий запис Outlook. Odoo повідомить: Outlook Token Valid Тепер Перевірити та підтвердити обліковий запис. Обліковий запис має бути готовий до отримання електронної пошти до бази даних Odoo.