Надсилання електронних листів через 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
- У центрі адміністрування Microsoft Entra відкрийте App registrations і натисніть New registration. Введіть назву, наприклад
Casdoor email, залиште значення Accounts in this organizational directory only і натисніть Register. - На сторінці Overview додатка скопіюйте Application (client) ID та Directory (tenant) ID.
- Перейдіть до Certificates & secrets > Client secrets > New client secret і скопіюйте значення Value секрету. Воно відображається лише один раз.
- Перейдіть до API permissions > Add a permission > Microsoft Graph > Application permissions і виберіть Mail.Send.
- Натисніть Grant admin consent для вашої організації.
Дозвіл додатка Mail.Send дозволяє додатку надсилати листи від імені будь-якої поштової скриньки тенанта. Щоб обмежити цю можливість лише для скриньки відправника, використовуйте RBAC for Applications in Exchange Online або політику доступу додатків.
Додайте провайдера в Casdoor
-
У консолі адміністрування Casdoor перейдіть до Identity > Providers і додайте провайдера.
-
Встановіть Category як
Emailта Type якMicrosoft Graph. Casdoor автоматично заповнить кінцеву точку, URL токена та область (scope). -
Заповніть поля:
Поле Значення Client ID Application (client) ID додатка Client secret Значення Value секрету клієнта From address Поштова скринька, яка надсилає електронні листи, наприклад noreply@contoso.com. Casdoor викликаєsendMailдля цієї скриньки, тому це поле обов'язковеFrom name (Необов'язково) Відображуване ім'я відправника Endpoint https://graph.microsoft.com/v1.0. Змінюйте його лише для національних хмар, наприкладhttps://graph.microsoft.us/v1.0Token URL https://login.microsoftonline.com/<tenant-id>/oauth2/v2.0/token, де<tenant-id>замінено на Directory (tenant) IDScope https://graph.microsoft.com/.default -
Введіть Email title та Email content. Див. Templates. Casdoor надсилає вміст як HTML і не зберігає копію в папці Sent Items.
-
Збережіть провайдера.
Опція Enable proxy надсилає запити токенів та виклики API через SOCKS5 проксі Casdoor. Див. Proxy.
Перевірте результат
- Натисніть Test SMTP Connection. Для цього типу Casdoor отримує лише токен, що перевіряє URL токена, ідентифікатор клієнта та секретний ключ клієнта без надсилання електронного листа.
- Натисніть Send Testing Email і перевірте, чи повідомлення доставлено на поштову скриньку Test Email.
Потім додайте постачальника до вашого додатка. Див. Add providers to an application.
Усунення несправностей
| Error | Cause |
|---|---|
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 з кодом AADSTS | Microsoft 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 404 | From address не є поштовою скринькою цього тенанта |