Налаштування колекції Postman для служби екологічних кредитів (підготовча версія)
Важливо
Деякі або всі ці функції доступні в підготовчому версії. Вміст і функції можуть змінитися. Ви можете отримати доступ до середовища пісочниці Environmental Credit Service (підготовча версія) для 30-денного пробного періоду. Щоб використовувати Послугу екологічного кредитування (підготовча версія) у виробничому середовищі, заповніть форму реєстрації Служби екологічного кредитування (підготовча версія).
Ви можете скопіювати колекцію Postman і змінити параметри за потреби.
Служба екологічного кредитування на борту (підготовча версія) як основний додаток у вашому Microsoft Entra ID-клієнті
Щоб пройти автентифікацію в службі екологічного кредитування (підготовча версія), користувачі з вашого каталогу повинні представити маркер автентифікації, зокрема веб-токен JSON, з деякими необхідними вимогами. Ці вимоги допоможуть Службі екологічного кредитування (підготовча версія) ідентифікувати доступ, що надається користувачу.
Нотатка
Оскільки Environmental Credit Service (підготовча версія) є власною програмою Microsoft, ви не можете видалити її зі свого клієнта після розгортання.
Переконайтеся, що у вас є доступ до розгортання служби екологічного кредитування (підготовча версія) у вашому клієнті.
Перейдіть до налаштувань > Microsoft Entra користувача Azure Portal > ID і перевірте наявність властивості Користувачі можуть реєструвати програми. Якщо встановлено значення Ні, зверніться до одного з Microsoft Entra адміністраторів ID клієнта, щоб налаштувати службу екологічного кредитування (підготовча версія) у вашому клієнті.
Цей дозвіл також може знадобитися, щоб зареєструвати будь-який клієнт або веб-додатки у вашому клієнті відповідно до застосовного сценарію для вашої команди.
Дотримуйтесь інструкцій, наведених у Microsoft Entra розділі Підключення до модуля ID PowerShell for Graph. Ці кроки налаштують модуль ID PowerShell і з’єднаються Microsoft Entra з вашим Microsoft Entra клієнтом ID за допомогою посвідчення, яке має дозволи, зазначені в першому кроці.
Щоб розгорнути службу Environmental Credit Service (підготовча версія) у вашому клієнті, використовуйте цю команду PowerShell, вказавши свій Microsoft Entra ID модуль PowerShell:
New-AzureADServicePrincipal -AppId "b9b0ac19-f710-429d-b58e-dc3f73a330a9" -DisplayName "Environmental Credit Service"Після того, як у вашому клієнті буде розгорнуто службу екологічного кредиту (підготовча версія), перейдіть до розділу Azure Portal > Microsoft Entra ID > Enterprise Applications (Корпоративні програми > ) Виберіть Microsoft Applications (і Apply Application). Знайдіть Службу екологічного кредитування (підготовча версія), щоб уявити розгорнутий корпоративний додаток.
Налаштуйте колекцію Postman
Щоб налаштувати колекцію Postman для Служби екологічного кредитування (підготовча версія), виконайте цей одноразовий крок для кожного Microsoft Entra ID-клієнта, який ви використовуєте, який взаємодіятиме зі Службою екологічного кредитування (підготовча версія):
Зареєструйте загальнодоступну клієнтську програму в клієнті, перейшовши до розділу Azure Portal > Microsoft Entra ID > Registration App New > registration. Введіть наведені нижче значення.
- Ім’я: укажіть дійсне відображуване ім’я, орієнтоване на користувача.
- Підтримувані типи облікових записів: виберіть опцію Облікові записи лише в цьому каталозі організації, оскільки програма не автентифікуватиме облікові записи користувачів за межами цього клієнта.
- У цьому випадку URI перенаправлення не очікується.
Виберіть Автентифікація. У додаткових налаштуваннях установіть для параметра Розглядати програму як загальнодоступний клієнт значення Так . Зберегти зміни. Загальнодоступні клієнтські програми дають змогу користувачам автентифікуватися за допомогою мобільних або настільних робочих процесів і збирати паролі у вигляді простого тексту за допомогою процесу облікових даних власника ресурсу.
Виберіть розділ Маніфест . У редакторі JSON знайдіть властивість accessTokenAcceptedVersion і встановіть її значення 2 . Виберіть Зберегти , щоб застосувати зміни.
У цьому сценарії публічний клієнт намагається використати токен користувача, який увійшов у систему, для доступу до API Служби екологічного кредитування (підготовча версія). Додаток повинен запросити делегований дозвіл Application.ReadWrite , як це видано корпоративним додатком Служби екологічного кредиту (підготовча версія), зареєстрованим у розділі передумов:
- Перейдіть до зареєстрованої програми, виберіть дозволи API, а потім виберіть Додати дозвіл.
- Виберіть вкладку API , які використовує моя організація, і знайдіть корпоративну програму Environmental Credit Service (підготовча версія), яку було розгорнуто в клієнті під час виконання попередніх кроків.
- Виберіть Делеговані дозволи. Для делегованих дозволів потрібна одноразова згода користувача, яка вказує, що програма може використовувати їх токен для доступу до необхідного ресурсу. Оскільки цей сценарій передбачає неінтерактивний робочий процес, адміністратор орендаря має заздалегідь надати згоду на необхідні делеговані дозволи.
Після налаштування делегованих дозволів ви можете неінтерактивно запитувати маркер доступу, використовуючи дані, надані в розділі Запит на авторизацію.
Значення властивості scope у запиті маркера доступу має дорівнювати області видимості Application.ReadWrite : https://ecs.mcfs.microsoft.com/Application.ReadWrite. Виклик кінцевої точки токена може бути ініційований до того, як він потрапить до будь-якого API Служби екологічного кредитування (підготовча версія).
Після того, як аутентифікація працює, оновіть наступні змінні колекції Postman:
Встановіть змінні ідентифікатора клієнта на властивість ID програми запуску публічних клієнтських програм, зареєстрованих у відповідних Microsoft Entra клієнтських ідентифікаторах, як описано в попередніх кроках.
Оновіть ім’я користувача (email) і пароль за потреби для доступних змінних у колекції Postman.
Пов’язані відомості
Огляд
служби екологічного кредитування (підготовча версія) Сервіс екологічного кредитування (підготовча версія) глосарій
Довідковий огляд API для служби екологічного кредитування (підготовча версія)
