Подготовка секрета в Microsoft 365 (английский интерфейс)
Файл секрета — это файл с ключом доступа. С его помощью Яндекс 360 для бизнеса подключается к Microsoft 365. Чтобы его подготовить, нужно зарегистрировать приложение в Microsoft Azure, затем создать новый секрет и сохранить его в файл.
Шаг 1. Зарегистрируйте приложение в Microsoft Azure и создайте секреты
- Откройте страницу регистрации приложений в MS Azure portal (требуется авторизация от имени администратора): https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade.
- Нажмите New registration.
Введите данные:
- В поле Name введите название приложения, например migration.
- В Supported account types выберите Accounts in this organizational directory only (<название вашей организации>).
- Нажмите Register.
- Перейдите на вкладку Overview. Cкопируйте значение Application (client) ID и сохраните в текстовом файле. Этот идентификатор понадобится на следующих этапах.Пример идентификатора:
abcd1234-a1b2-1111-123a-absdfe
- Перейдите на вкладку Certificates & secrets и создайте новый секрет для приложения миграции:
- Выберите Client secrets и нажмите на New client secret.
- На появившейся панели заполните поле description (например: migration-secret).
- Нажмите Add.
- Скопируйте значение Value и сохраните в текстовом файле. Этот секрет понадобится на следующих этапах.Пример значения секрета:
ABCD2XYZ032-xyzXYZ032
- Перейдите на вкладку API permissions и добавьте разрешения:
- Нажмите Add a permission.
- Убедитесь, что на появившейся панели выбрана вкладка Microsoft APIs. Нажмите Microsoft Graph.
- Выберите Application permissions.
- Найдите следующие разрешения с помощью поиска, выберите их и нажмите кнопку Add permissions для каждого раздела:Mail: Mail.Read и Mail.ReadBasic.All (для переноса писем)Files: Files.Read.All (для поиска и скачивания файлов с диска)User.Read.All (для чтения списка пользователей)Sites.Read.All (для поиска и скачивания файлов из библиотек документов SharePoint Online)Внимание. Выберите все указанные выше разделы. Рекомендуется создавать один секрет, который будет использоваться и для писем, и для файлов. Если вы добавите разрешения только для писем (
Mail.Read
иMail.ReadBasic.All
), то не сможете запустить миграцию файлов с таким секретом. - Нажмите Add permissions.
После этого разрешения будут добавлены, но не подтверждены:
Нажмите Grant/revoke admin consent for <название вашей организации> для подтверждения доступов приложения. В появившемся окне нажмите Yes. Напротив каждого разрешения в колонке Status должен появиться значок .
Шаг 2. Создайте файл секрета
- Создайте файл
secret.json
в любом текстовом редакторе (например, Блокноте) и скопируйте туда шаблон:{ "client_id": "<client id>", "secret": "<secret>" }
- Вместо
<client id>
вставьте значение Application (client) ID, которое вы скопировали и сохранили в пункте 5 шага 1. Вместо<secret>
вставьте значение Value, которое вы скопировали и сохранили в пункте 6.4 шага 1.Пример, как должно получиться:{ "client_id": "abcd1234-a1b2-1111-123a-absdfe", "secret": "ABCD2~XYZ032-xyzXYZ032" }