Cloud Custodian Azure 实战:用正则筛选 Entra ID 管理岗位用户(azure.entraid-user)
Cloud Custodian Azure 实战:用正则筛选 Entra ID 管理岗位用户(azure.entraid-user)
本文基于 Cloud Custodian 官方 Azure 示例 adminusersbyjobtitle-identity.rst,讲解如何通过 azure.entraid-user 资源配合 value 过滤器与 regex 操作符,从 Microsoft Entra ID(原 Azure AD)中精准定位职位(jobTitle)包含 "Admin" 的用户。读完本文,你将掌握 Entra ID 用户资源的数据来源、正则匹配在 value 过滤器中的底层实现,以及如何把该策略扩展为一条可落地的高权限账号审计流程。
策略总览:按职位识别潜在高权限用户
jobTitle 是 Entra ID 用户目录中用于描述岗位职责的字段,虽然它本身不直接代表权限级别,但职位中包含 "Admin"、"Administrator" 的用户往往承担着较高管理职责,是安全审计的重点关注对象。原始示例提供了一条非常简洁的策略:
policies:
- name: admin-users-by-job-title
resource: azure.entraid-user
description: |
Find users with administrative job titles.
This policy helps identify users who may have elevated privileges
based on their job title field.
filters:
- type: value
key: accountEnabled
value: true
- type: value
key: jobTitle
value: ".*[Aa]dmin.*"
op: regex
该策略由两个过滤条件串联(AND 关系):
- 账号启用过滤:
accountEnabled: true,仅保留启用状态的用户,排除已禁用账号的干扰; - 职位正则过滤:对
jobTitle字段执行正则.*[Aa]dmin.*,只要职位字符串任意位置出现Admin或admin(不区分大小写)即命中,例如 "System Administrator"、"Admin Assistant"、"Database admin" 都会被匹配。
value 过滤器与 regex 操作符的底层实现
操作符分派机制
策略中的 type: value 对应 Cloud Custodian 核心包中的 ValueFilter,其实现位于 c7n/filters/core.py。ValueFilter 根据 op 字段把比较操作分派到一组预定义的函数:
| 操作符 | 函数 | 语义 |
|---|---|---|
regex |
regex_match |
正则匹配(不区分大小写) |
regex-case |
regex_case_sensitive_match |
正则匹配(区分大小写) |
eq |
默认值 | 相等比较 |
in / ni |
operator_in / operator_ni |
成员/非成员判断 |
glob |
glob_match |
通配符匹配 |
操作符表定义在 c7n/filters/core.py 附近,ValueFilter 的完整操作符集合远比上述多,regex 只是其中一种。当 op 省略时,ValueFilter 默认使用 eq。
regex 匹配的实际语义
regex 操作符对应的实现为 regex_match:
def regex_match(value, regex):
if not isinstance(value, str):
return False
# Note python 2.5+ internally cache regex
# would be nice to use re2
return bool(re.match(regex, value, flags=re.IGNORECASE))
从源码可以提炼出三个关键行为,直接决定你的正则写法:
- 非字符串直接判负:若
jobTitle字段缺失或为None,regex_match返回False,用户被过滤掉——即"职位字段缺失"的用户不会命中本策略; - 使用
re.match而非re.search:re.match从字符串起始位置开始匹配,因此原示例特意用.*前缀把匹配锚点前移,确保Admin出现在职位字符串中部(如 "System Administrator")时也能命中;若省略.*[Aa]dmin.*中的前缀,则只匹配以 "Admin" 开头的职位; - 自带
re.IGNORECASE标志:即使不写[Aa],re.match内部也会忽略大小写,因此"admin"、"ADMIN"、"Administrator"均可命中;示例中的[Aa]dmin写法属于显式冗余,但作为防御性表达并无问题。
如果你想严格区分大小写,可改用 op: regex-case,其对应实现 regex_case_sensitive_match 不再传入 IGNORECASE 标志。
azure.entraid-user 资源:数据从哪来
资源注册与 Graph API 枚举
azure.entraid-user 由 tools/c7n_azure/c7n_azure/resources/entraid_user.py 中的 EntraIDUser 类提供,注册方式为 @resources.register('entraid-user')(见该文件第 21 行),并在 resource_map.py 中完成类型映射。
与多数 Azure 资源走 ARM 管理平面不同,EntraIDUser 继承自 GraphResourceManager(位于 tools/c7n_azure/c7n_azure/graph_utils.py),数据来自 Microsoft Graph API。资源类型定义(resource_type 类)中声明的关键元数据如下:
enum_spec = ('users', 'list', None):枚举全部用户走 Graph 的users端点;id字段为id,name字段为displayName;default_report_fields:displayName、userPrincipalName、mail、accountEnabled、userType、createdDateTime、lastSignInDateTime、id;permissions:需要User.Read.All、UserAuthenticationMethod.Read.All、IdentityRiskyUser.Read.All、GroupMember.Read.All等 Graph 权限(权限不足时get_graph_resources会记录 403 日志并返回空列表)。
为什么 jobTitle 可被 value 过滤器读取
在 get_graph_resources 方法(entraid_user.py)中,资源枚举通过 $select 显式请求字段:
select_fields = [
'id', 'displayName', 'userPrincipalName', 'mail',
'accountEnabled', 'createdDateTime', 'jobTitle', 'department', 'userType'
]
endpoint = f"users?$select={','.join(select_fields)}"
jobTitle 与 department 都在 $select 列表中,因此每条用户记录都会携带这两个字段,value 过滤器才能对它们执行正则匹配。这正是本策略能够正常工作的前提——若字段未在枚举阶段被请求,key: jobTitle 将取到空值并被 regex_match 判负。
增强字段与既有审计能力
augment 方法(entraid_user.py)还会为每条用户附加三个计算字段,可在 value 过滤器中直接引用:
c7n:LastSignInDays:距上次登录的天数,从未登录返回 999;c7n:IsHighPrivileged:基于userPrincipalName、displayName、jobTitle的启发式标记(源码注释明确其为占位实现,后续可用目录角色检查增强);c7n:PasswordAge:密码使用天数。
结合这些字段,你可以把本策略从"发现"升级为"分诊":
policies:
- name: admin-users-by-job-title-audit
resource: azure.entraid-user
description: |
Enrich admin-title users with last sign-in and password age context,
flagging dormant administrative accounts.
filters:
- type: value
key: accountEnabled
value: true
- type: value
key: jobTitle
value: ".*[Aa]dmin.*"
op: regex
- type: value
key: c7n:LastSignInDays
value: 90
op: greater-than
该扩展策略在前述基础上追加"超过 90 天未登录"条件,用于发现"挂着管理头衔但长期无人使用"的高风险闲置账号。
测试证据:jobTitle 过滤的验证方式
仓库测试套件对 azure.entraid-user 的职位过滤行为有直接覆盖。在 tests_azure/tests_resources/test_entraid.py 中:
- 测试夹具构造了
jobTitle分别为'Administrator'、'User'、'System Administrator'、'Developer'等用户数据(见该文件约第 70、79、464、486、497 行); - 约第 3893 行与第 3914 行出现了
{'type': 'value', 'key': 'jobTitle', 'value': 'Administrator'}形式的过滤器配置,验证了基于职位的 value 过滤在真实策略管线中的行为。
这些测试表明:jobTitle 作为 Graph 返回的用户属性,可以稳定地被 value 过滤器消费,且测试数据同时覆盖了"管理员职位"与"普通职位"两类,确保过滤器不会误伤。运行测试可参考仓库测试规范执行,例如:
# 在 tools/c7n_azure 目录下
python -m pytest tests_azure/tests_resources/test_entraid.py -k jobtitle
与其他 Identity 示例组合:构建完整用户审计
本策略是 docs/source/azure/examples/index.rst 中 Identity 分类下的一环,同类示例还包括:
- admingroupmembers-identity.rst:按管理员组成员身份筛选用户,与职位筛选互为补充(组成员关系是真实权限,职位是名义职责);
- usersbydepartment-identity.rst:按
department字段筛选用户,可复用本策略的$select字段与正则模式; - disabledusers-identity.rst、enabledusers-identity.rst:账号启用状态审计;
- comprehensiveuseraudit-identity.rst:综合用户审计;
- userswithmfa-identity.rst:MFA 合规检查。
例如,将职位正则与组过滤结合,可从"名义管理岗"与"实际管理组"两个维度交叉确认高权限账号:
policies:
- name: admin-title-or-group-members
resource: azure.entraid-user
filters:
- type: value
key: accountEnabled
value: true
- or:
- type: value
key: jobTitle
value: ".*[Aa]dmin.*"
op: regex
- type: group-membership
groups: ['Global Administrators', 'User Administrators']
match: any
其中 group-membership 过滤器定义于 entraid_user.py,通过 Graph 的 users/{id}/transitiveMemberOf 端点查询传递组成员关系,需要 GroupMember.Read.All 权限。
运行与输出
策略文件就绪后,按 Cloud Custodian 标准流程运行:
# 安装 c7n_azure 包后(例如 pip install c7n_azure),执行
custodian run -c admin-users-by-job-title.yml --output-dir . --region 'name=all'
运行前请确认:
- 凭据具备
User.Read.All权限(见 entraid_user.py 的 permissions 定义),否则资源枚举返回空集; - 执行环境的 Azure 订阅/租户配置正确,Cloud Custodian 会通过 Azure SDK 自动完成 Graph 会话初始化(相关逻辑见 tools/c7n_azure/c7n_azure/session.py)。
执行结果默认输出为 JSON 资源列表,每条命中记录包含 displayName、userPrincipalName、jobTitle、accountEnabled 等字段,可直接用于生成报表或接入后续的 disable、require-mfa 等动作(注册于 entraid_user.py)。
小结
通过 azure.entraid-user + value 过滤器 + regex 操作符,Cloud Custodian 能够以声明式 YAML 完成"按职位识别管理岗用户"这一身份治理场景。理解 regex_match 的 re.match 起始锚定与内置大小写忽略语义,是写出正确正则的关键;而 jobTitle 之所以可过滤,源于 entraid_user.py 在 Graph $select 阶段对用户字段的显式请求。以此策略为起点,可进一步组合 group-membership、last-sign-in、risk-level 等过滤器与 disable、require-mfa 动作,沉淀为完整的 Entra ID 高权限账号持续审计方案。