Краткое руководство по подготовке входящего трафика с помощью cURL

Статья
02/28/2024

Введение

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 как минимум приложение Администратор istrator.
Перейдите к идентификатору 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
}

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