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

Получение appManagementPolicy

  • Статья

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Чтение свойств объекта appManagementPolicy .

Этот API доступен в следующих национальных облачных развертываниях.

Глобальная служба Правительство США L4 Правительство США L5 (DOD) Китай управляется 21Vianet
✅ ✅ ✅ ✅

Разрешения

Выберите разрешение или разрешения, помеченные как наименее привилегированные для этого API. Используйте более привилегированное разрешение или разрешения только в том случае, если это требуется приложению. Дополнительные сведения о делегированных разрешениях и разрешениях приложений см. в разделе Типы разрешений. Дополнительные сведения об этих разрешениях см. в справочнике по разрешениям.

Тип разрешения Разрешения с наименьшими привилегиями Более высокие привилегированные разрешения
Делегированное (рабочая или учебная учетная запись) Policy.Read.All Policy.Read.ApplicationConfiguration, Policy.ReadWrite.ApplicationConfiguration
Делегированные (личная учетная запись Майкрософт) Не поддерживается. Не поддерживается.
Для приложений Policy.Read.All Policy.Read.ApplicationConfiguration, Policy.ReadWrite.ApplicationConfiguration

Важно!

В делегированных сценариях с рабочими или учебными учетными записями вошедшему пользователю должна быть назначена поддерживаемая роль Microsoft Entra или настраиваемая роль с разрешением поддерживаемой роли. Для этой операции поддерживается следующая роль с наименьшими привилегиями:

  • Глобальный читатель

HTTP-запрос

GET /policies/appManagementPolicies/{id}

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

Имя Описание
Авторизация Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации.

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

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

Отклик

В случае успешного выполнения этот метод возвращает код отклика 200 OK и один объект appManagementPolicy в теле отклика.

Примеры

Запрос

Ниже показан пример запроса. В ответе политика управления приложениями определяет следующие ограничения для объектов приложения и субъекта-службы:

  • Блокирует создание новых паролей после 19.10.2019 в 10:37 по времени UTC.
  • Ограничивает секреты паролей для приложений, созданных после 2019-10-19 в 10:37 по времени UTC, менее чем 4 дня, 12 часов, 30 минут и 5 секунд.
GET https://graph.microsoft.com/beta/policies/appManagementPolicies/{id}

Отклик

Ниже приводится пример отклика.

HTTP/1.1 200 OK
Content-type: application/json

{
   "@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/appManagementPolicies",
   "value": [
      {
         "id": "db9d4b58-3488-4da4-9994-49773c454e33",
         "displayName": "Custom app management policy",
         "description": "Custom policy that enforces app management restrictions on specific applications and service principals.",
         "isEnabled": false,
         "restrictions": {
            "passwordCredentials": [
               {
                  "restrictionType": "passwordAddition",
                  "maxLifetime": null,
                  "restrictForAppsCreatedAfterDateTime": "2019-10-19T10:37:00Z"
               },
               {
                  "restrictionType": "passwordLifetime",
                  "maxLifetime": "P90D",
                  "restrictForAppsCreatedAfterDateTime": "2017-10-19T10:37:00Z"
               },
               {
                  "restrictionType": "symmetricKeyAddition",
                  "maxLifetime": null,
                  "restrictForAppsCreatedAfterDateTime": "2021-10-19T10:37:00Z"
               },
               {
                  "restrictionType": "symmetricKeyLifetime",
                  "maxLifetime": "P30D",
                  "restrictForAppsCreatedAfterDateTime": "2014-10-19T10:37:00Z"
               }
            ],
            "keyCredentials": [
               {
                  "restrictionType": "asymmetricKeyLifetime",
                  "maxLifetime": "P90D",
                  "restrictForAppsCreatedAfterDateTime": "2014-10-19T10:37:00Z"
               },
               {
                  "restrictionType": "trustedCertificateAuthority",
                  "restrictForAppsCreatedAfterDateTime": "2019-10-19T10:37:00Z",
                  "certificateBasedApplicationConfigurationIds": [
                     "eec5ba11-2fc0-4113-83a2-ed986ed13743",
                     "bb8e164b-f9ed-4b98-bc45-65eddc14f4c1"
                  ],
                  "maxLifetime": null
               }
            ],
            "applicationRestrictions": {
               "identifierUris": {
                  "nonDefaultUriAddition": {
                     "restrictForAppsCreatedAfterDateTime": "2024-01-01T10:37:00Z",
                     "excludeAppsReceivingV2Tokens": true,
                     "excludeSaml": true
                  }
               }
            }
         }
      }
   ]
}