大网数据广告活动
Microsoft Graph 接口

使用 Microsoft 图形 API配置访问评审的范围

· 52CE 我爱测

了解如何使用 Microsoft 图形 API 以编程方式查看用户、服务主体或组对 Azure AD 资源的访问权限。

使用 Azure AD 访问评审 API ,可以以编程方式查看用户、服务主体或组对 Azure AD 资源的访问权限。 API 可帮助你自动执行主动评审并控制对组织中资源的访问。

要审阅的资源在 accessReviewScheduleDefinition 资源 的范围 属性中配置。 此属性属于 accessReviewScope 类型,这是可用于配置访问评审范围的以下 API 资源继承的抽象类型。

资源 说明 示例场景
accessReviewQueryScope 继承自 accessReviewScope。 查看有权访问资源或相关资源组的主体的完整集或子集时最适用。 <ul><li>分配给组的用户的成员身份(直接成员或直接成员和可传递成员)。</li><li>来宾用户对一个组的访问权限。</li><li>来宾用户访问租户中的所有 Microsoft 365 组。</li><li>分配给特权角色的服务主体。</li><li>用户和服务主体对权利管理访问包的访问权限。</li></ul>
accessReviewInactiveUsersQueryScope 继承自 accessReviewQueryScope。 仅审阅非活动用户时使用。 非活动状态由 非活动重复 属性指定。 <ul><li>仅非活动用户的组成员身份。</li><ul>
principalResourceMembershipsScope 继承自 accessReviewScope。 最适用于查看主体对配置主体和资源的唯一池的资源的访问权限。 <ul><li>查看对一个 Microsoft 365 组 和 一个特权 Azure AD 角色的三个特定主体的访问权限。</li><ul>

本文介绍如何使用这三种派生资源类型来限制访问评审的范围。

使用 accessReviewQueryScope 和 accessReviewInactiveUsersQueryScope 配置范围

若要使用 accessReviewQueryScope 类型配置范围,请设置其 **查询、**queryRoot 和 queryType 属性的值。 有关这些属性的说明,请参阅 accessReviewQueryScope 资源类型。

accessReviewInactiveUsersQueryScope 需要 accessReviewQueryScope 的所有属性,并包含 非活动性重复 属性。

示例 1:查看分配给组的所有用户

下面的示例将评审范围限定为属于用户的组的直接成员和可传递成员。 可传递成员是嵌套组的成员。

"scope": {
    "@odata.type": "#microsoft.graph.accessReviewQueryScope",
    "query": "/groups/{groupId}/transitiveMembers/microsoft.graph.user",
    "queryType": "MicrosoftGraph"
}

示例方案: 假设组 A 有三个直接成员 - 用户 AU1 和 AU2 和组 G1。 另一方面,G1 组有两个成员 - 用户 GU1 和 GU2。 因此,用户 GU1 和 GU2 是嵌套组 G1 的可传递成员。 评审中将包含四个对象:用户 AU1、AU2、GU1 和 GU2。

仅查看分配给组的 非活动用户 :

"scope": {
    "@odata.type": "#microsoft.graph.accessReviewInactiveUsersQueryScope",
    "inactiveDuration": "P30D",
    "query": "/groups/{groupId}/transitiveMembers/microsoft.graph.user",
    "queryType": "MicrosoftGraph"
}

本示例还将评审范围限定到非活动用户组的直接成员和可传递成员。

示例 2:查看分配给组的所有来宾用户

以下示例将评审范围限定到作为来宾用户的组的直接成员和可传递成员。 可传递成员是嵌套组的成员。

"scope": {
    "@odata.type": "#microsoft.graph.accessReviewQueryScope",
    "query": "/groups/{groupId}/transitiveMembers/microsoft.graph.user/?$filter=(userType eq 'Guest')",    
    "queryType": "MicrosoftGraph"
}

示例 3:查看分配给组的所有用户和组

下面的示例将评审范围限定为仅将组的成员定向为用户或其他组。 在此范围内:

  • 直接用户包含在评审中。
  • 直接组包含在评审中。
  • 评审中不包括组的可传递成员(即嵌套组的成员)。
"scope": {
        "query": "/groups/{groupId}/members",
        "queryType": "MicrosoftGraph"
}

示例方案: 假设组 A 有三个直接成员 - 用户 AU1 和 AU2 和组 G1。 另一方面,G1 组有两个成员 - 用户 GU1 和 GU2。 因此,用户 GU1 和 GU2 是嵌套组 G1 的可传递成员。 在上述评审中,只有三个对象成为目标,用户是 AU1 和 AU2,以及组 G1。

示例 4:查看分配给所有 Microsoft 365 组的所有用户

以下示例创建对包含来宾用户的每个 Microsoft 365 组的评审。 对于每个组的审阅实例,评审范围仅限作为来宾用户的组的直接成员。

