访问控制 Cluster（AccessControl）

Cluster ID: 0x001F  |  所在 Endpoint: 固定在 Endpoint 0（根端点）

AccessControl 是 Matter 设备的权限管理中枢 —— 决定了「谁」可以对「哪些资源」执行「什么操作」。 每台 Matter 设备都必须在 Endpoint 0 上实现此 Cluster。 它没有命令（Command），所有配置通过直接写入 ACL 属性完成。

属性详解

AccessControl Cluster 的属性分为两组：ACL 数据（可读写的权限配置）和容量限制（只读的设备能力上限）。 点击下方汇总表中的属性 ID 可跳转到对应的详细说明。

ACL 数据（0x0000, 0x0001）

权限条目和扩展数据，这是 AccessControl 的核心可写属性。

↑ 返回属性列表

容量限制（0x0002 ~ 0x0004）

只读属性，描述设备对 ACL 条目的容量上限。写入 ACL 前应先读取这些值，避免超出设备能力。

↑ 返回属性列表

访问限制（0x0005, 0x0006）— MNGD 特性

Access Restriction List（ARL）是 MNGD（Managed Device）特性引入的高级功能， 允许设备制造商限制某些资源的访问权限，即使 ACL 允许也不行。 普通设备通常不实现此特性。

↑ 返回属性列表

结构体详解

AccessControlEntryStruct —— 权限条目

ACL 的核心数据结构。每条记录定义了一组主体（谁）在一组目标（哪些资源）上拥有的权限级别。

AccessControlTargetStruct —— 访问目标

定义 ACL 条目允许访问的具体资源范围。三个字段中至少指定一个，未指定的字段表示不限制。

AccessControlExtensionStruct —— 扩展数据

厂商自定义的扩展结构，需要启用 EXTS 特性。标准 Matter 开发中很少用到。

枚举类型

AccessControlEntryPrivilegeEnum —— 权限级别

定义 ACL 条目授予的权限等级。权限是包含关系 —— 高级别权限自动包含低级别权限的所有能力。 例如 Operate 包含 View 的能力，Administer 包含所有能力。

AccessControlEntryAuthModeEnum —— 认证方式

指定 ACL 条目匹配的认证方式。不同认证方式决定了 Subjects 字段中 ID 的含义。

事件（Events）

AccessControl Cluster 通过事件记录 ACL 的变更历史。每次写入 ACL 或 Extension 属性时， 设备都会生成对应的事件。这些事件对安全审计和故障排查非常重要。

Feature 位图

AccessControl Cluster 通过 FeatureMap（0xFFFC）声明设备支持的扩展能力：

大多数消费级设备的 FeatureMap 为 0x0000（不启用任何特性）。 EXTS 用于有自定义权限需求的厂商设备，MNGD 用于云平台管理的设备。

示例数据

一台典型智能灯在 Commissioning 完成并添加了一条用户权限后的 AccessControl Cluster 读取结果：

{
  // --- ACL 权限条目（列表，每个 Fabric 独立维护）---
  "0x0000": [                    // ACL — AccessControlEntryStruct 列表
    {
      "privilege": 5,            // Administer（管理员）
      "authMode": 2,             // CASE 认证
      "subjects": [112233],      // 绑定到 Commissioner Node ID
      "targets": null,           // null = 可访问所有 Endpoint 和 Cluster
      "fabricIndex": 1
    },
    {
      "privilege": 3,            // Operate（操作权限）
      "authMode": 2,             // CASE 认证
      "subjects": null,          // null = 同 Fabric 下所有节点
      "targets": [               // 限定可访问的范围
        { "cluster": null, "endpoint": 1, "deviceType": null }
      ],
      "fabricIndex": 1
    }
  ],

  // --- 容量限制 ---
  "0x0002": 4,                   // SubjectsPerAccessControlEntry = 4
  "0x0003": 3,                   // TargetsPerAccessControlEntry = 3
  "0x0004": 4                    // AccessControlEntriesPerFabric = 4
}

常见场景