Cloud Custodian Azure 实战:用正则筛选 Entra ID 管理岗位用户(azure.entraid-user)

原创2026-10-09 14:21:542,331 阅读
文章标签:云原生运维安全

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 关系):

  1. 账号启用过滤:accountEnabled: true,仅保留启用状态的用户,排除已禁用账号的干扰;
  2. 职位正则过滤:对 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))

从源码可以提炼出三个关键行为,直接决定你的正则写法:

  1. 非字符串直接判负:若 jobTitle 字段缺失或为 None,regex_match 返回 False,用户被过滤掉——即"职位字段缺失"的用户不会命中本策略;
  2. 使用 re.match 而非 re.search:re.match 从字符串起始位置开始匹配,因此原示例特意用 .* 前缀把匹配锚点前移,确保 Admin 出现在职位字符串中部(如 "System Administrator")时也能命中;若省略 .*[Aa]dmin.* 中的前缀,则只匹配以 "Admin" 开头的职位;
  3. 自带 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 分类下的一环,同类示例还包括:

例如,将职位正则与组过滤结合,可从"名义管理岗"与"实际管理组"两个维度交叉确认高权限账号:

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'

运行前请确认:

  1. 凭据具备 User.Read.All 权限(见 entraid_user.py 的 permissions 定义),否则资源枚举返回空集;
  2. 执行环境的 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 高权限账号持续审计方案。

登录后查看全文
cloud-custodian