"instanceEnumerationScope": {
    "query": "/groups?$filter=(groupTypes/any(c:c eq 'Unified'))",
    "queryType": "MicrosoftGraph"
},
"scope": {
    "@odata.type": "#microsoft.graph.accessReviewQueryScope",
    "query": "./members/microsoft.graph.user",
    "queryType": "MicrosoftGraph"
}

此外,由于此评审适用于所有 Microsoft 365 组,因此请将 instanceEnumerationScope 配置为指定要审阅的 Microsoft 365 组。 此评审中不包括动态组和可分配角色的组。

示例 5:查看分配给所有 Microsoft 365 组的所有来宾用户

以下示例将评审范围限定到所有作为来宾用户的 Microsoft 365 组的成员。

"instanceEnumerationScope": {
    "query": "/groups?$filter=(groupTypes/any(c:c eq 'Unified'))",
    "queryType": "MicrosoftGraph"
},
"scope": {
    "@odata.type": "#microsoft.graph.accessReviewQueryScope",
    "query": "./members/microsoft.graph.user/?$filter=(userType eq 'Guest')",
    "queryType": "MicrosoftGraph"
}

此外,由于此评审适用于所有 Microsoft 365 组,因此请将 instanceEnumerationScope 配置为指定要审阅的 Microsoft 365 组。 此评审中不包括动态组和可分配角色的组。

查看分配给所有 Microsoft 365 组的所有非活动来宾用户

以下示例将评审范围限定为所有非活动来宾用户的所有 Microsoft 365 成员。

"instanceEnumerationScope": {
    "query": "/groups?$filter=(groupTypes/any(c:c eq 'Unified'))",
    "queryType": "MicrosoftGraph"
},
"scope": {
    "@odata.type": "#microsoft.graph.accessReviewInactiveUsersQueryScope",
    "query": "./members/microsoft.graph.user/?$filter=(userType eq 'Guest')",
    "queryType": "MicrosoftGraph",
    "inactiveDuration": "P30D"
}

此外,由于此评审应用于非活动用户,请使用 accessReviewInactiveUsersQueryScope 资源并指定具有值#microsoft.graph.accessReviewInactiveUsersQueryScope的 @odata.type 属性。 此评审中不包括动态组和可分配角色的组。

示例 6:查看分配给所有团队的所有来宾用户

以下示例将评审范围限定为指导作为来宾用户的所有团队的成员。

"instanceEnumerationScope": {
    "query": "/groups?$filter=(groupTypes/any(c:c eq 'Unified') and resourceProvisioningOptions/Any(x:x eq 'Team')')",
    "queryType": "MicrosoftGraph"
},
"scope": {
    "@odata.type": "#microsoft.graph.accessReviewQueryScope",
    "query": "./members/microsoft.graph.user/?$filter=(userType eq 'Guest')",
    "queryType": "MicrosoftGraph"
}

此外,由于此评审适用于所有已启用 Teams 的 Microsoft 365 组,因此请将 instanceEnumerationScope 配置为指定启用 Teams 的 Microsoft 365 组以进行评审。 此评审中不包括动态组和可分配角色的组。

此评审不包括具有共享频道的团队中的 B2B 直接连接用户。 若要在具有共享频道的团队中包括 B2B 直接连接用户,请参阅 示例 11:查看分配给团队的所有用户,包括具有共享频道的团队中的 B2B 直接连接用户。

查看分配给所有 Teams 的所有非活动来宾用户

以下示例将评审范围限定为指导非活动来宾用户的所有团队的成员。

"instanceEnumerationScope": {
    "query": "/groups?$filter=(groupTypes/any(c:c eq 'Unified') and resourceProvisioningOptions/Any(x:x eq 'Team')')",
    "queryType": "MicrosoftGraph"
},
"scope": {
    "@odata.type": "#microsoft.graph.accessReviewInactiveUsersQueryScope",
    "query": "./members/microsoft.graph.user/?$filter=(userType eq 'Guest')",
    "queryType": "MicrosoftGraph",
    "inactiveDuration": "P30D"
}

此外,由于此评审适用于所有团队,因此请将 instanceEnumerationScope 属性配置为指定所有团队。 此评审中不包括动态组和可分配角色的组。

此评审不包括具有共享频道的团队中的 B2B 直接连接用户。 若要在具有共享频道的团队中包括 B2B 直接连接用户,请参阅 示例 11:查看分配给团队的所有用户,包括具有共享频道的团队中的 B2B 直接连接用户。


示例 7:查看权利管理访问包的所有分配

"scope": {
    "@odata.type": "#microsoft.graph.accessReviewQueryScope",
    "query": "/identityGovernance/entitlementManagement/accessPackageAssignments?$filter=(accessPackageId eq '{package id}' and assignmentPolicyId eq '{id}')",
    "queryType": "MicrosoftGraph"
}

示例 8:查看分配给特权角色的所有服务主体

