Краткое руководство: Начало работы с входящим конфигурированием на основе API с помощью cURL

Статья
01/30/2025

Знакомство

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 в качестве администратора приложений как минимум.
Перейдите к идентификатору Microsoft Entra — приложениям> —> корпоративным приложениям.
Во всех приложениях используйте текстовое поле фильтра поиска для поиска и открытия приложения провизирования, управляемого через 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
}

Дальнейшие действия

Устранение проблем с API входящего предоставления
Часто задаваемые вопросы о предоставлении доступа, управляемом API
краткое руководство по использованию PowerShell
Быстрый старт по использованию Azure Logic Apps

Поделиться через