Краткое руководство по подготовке входящего трафика на основе API с помощью обозревателя Graph

Статья
02/28/2024

В этом руководстве описывается, как быстро протестировать входящий трафик , управляемый API, с помощью Microsoft Graph Explorer.

Предварительные требования

Вы настроили приложение для подготовки входящего трафика на основе API.

Примечание.

Этот API подготовки в основном предназначен для использования в приложении или службе. Администраторы клиента могут настроить субъект-службу или управляемое удостоверение, чтобы предоставить разрешение на отправку. Для этого API не существует отдельной роли каталога Microsoft Entra, назначаемой пользователем. Вне приложений, которые получили SynchronizationData-User.Upload разрешение с согласием администратора, только пользователи с ролью глобального администратора могут вызывать API. В этом руководстве показано, как протестировать API с помощью роли глобального администратора в тестовой настройке.

Отправка данных пользователей в API входящего трафика подготовки

Откройте новую вкладку браузера или окно браузера.
Запустите URL-адрес https://aka.ms/ge для доступа к Microsoft Graph Explorer.
Щелкните значок профиля пользователя, чтобы войти.
Выполните процесс входа с учетной записью пользователя с ролью глобального администратора .
После успешного входа сведения о клиенте отображают имя клиента.

Теперь вы готовы вызвать API.
На панели запросов API задайте тип HTTP-запроса POST.
Скопируйте и вставьте конечную точку API подготовки, полученную на странице обзора приложения подготовки.
На панели заголовков запросов добавьте новую пару значений ключа Content-Type = application/scim+json.
На панели текста запроса скопируйте массовый запрос с помощью схемы пользователя SCIM Enterprise
Нажмите кнопку "Выполнить запрос", чтобы отправить запрос в конечную точку API подготовки.
Если запрос отправлен успешно, вы получите Accepted 202 ответ от конечной точки API.
Откройте панель заголовков ответа и скопируйте значение URL-адреса атрибута расположения. Это указывает на конечную точку API подготовки журналов, которую можно запросить, чтобы проверить состояние подготовки пользователей, присутствующих в массовом запросе.

Проверка обработки полезных данных массового запроса

Вы можете проверить обработку из Центра администрирования Microsoft Entra или с помощью обозревателя Graph.

Проверка обработки из Центра администрирования Microsoft Entra

Войдите в Центр администрирования Microsoft Entra, используя по крайней мере учетные данные для входа администратора приложений.
Перейдите к идентификатору Microsoft Entra —> приложениям —> корпоративным приложениям.
Во всех приложениях используйте текстовое поле фильтра поиска для поиска и открытия приложения подготовки на основе API.
Откройте колонку подготовки. Целевая страница отображает состояние последнего запуска.
Щелкните "Просмотреть журналы подготовки", чтобы открыть колонку журналов подготовки. Кроме того, можно щелкнуть пункт "Монитор меню" —> журналы подготовки.
Щелкните любую запись в журналах подготовки, чтобы просмотреть дополнительные сведения об обработке.
На экране сведений о журнале подготовки отображаются все шаги, выполненные для конкретного пользователя.
- На шаге импорта из API см. сведения о данных пользователя, извлеченных из массового запроса.
- На шаге "Сопоставление" отображаются сведения о любом совпадении пользователя на основе соответствующего идентификатора. Если пользователь совпадает, служба подготовки выполняет операцию обновления. Если совпадения с пользователем отсутствуют, служба подготовки выполняет операцию создания.
- На шаге области определяется, находится ли пользователь в области , отображаются сведения об оценке фильтра области. По умолчанию обрабатываются все пользователи. Если вы настроили фильтр области (например, обработать только пользователей, принадлежащих отделу продаж), сведения об оценке фильтра области отображаются на этом шаге.
- Шаг "Подготовка пользователя" вызывает окончательный шаг обработки и изменения, примененные к учетной записи пользователя.
- Используйте вкладку "Измененные свойства " для просмотра обновлений атрибутов.

Проверка обработки с помощью API подготовки журналов в обозревателе Graph

Вы можете проверить обработку с помощью URL-адреса API журналов подготовки, возвращаемого в качестве части заголовка ответа расположения в вызове API подготовки.

В обозревателе Graph в текстовое поле "Запрос URL-адреса" скопируйте URL-адрес расположения, возвращаемый конечной точкой API подготовки или вы можете создать его с помощью формата: https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>' где можно получить jobId на странице обзора приложения подготовки.
Используйте метод GET и нажмите кнопку "Выполнить запрос ", чтобы получить журналы подготовки. По умолчанию возвращенный ответ содержит все записи журнала.
Можно задать дополнительные фильтры, чтобы получить данные только после определенного интервала времени или с определенным значением состояния. https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId> and statusInfo/status eq 'failure' and activityDateTime ge 2022-10-10T09:47:34Z Вы также можете проверить состояние пользователя по externalId значению, используемому в исходной системе, которая используется в качестве исходной привязки или свойства присоединения. https://graph.microsoft.com/beta/auditLogs/provisioning/?$filter=jobid eq '<jobId>' and sourceIdentity/id eq '701984'

Приложение

Массовый запрос с помощью схемы пользователя 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
}

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