Получение статистики по отношениям делегированных администраторов

Статья
07/02/2024

Область применения: Центр партнеров

Возвращает сведения о количестве связей делегированного администратора (DAP), установленных или активных, связанных с партнером для всех своих клиентов.

Назначение. Партнеры соответствуют безопасному управлению клиентом клиента и удалению неактивных связей DAP, которые находятся за пределами 90 дней с помощью связи Remove a DAP с клиентом - разработчиком приложений Центра партнеров.

Этот API помогает отслеживать статистику активных DAPs, чтобы партнеры могли переходить активные daPs на детализированные делегированные права администратора (GDAP).

Примечание.

Этот API является коротким и будет поддерживаться на этапе отмены DAP. После отмены программы DAP этот API будет снят.

Необходимые компоненты

Подтверждение компетенции

Этот сценарий поддерживает только проверку подлинности с использованием учетных данных приложений и пользователей.

Обмен маркерами для получения маркера доступа

Дополнительные сведения см. в статье "Настройка приложения для доступа к веб-API".

Создайте субъект-службу для приложения API делегированного администрирования клиента партнера в клиенте партнера, выполнив следующие команды из консоли PowerShell.

Подключитесь к идентификатору Microsoft Entra.

Connect-MgGraph

Пример. Миграция из Azure AD PowerShell в Microsoft Graph PowerShell. Дополнительные сведения см. в статье "Начало работы с пакетом SDK Для Microsoft Graph PowerShell".

Откроется интерактивное окно для входа. Введите учетные данные клиента песочницы.

Затем создайте субъект-службу: New-MgServicePrincipal -AppId 2832473f-ec63-45fb-976f-5d45a7d4bb91

Дополнительные сведения см. в статье New-MgServicePrincipal (Microsoft.Graph.Applications).

ObjectId	AppId	DisplayName
c1bf31da-09e5-4985-ab50-3232d4ae4f5a	2832473f-ec63-45fb-976f-5d45a7d4bb91	Делегированное администрирование клиента-партнера

Затем вы создадите приложение в клиенте, перейдя к портал Azure, а затем Регистрация приложений, а затем создайте общедоступное клиентское приложение или используйте существующее приложение.
Выбор разрешений API представления для добавления API разрешений>>, которые используются в моей организации
Выбор делегированных разрешений>делегированного администрирования партнера>
Предоставьте согласие администратора для этого нового разрешения.

Теперь вы можете использовать маркер app+User (с ресурсом https://api.partnercustomeradministration.microsoft.com) с помощью этого приложения (с администратором клиента, вошедшего в систему) для вызова API GDAP.

POST https://login.microsoftonline.com/<partner_tenant_id>/oauth2/token grant_type=client_credentials&scope:https://api.partnercustomeradministration.microsoft.com&client_id:<client_id>&client_secret:<client_secret>

Запрос REST

Синтаксис запроса

Способ	URI запроса
GET	`https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/delegatedAdminStatistics`

Параметр универсального кода ресурса

Для этого API не требуются параметры URI.

Заголовки запросов

Верхний колонтитул	Description	Значение
Авторизация	Маркер авторизации в носителе формы `<token>`.	Строка

Текст запроса

Не предоставляйте текст запроса для этого API.

Пример запроса

GET https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/ delegatedAdminStatistics  
HTTP/1.1 
Authorization: Bearer \<token\> 
Content-Type: application/json; charset=utf-8

Ответ REST

В случае успешного выполнения этот метод возвращает коллекцию делегированных ресурсовAdminStatistics в тексте ответа.

Коды успешного выполнения и ошибок в ответе

Каждый ответ содержит код состояния HTTP, указывающий на успешность или сбой, а также другие сведения об отладке. Используйте средство трассировки сети для чтения этого кода, типа ошибки и других параметров. Полный список ответов есть в статье Коды ошибок REST в Центре партнеров.

делегированный ресурсAdminStatistics

Представляет объект, содержащий статистику использования связей делегированного администратора (DAP).

Свойства

Свойство	Type	Описание
id	Строка	Уникальный идентификатор клиента партнера.
partnerTenantId	Строка	Уникальный идентификатор клиента партнера.
totalDapCustomerCount	Int	Общее число клиентов с доступом DAP.
establishedDapCount	делегированная коллекцияAdminAccessCount	Количество установленных (созданных) и дат создания DAPs. Пример. Если 10 DAP, созданных 6.18.2021, ответ будет включать "число" как 10 и "дата" как "6/18/2021".
inactiveDapCount	делегированная коллекцияAdminAccessCount	Количество клиентов, у которых были входы с последней датой входа. Пример. Если партнеры вошли в клиент 10 клиентов 6/18.2021, ответ будет включать "count" как 10 и "date" как "6/18/2021".

делегированный ресурсAdminAccessCount

Представляет количество делегированных администраторов в день.

Свойство	Type	Описание
Дата	Строка	Дата действия [установлено или вошедшего].
Count	Int	Количество клиентов.

Пример ответа

{ 

  "@odata.context": "https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/$metadata#delegatedAdminStatistics/$entity", 

  "id": "8984fecd-00a2-4686-ba43-b5c20866944a", 

  "partnerTenantId": "8984fecd-00a2-4686-ba43-b5c20866944a", 

  "totalDapCustomerCount": 200, 

  "establishedDapCount": [ 

    { 

      "date": "6/18/2021", 

      "count": 1 

    }, 

    { 

      "date": "2/18/2022", 

      "count": 1 

    } 

  ], 

  "inactiveDapCount": [ 

    { 

      "date": "2/18/2022", 

      "count": 1  

    }, 

    { 

      "date": "2/24/2022", 

      "count": 1 

    } 

  ] 

}

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