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

Статья
02/28/2024

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

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

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

Примечание.

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

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

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

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

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