使用 Azure AD 访问评审 API ,可以以编程方式查看用户、服务主体或组对 Azure AD 资源的访问权限。
主要审阅者配置在访问评审 accessReviewScheduleDefinition 资源的 审阅者 属性中。 此外,还可以使用 fallbackReviewers 属性指定回退审阅者。 创建自审 (时不需要这些属性,用户会在其中查看自己的访问权限) 。
若要配置审阅者和回退审阅者,请设置 accessReviewReviewerScope 的 查询、queryRoot 和 queryType 属性的值。 有关这些属性的说明,请参阅 accessReviewReviewerScope 资源类型。
示例 1:自我审阅
"reviewers": []
若要配置自审阅,请勿指定 审阅者 属性,或向该属性提供空对象。
如果相应的访问评审 范围 面向具有共享通道的 B2B 直接连接用户和团队,则将分配团队所有者来评审 B2B 直接连接用户的访问权限。
示例 2:特定用户作为审阅者
"reviewers": [
{
"query": "/users/{userId}",
"queryType": "MicrosoftGraph"
}
]
示例 3:组成员作为审阅者
"reviewers": [
{
"query": "/groups/{groupId}/transitiveMembers",
"queryType": "MicrosoftGraph"
}
]
示例 4:组所有者作为审阅者
当访问评审的范围限定到组时,例如, 示例 1:查看分配给组的所有用户, 示例 2:查看分配给组的所有来宾用户, 以及示例 3:查看分配给组的所有用户和组。
"reviewers": [
{
"query": "/groups/{groupId}/owners",
"queryType": "MicrosoftGraph"
}
]
当访问评审的范围限定到组并仅将特定国家/地区的组所有者分配为审阅者时:
"reviewers": [
{
"query": "/groups/{groupId}/owners?$filter=microsoft.graph.user/userType eq 'Member' and microsoft.graph.user/country eq 'USA'",
"type": "MicrosoftGraph”
}
]
当访问评审范围限定到 所有 组时,例如示 例 4:查看分配给所有 Microsoft 365 组的所有用户, 示例 5:查看分配给所有 Microsoft 365 组的所有来宾用户, 以及示例 6:查看分配给所有团队的所有来宾用户。
"reviewers": [
{
"query": "./owners",
"queryType": "MicrosoftGraph"
}
]
示例 5:人员经理作为审阅者
"reviewers": [
{
"query": "./manager",
"queryType": "MicrosoftGraph",
"queryRoot": "decisions"
}
]
因为./manager是相对查询,所以指定具有值decisions的 queryRoot 属性。
如果相应的访问评审 范围 面向具有共享通道的 B2B 直接连接用户和团队,则将分配团队所有者来评审 B2B 直接连接用户的访问权限。
示例 6:应用程序所有者作为审阅者
"reviewers": [
{
"query": "/servicePrincipals/{servicePrincipalId}/owners",
"queryType": "MicrosoftGraph"
}
]
后续步骤
- 配置访问评审定义的范围
- 试用教程 ,了解如何使用访问评审 API 来评审对 Azure AD 资源的访问权限
- 创建访问评审
历史资料。此文对应 2023-02-03 的中文文档快照,适用产品版本和命令行为以原文为准。
来源与署名:Microsoft 和文档贡献者(原始作者元数据 zhusijia26)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。
