Тип ресурса apiApplication

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

Определяет параметры для приложения , реализующего веб-API.

Свойства

Свойство Тип Описание
acceptMappedClaims Логический Когда true, разрешает приложению использовать сопоставление утверждений без указания пользовательского ключа подписи.
knownClientApplications Коллекция объектов Guid Используется для объединения согласия, если у вас есть решение, состоящее из двух частей: клиентского приложения и пользовательского приложения веб-API. Если задать это значение для appID клиентского приложения, пользователь даст согласие клиентскому приложению только один раз. Microsoft Entra ID знает, что согласие с клиентом означает неявное согласие на веб-API, и автоматически подготавливает субъекты служб для обоих API одновременно. Клиент и приложение веб-API должны быть зарегистрированы в одном клиенте.
oauth2PermissionScopes Коллекция permissionScope Определение делегированных разрешений, предоставляемых веб-API, представленное регистрацией этого приложения. Эти делегированные разрешения могут быть запрошены клиентским приложением и могут быть предоставлены пользователями или администраторами в процессе предоставления согласия. Делегированные разрешения иногда называют областями OAuth 2.0.

Для этих областей и ролей appRoles применяется ограничение по умолчанию в 700 определений разрешений для одного приложения. Учитываются как включенные, так и отключенные определения. Правила подсчета, поведение существующих объектов, превышающих ограничение, и рекомендации по проектированию см. в статье Ограничения ролей приложений.
preAuthorizedApplications Коллекция preAuthorizedApplication Список клиентских приложений, предварительно авторизованных с указанными делегированными разрешениями на доступ к API этого приложения. Пользователям не требуется давать согласие на доступ к предварительно авторизованным приложениям (для указанных разрешений). Однако любые другие разрешения, не перечисленные в preAuthorizedApplications (например, запрашиваемые через добавочное согласие), потребуют согласия пользователя.
requestedAccessTokenVersion Int32 Указывает версию маркера доступа, ожидаемую этим ресурсом. При этом изменяется версия и формат JWT, создаваемого независимо от конечной точки или клиента, используемого для запроса маркера доступа.

Используемая конечная точка, версия 1.0 или версия 2.0, выбирается клиентом и влияет только на версию id_tokens. Ресурсы должны явно настроить requestedAccessTokenVersion , чтобы указать поддерживаемый формат маркера доступа.

Возможные значения для requestedAccessTokenVersion : 1, 2или null. Если значением является null, по умолчанию используется значение 1, что соответствует конечной точке версии 1.0.

Если signInAudience в приложении настроен как AzureADandPersonalMicrosoftAccount или PersonalMicrosoftAccount, значение этого свойства должно быть равно 2.

Представление JSON

В следующем представлении JSON показан тип ресурса.

{
  "acceptMappedClaims": true,
  "knownClientApplications": ["Guid"],
  "oauth2PermissionScopes": [{"@odata.type": "microsoft.graph.permissionScope"}],
  "preAuthorizedApplications": [{"@odata.type": "microsoft.graph.preAuthorizedApplication"}],
  "requestedAccessTokenVersion": 2
}