apiApplication 资源类型

命名空间:microsoft.graph

指定实现 Web API 的 应用程序 的设置。

属性

属性 类型 说明
acceptMappedClaims 布尔值 时间 true,允许应用程序在不指定自定义签名密钥的情况下使用声明映射。
knownClientApplications Guid 集合 如果解决方案包含两部分:客户端应用和自定义 Web API 应用,则用于捆绑许可。 如果将客户端应用的 appID 设置为此值,则用户只会同意客户端应用一次。 Microsoft Entra ID 知道同意客户端意味着隐式同意 Web API,并同时自动为这两个 API 预配服务主体。 客户端和 Web API 应用必须在同一租户中注册。
oauth2PermissionScopes permissionScope 集合 此应用程序注册所表示的 Web API 公开的委派权限的定义。 这些委托权限可以由客户端应用程序请求,也可以由用户或管理员在同意期间授予。 委托权限有时称为 OAuth 2.0 范围。

这些作用域和应用程序的 appRoles 共享每个应用程序 700 个权限定义的默认限制。 启用和禁用的定义都算在内。 有关计数规则、超过限制的现有对象的行为以及设计指南,请参阅 应用角色限制。
preAuthorizedApplications preAuthorizedApplication 集合 列出已预先授权并具有指定委派权限以访问此应用程序的 API 的客户端应用程序。 用户无需同意任何预先授权的应用程序 () 指定的权限。 但是,preAuthorizedApplications 中未列出的任何其他权限 (通过增量同意请求的,例如) 需要用户同意。
requestedAccessTokenVersion Int32 指定此资源所需的访问令牌版本。 这更改生成的 JWT 的版本和格式,与用于请求访问令牌的终结点或客户端无关。

使用的终结点 v1.0 或 v2.0 由客户端选择,仅影响 id_tokens 的版本。 资源需要显式配置 requestedAccessTokenVersion 以指示支持的访问令牌格式。

requestedAccessTokenVersion 的可能值为 1、 或 2null。 如果值为 null,则默认 1为 ,这对应于 v1.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
}