Перейти до основного вмісту

Надсилання електронних листів через Microsoft Graph

Цей посібник пояснює, як надсилати електронні листи Casdoor з поштової скриньки Microsoft 365 за допомогою API sendMail Microsoft Graph. Casdoor отримує токен лише для додатка від Microsoft Entra ID за потоком облікових даних клієнта та викликає POST /users/<mailbox>/sendMail. Він не використовує SMTP, тому працює в тенантах, де вимкнено SMTP AUTH. Щоб надсилати через SMTP, див. Microsoft 365.


Результати навчання​

  • Зареєструйте додаток у Microsoft Entra ID, який може надсилати пошту від імені поштової скриньки.
  • Додайте Microsoft Graph як провайдера електронної пошти в Casdoor і протестуйте його.

Що потрібно​

  • Тенант Microsoft 365 та поштова скринька, яка надсилає електронні листи, наприклад noreply@contoso.com. Спільна поштова скринька також підходить.
  • Обліковий запис, який може реєструвати додатки та надавати адміністративну згоду в Microsoft Entra ID
  • Адміністраторський доступ до консолі адміністрування Casdoor

Реєстрація додатка в Microsoft Entra ID​

  1. У центрі адміністрування Microsoft Entra відкрийте App registrations і натисніть New registration. Введіть назву, наприклад Casdoor email, залиште значення Accounts in this organizational directory only і натисніть Register.
  2. На сторінці Overview додатка скопіюйте Application (client) ID та Directory (tenant) ID.
  3. Перейдіть до Certificates & secrets > Client secrets > New client secret і скопіюйте значення Value секрету. Воно відображається лише один раз.
  4. Перейдіть до API permissions > Add a permission > Microsoft Graph > Application permissions і виберіть Mail.Send.
  5. Натисніть Grant admin consent для вашої організації.

Дозвіл додатка Mail.Send дозволяє додатку надсилати листи від імені будь-якої поштової скриньки тенанта. Щоб обмежити цю можливість лише для скриньки відправника, використовуйте RBAC for Applications in Exchange Online або політику доступу додатків.

Додайте провайдера в Casdoor​

  1. У консолі адміністрування Casdoor перейдіть до Identity > Providers і додайте провайдера.

  2. Встановіть Category як Email та Type як Microsoft Graph. Casdoor автоматично заповнить кінцеву точку, URL токена та область (scope).

  3. Заповніть поля:

    ПолеЗначення
    Client IDApplication (client) ID додатка
    Client secretЗначення Value секрету клієнта
    From addressПоштова скринька, яка надсилає електронні листи, наприклад noreply@contoso.com. Casdoor викликає sendMail для цієї скриньки, тому це поле обов'язкове
    From name(Необов'язково) Відображуване ім'я відправника
    Endpointhttps://graph.microsoft.com/v1.0. Змінюйте його лише для національних хмар, наприклад https://graph.microsoft.us/v1.0
    Token URLhttps://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token, де <tenant-id> замінено на Directory (tenant) ID
    Scopehttps://graph.microsoft.com/.default
  4. Введіть Email title та Email content. Див. Templates. Casdoor надсилає вміст як HTML і не зберігає копію в папці Sent Items.

  5. Збережіть провайдера.

Опція Enable proxy надсилає запити токенів та виклики API через SOCKS5 проксі Casdoor. Див. Proxy.

Перевірте результат​

  1. Натисніть Test SMTP Connection. Для цього типу Casdoor отримує лише токен, що перевіряє URL токена, ідентифікатор клієнта та секретний ключ клієнта без надсилання електронного листа.
  2. Натисніть Send Testing Email і перевірте, чи повідомлення доставлено на поштову скриньку Test Email.

Потім додайте постачальника до вашого додатка. Див. Add providers to an application.

Усунення несправностей​

ErrorCause
the token URL of the Microsoft Graph email provider is requiredПоле Token URL порожнє або все ще містить <tenant-id>
the from address of the Microsoft Graph email provider must be the mailbox that sends the emailsПоле From address порожнє або не є адресою електронної пошти
oauth2: cannot fetch token з кодом AADSTSMicrosoft Entra ID відхилив запит на отримання токена. Перевірте ID тенанта в полі Token URL, Client ID та Client secret. Останнє має бути саме значенням секрету, а не його ID, і термін дії секрета не повинен бути прострочений
Microsoft Graph sendMail failed with status 403Додаток не має дозволу додатка Mail.Send з адміністративною згодою, або політика доступу не дозволяє йому надсилати листи від імені From address
Microsoft Graph sendMail failed with status 404From address не є поштовою скринькою цього тенанта

Див. також​