Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Знакомство
cURL — это популярное, бесплатное, открытое, командное окно, используемое разработчиками API, и оно доступно по умолчанию в Windows 10/11. В этом руководстве описывается, как быстро протестировать подготовку входящих данных через API с помощью cURL.
Предварительные требования
- Вы настроили приложение для подготовки входящего трафика на основе API.
- Вы настроили субъект-службу и имеет доступ к API подготовки входящего трафика. Запишите
ClientId
иClientSecret
приложения субъекта-службы для использования в этом руководстве.
Загрузить данные пользователей в API входящего предоставления
- Получите client_id и client_secret сервисного принципала, имеющего доступ к API входящего обеспечения.
- Используйте поток OAuth client_credentials для получения токена доступа. Замените переменные
[yourClientId]
,[yourClientSecret]
и[yourTenantId]
значениями, применимыми к настройке, и выполните следующую команду cURL. Скопируйте значение маркера доступа, которое было созданоcurl -X POST -H "Content-Type: application/x-www-form-urlencoded" -d "client_id=[yourClientId]&scope=https%3A%2F%2Fgraph.microsoft.com%2F.default&client_secret=[yourClientSecret]&grant_type=client_credentials" "https://login.microsoftonline.com/[yourTenantId]/oauth2/v2.0/token"
- Скопируйте массовый запрос с помощью схемы пользователя SCIM Enterprise и сохраните содержимое в файле с именем
scim-bulk-upload-users.json
. - Замените переменную
[InboundProvisioningAPIEndpoint]
конечной точкой API подготовки, связанной с приложением подготовки. Используйте значение[AccessToken]
из предыдущего шага и выполните следующую команду curl, чтобы отправить пакетный запрос в конечную точку API предоставления.curl -v "[InboundProvisioningAPIEndpoint]" -d @scim-bulk-upload-users.json -H "Authorization: Bearer [AccessToken]" -H "Content-Type: application/scim+json"
- После успешной отправки вы получите код ответа HTTP 202 Accepted.
- Служба развертывания немедленно начинает обработку полезной нагрузки массового запроса, и вы можете просмотреть сведения о развертывании, получив доступ к журналам развертывания входящего приложения.
Проверьте обработку нагрузки массового запроса
Войдите в Центр администрирования Microsoft Entra как минимум администратор приложения.
Перейдите к Entra ID>приложениям для предприятий.
Во всех приложениях используйте текстовое поле фильтра поиска для поиска и открытия приложения провизирования, управляемого через API.
Откройте панель подготовки. Главная страница отображает состояние последнего запуска.
Выберите "Просмотреть журналы подготовки", чтобы открыть панель журналов подготовки. Кроме того, можно выбрать параметры меню "Мониторинг>журналов подготовки".
Выберите любую запись в журналах подготовки, чтобы просмотреть дополнительные сведения об обработке.
На экране деталей журнала подготовки отображаются все шаги, выполненные для конкретного пользователя.
- На шаге импорта из API см. сведения о данных пользователя, извлеченных из массового запроса.
- На шаге "Сопоставление" отображаются сведения о любом совпадении пользователя на основе соответствующего идентификатора. Если происходит совпадение пользователя, служба снабжения выполняет операцию обновления. Если не найдено соответствий для пользователя, служба подготовки выполняет операцию создания.
- Шаг определяет, находится ли пользователь в области и отображает сведения об оценке фильтра области. По умолчанию обрабатываются все пользователи. Если задать фильтр области (например, обработать только пользователей, принадлежащих отделу продаж), на этом шаге отображаются сведения об оценке фильтра области.
- Шаг "Подготовка пользователя" вызывает окончательный шаг обработки и изменения, примененные к учетной записи пользователя.
- Используйте вкладку "Измененные свойства " для просмотра обновлений атрибутов.
Приложение
Проверьте этот раздел для получения информации о массовом запросе с использованием схемы пользователя SCIM Enterprise.
Пакетный запрос с использованием схемы пользователя SCIM Enterprise
Массовый запрос, показанный следующим образом, использует стандартную схему пользователя SCIM Core и корпоративного пользователя.
Текст запроса
{
"schemas": ["urn:ietf:params:scim:api:messages:2.0:BulkRequest"],
"Operations": [
{
"method": "POST",
"bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
"path": "/Users",
"data": {
"schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"],
"externalId": "701984",
"userName": "bjensen@example.com",
"name": {
"formatted": "Ms. Barbara J Jensen, III",
"familyName": "Jensen",
"givenName": "Barbara",
"middleName": "Jane",
"honorificPrefix": "Ms.",
"honorificSuffix": "III"
},
"displayName": "Babs Jensen",
"nickName": "Babs",
"emails": [
{
"value": "bjensen@example.com",
"type": "work",
"primary": true
}
],
"addresses": [
{
"type": "work",
"streetAddress": "100 Universal City Plaza",
"locality": "Hollywood",
"region": "CA",
"postalCode": "91608",
"country": "USA",
"formatted": "100 Universal City Plaza\nHollywood, CA 91608 USA",
"primary": true
}
],
"phoneNumbers": [
{
"value": "555-555-5555",
"type": "work"
}
],
"userType": "Employee",
"title": "Tour Guide",
"preferredLanguage": "en-US",
"locale": "en-US",
"timezone": "America/Los_Angeles",
"active":true,
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"employeeNumber": "701984",
"costCenter": "4130",
"organization": "Universal Studios",
"division": "Theme Park",
"department": "Tour Operations",
"manager": {
"value": "89607",
"displayName": "John Smith"
}
}
}
},
{
"method": "POST",
"bulkId": "00aa00aa-bb11-cc22-dd33-44ee44ee44ee",
"path": "/Users",
"data": {
"schemas": ["urn:ietf:params:scim:schemas:core:2.0:User",
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User"],
"externalId": "701985",
"userName": "Kjensen@example.com",
"name": {
"formatted": "Ms. Kathy J Jensen, III",
"familyName": "Jensen",
"givenName": "Kathy",
"middleName": "Jane",
"honorificPrefix": "Ms.",
"honorificSuffix": "III"
},
"displayName": "Kathy Jensen",
"nickName": "Kathy",
"emails": [
{
"value": "kjensen@example.com",
"type": "work",
"primary": true
}
],
"addresses": [
{
"type": "work",
"streetAddress": "100 Oracle City Plaza",
"locality": "Hollywood",
"region": "CA",
"postalCode": "91618",
"country": "USA",
"formatted": "100 Oracle City Plaza\nHollywood, CA 91618 USA",
"primary": true
}
],
"phoneNumbers": [
{
"value": "555-555-5545",
"type": "work"
}
],
"userType": "Employee",
"title": "Tour Lead",
"preferredLanguage": "en-US",
"locale": "en-US",
"timezone": "America/Los_Angeles",
"active":true,
"urn:ietf:params:scim:schemas:extension:enterprise:2.0:User": {
"employeeNumber": "701985",
"costCenter": "4130",
"organization": "Universal Studios",
"division": "Theme Park",
"department": "Tour Operations",
"manager": {
"value": "701984",
"displayName": "Barbara Jensen"
}
}
}
}
],
"failOnErrors": null
}