Блог

Я изучаю Microsoft Graph и для этого использую Graph Explorer и Postman.

С помощью Graph Explorer: я вошел в свою личную учетную запись пользователя (hotmail). Как только я подключаюсь, я вижу токен. Странно, когда я копирую / вставляю этот токен в jwt.io он не может быть расшифрован. Тем не менее, я могу выполнить запрос, например https://graph.microsoft.com/v1.0/me который возвращает мне некоторую информацию о себе как о пользователе (с http 200). Или этот запрос https://graph.microsoft.com/v1.0/me/sendMail которые позволяют мне отправлять тест и получать тестовое письмо (с http 202). Все эти запросы были «делегированными разрешениями». Поэтому у меня нет никаких проблем с использованием Graph Explorer с моей личной учетной записью (hotmail).

С Postman: на этот раз я проведу несколько тестов с «разрешением приложения». Я выполнил следующие действия:

На портале Azure

Шаг 1: Регистрация приложений / Новая регистрация / я даю имя / Выбираю 3-й тип учетной записи (учетные записи в любом организационном каталоге и личные учетные записи Microsoft) / Нажмите на кнопку регистрации

Шаг 2: Разрешения Api / Добавить разрешение / Microsoft Graph / Разрешения приложений / Почта.Отправить (отправлять почту от имени любого пользователя)

Шаг 3. Согласие главного администратора на … кнопка для активации разрешения

Шаг 4. Сертификат и секреты / Новый секрет клиента / Введите описание / Нажмите кнопку Добавить

Шаг 5: Получите жетон в Postman

• Публикация
  • https://login.microsoftonline.com /{мой-идентификатор-арендатора-здесь}/oauth2/v2.0/токен
• ЗАГОЛОВКИ
  • Тип содержимого: application / x-www-form-urlencoded
• Тело
  • client_id: {my-client-id-here}
  • client_secret: {my-client-secret-here}
  • grant_type: client_credentials
  • область применения: https://graph.microsoft.com/.default
• Хорошо, у меня есть жетон

При копировании / вставке этого токена в jwt.io Я вижу это:

Шаг 6. Запрос для перечисления всех пользователей

• ПОЛУЧИТЬ
  • https://graph.microsoft.com/v1.0/users
• АВТОРИЗАЦИЯ
  • Токен на предъявителя: {токен на предъявителя-получен-ранее}
• ЗАГОЛОВКИ
  • Тип содержимого: application / json
• ХОРОШО, я получил информацию для всех пользователей (в формате json)

Шаг 7. Запрос на отправку почты

• Публикация
  • https://graph.microsoft.com/v1.0/users /{имя пользователя-участника}/Отправить почту
• АВТОРИЗАЦИЯ
  • Токен на предъявителя: {токен на предъявителя-получен-ранее}
• ЗАГОЛОВКИ
  • Тип содержимого: application / json
• ТЕЛО (JSON)

 {
  "message": {
    "subject": "This is my subject",
    "body": {
      "contentType": "Text",
      "content": "This is my content"
    },
    "toRecipients": [
      {
        "emailAddress": {
          "address": "thierry.langie@skynet.be"
        }
      }
    ],
    "ccRecipients": [
    ]
  },
  "saveToSentItems": "false"
 }
 

• Ошибка NOT OK: MailboxNotEnabledForRESTAPI — REST API еще не поддерживается для этого почтового ящика

Я хотел бы знать, почему я получил эту ошибку? я могу отправлять электронную почту с помощью Graph Explorer (при использовании делегированного разрешения), а не с помощью Postman (при использовании разрешения приложения).

Как вы можете видеть ниже, я предоставляю согласие администратора в корпоративных приложениях на портале Azure.

Я где-то читал, что ошибка означает, что у пользователя нет почтового ящика в облаке EXO. EXO — это O365 Exchange Online Cloud. Поэтому, если у вас нет почтового ящика в облаке, API-интерфейсы O365 Exchange REST не будут работать для этих пользователей. Если это так, что бы вы сделали?

У меня есть веб-приложение, которое должно отправлять письма из общего почтового ящика. Независимо от того, какой пользователь подключен, это всегда один и тот же почтовый ящик, который используется для отправки почты. Вот почему я использую «разрешение приложения» и «Поток учетных данных клиента».

Как объяснялось выше, я использую свою личную учетную запись (hotmail) для тестирования, но в рабочей среде я буду использовать рабочую учетную запись (недоступную из моей среды разработки).

В качестве примечания я знаю, что существуют библиотеки, облегчающие процесс и позволяющие избежать использования вызовов REST API (URL-адресов), но я не думаю, что это может объяснить проблему, с которой я сталкиваюсь.

«MailboxNotEnabledForRESTAPI — REST API еще не поддерживается для этого почтового ящика» Это сообщение об ошибке означает, что учетная запись электронной почты, которую вы используете для отправки электронной почты, не имеет лицензии Exchange Online.

Для личной учетной записи следует использовать делегированное разрешение, которое вы пробовали в Microsoft Graph Explorer. Смотрите Разрешения здесь.

.

Если мы добавим личную учетную запись к вашему клиенту в качестве гостевого пользователя, хотя мы можем назначить лицензию гостевому пользователю (я предполагаю, что мы можем назначить гостевому пользователю лицензию EXO), почтовый ящик, размещенный в EXO, отличается от почтового ящика личной учетной записи. Это всего 2 отдельных почтовых ящика. И на самом деле мне не удалось назначить гостю лицензию EXO.

Таким образом, в этом случае поток учетных данных клиента применяется к пользователям AAD, а не к личной учетной записи.

Обновить:

Для личной учетной записи, которая использует делегированное разрешение (вы попробовали в Microsoft Graph Explorer), конечной точкой авторизации является https://login.microsoftonline.com/commonm/oauth2/v2.0/authorize или https://login.microsoftonline.com/consumers/oauth2/v2.0/authorize .

Но когда вы используете поток учетных данных клиента с разрешением приложения, вы должны указать идентификатор клиента в запросе https://login.microsoftonline.com/{tenant id}/oauth2/v2.0/authorize .

Хотя ваша личная учетная запись добавлена в клиент в качестве гостевого пользователя, у нее нет лицензии EXO (на основе теста мы не можем назначить ей лицензию EXO), поэтому она не будет размещена в O365.

Вот почему мы не можем использовать поток учетных данных клиента с личным кабинетом.