"scope": {
    "@odata.type": "#microsoft.graph.accessReviewQueryScope",
    "query": "/roleManagement/directory/roleAssignmentScheduleInstances?$expand=principal&$filter=(isof(principal,'microsoft.graph.servicePrincipal') and roleDefinitionId eq '{role ID}')",
    "queryType": "MicrosoftGraph"
}

示例 9:查看分配给特权角色的所有用户

查看分配给特权角色的所有用户 (包含的所有活动和符合条件的分配)
"scope": {
    "@odata.type": "#microsoft.graph.accessReviewQueryScope",
    "query": "/roleManagement/directory/roleDefinitions/{role ID}",
    "queryType": "MicrosoftGraph"
}
查看具有特权角色的合格分配的所有用户
"scope": {
    "@odata.type": "#microsoft.graph.accessReviewQueryScope",
    "query": "/roleManagement/directory/roleEligibilityScheduleInstances?$expand=principal&$filter=(isof(principal,'microsoft.graph.user') and roleDefinitionId eq '{role ID}')",
    "queryType": "MicrosoftGraph"
}
查看具有特权角色的活动分配的所有用户
"scope": {
    "@odata.type": "#microsoft.graph.accessReviewQueryScope",
    "query": "/roleManagement/directory/roleAssignmentScheduleInstances?$expand=principal&$filter=(assignmentType eq 'Assigned' and isof(principal,'microsoft.graph.user') and roleDefinitionId eq '{role ID}')",
    "queryType": "MicrosoftGraph"
}

使用 principalResourceMembershipsScope 配置范围

principalResourceMembershipsScope 公开 principalScopes 和 resourceScopes 属性,以支持 accessReviewScheduleDefinition 对象范围的更多定制配置选项。 这些功能包括查看多个主体或主体组对多个资源的访问权限。

示例 10:查看分配给所有组的所有非活动来宾用户

以下示例将评审范围限定到非活动来宾用户的所有组的成员。 当来宾用户的非活动期为访问评审实例开始日期的 30 天时,将被视为非活动用户。

"scope": {
    "@odata.type": "#microsoft.graph.principalResourceMembershipsScope",
    "principalScopes": [
        {
            "@odata.type": "#microsoft.graph.accessReviewInactiveUsersQueryScope",
            "query": "/users?$filter=(userType eq 'Guest')",
            "queryType": "MicrosoftGraph",
            "inactiveDuration": "P30D"
        }
    ],
    "resourceScopes": [
        {
            "@odata.type": "#microsoft.graph.accessReviewQueryScope",
            "query": "/groups",
            "queryType": "MicrosoftGraph"
        }
    ]
}

示例 11:查看分配给团队的所有用户,包括具有共享频道的团队中的 B2B 直接连接用户

在此示例中,访问评审范围是团队成员或分配到团队内共享频道的所有用户。 这些成员包括内部用户、直接和可传递用户、B2B 协作用户和 B2B 直接连接用户。

"scope": {
    "@odata.type": "#microsoft.graph.principalResourceMembershipsScope",
    "principalScopes": [
        {
            "@odata.type": "#microsoft.graph.accessReviewQueryScope",
            "query": "/users",
            "queryType": "MicrosoftGraph",
            "queryRoot": null
        }
    ],
    "resourceScopes": [
        {
            "@odata.type": "#microsoft.graph.accessReviewQueryScope",
            "query": "/groups/{groupId}/transitiveMembers/microsoft.graph.user",
            "queryType": "MicrosoftGraph",
            "queryRoot": null
        },
        {
            "@odata.type": "#microsoft.graph.accessReviewQueryScope",
            "query": "/teams/{groupId}/channels?$filter=(membershipType eq 'shared')",
            "queryType": "MicrosoftGraph",
            "queryRoot": null
        }
    ]
}

若要查看共享通道中的 B2B 直接连接用户和团队,必须在 resourceScopes 对象中指定/teams/{groupId}/channels?$filter=(membershipType eq 'shared')查询 模式。 所有团队 评审(例如 示例 6)不会在共享通道中包含 B2B 直接连接用户和团队。

Note: B2B 直接连接用户和团队的访问评审仅在单阶段访问评审中受支持,而在多阶段访问评审中不受支持。

示例 12:查看分配给目录角色的所有来宾用户

"scope": {
    "@odata.type": "#microsoft.graph.principalResourceMembershipsScope",
    "principalScopes": [
        {
            "@odata.type": "#microsoft.graph.accessReviewQueryScope",
            "query": "/users?$filter=(userType eq 'Guest')",
            "queryType": "MicrosoftGraph"
        }
    ],
    "resourceScopes": [
        {
            "@odata.type": "#microsoft.graph.accessReviewQueryScope",
            "query": "/roleManagement/directory/roleDefinitions/{role id}",
            "queryType": "MicrosoftGraph"
        }
    ]
}

后续步骤

历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 zhusijia26)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Microsoft Graph 中文文档历史快照
适用范围
历史中文快照 2023-02-03;详见原文产品版本;文档日期 未标明
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。