Подготовка секрета в Microsoft 365

Файл секрета — это файл с ключом доступа. С его помощью Яндекс 360 для бизнеса подключается к Microsoft 365. Чтобы его подготовить, нужно зарегистрировать приложение в Microsoft Azure, затем создать новый секрет и сохранить его в файл.

  1. Шаг 1. Зарегистрируйте приложение в Microsoft Azure и создайте секреты
  2. Шаг 2. Создайте файл секрета

Шаг 1. Зарегистрируйте приложение в Microsoft Azure и создайте секреты

  1. Откройте страницу регистрации приложений в MS Azure portal (требуется авторизация от имени администратора): https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade.
  2. Нажмите New registration.

  3. Введите данные:

    • В поле Name введите название приложения, например migration.
    • В Supported account types выберите Accounts in this organizational directory only (<название вашей организации>).
  4. Нажмите Register.
  5. Перейдите на вкладку Overview. Cкопируйте значение Application (client) ID и сохраните в безопасном месте. Этот идентификатор понадобится на следующих этапах.
  6. Перейдите на вкладку Certificates & secrets и создайте новый секрет для приложения миграции:
    1. Выберите Client secrets и нажмите на New client secret.
    2. На появившейся панели заполните поле description (например: migration-secret).
    3. Нажмите Add.
    4. Скопируйте значение Value и сохраните в безопасном месте. Этот секрет понадобится на следующих этапах.
  7. Перейдите на вкладку API permissions и добавьте разрешения:
    1. Нажмите Add a permission button.
    2. Убедитесь, что на появившейся панели выбрана вкладка Microsoft APIs. Нажмите Microsoft Graph.
    3. Выберите Application permissions.
    4. В списке с помощью поиска найдите следующие разделы и добавьте для них разрешения:
      • Mail: Mail.Read и Mail.ReadBasic.All (для переноса почты).
      • Files: Files.Read.All (для поиска и скачивания файлов с диска).
      • User: User.Read.All (для чтения списка пользователей).
    5. Нажмите Add permissions.
  8. Нажмите Grant/revoke admin consent for <название вашей организации> для подтверждения доступов приложения. В появившемся окне нажмите Yes. После этого в колонке Status все кружки должны быть зелеными.

Шаг 2. Создайте файл секрета

  1. Скопируйте шаблон и сохраните его в файл secret.json.
    {
  "client_id": "<client id>",
  "secret": "<secret>"
}
  2. Вместо <client id> вставьте значение Application (client) ID, которое вы скопировали ранее. Вместо <secret> вставьте значение Value, которое вы скопировали ранее.
    Пример, как должно получиться:
    {
  "client_id": "abcd1234-a1b2-1111-123a-absdfe",
  "secret": "ABCD2~XYZ032-xyzXYZ032"
}