跳到主要内容

3. SCIM 核心设备 Schema (SCIM Core Device Schema)

核心设备 schema 提供 Device 资源的最小表示. 它只包含任意设备可能需要的属性, 并且只有一个属性是必需的. 该 schema 使用以下 schema URI 标识:

urn:ietf:params:scim:schemas:core:2.0:Device

核心设备 schema 定义以下属性.

3.1. 单值属性 (Singular Attributes)​

displayName: 字符串, 为设备提供人类可读名称. 它旨在显示给最终用户, 并应适合该用途. 该属性不是必需的, 且不区分大小写. 它可以被修改, 并且应该默认返回. 此属性没有唯一性约束.

active: 可变的布尔值, 且为必需属性. 如果设置为 true, 表示该设备预期处于可运行状态. 尝试控制或访问该值设置为 false 的设备可能会失败. 例如, 当与 Non-Internet-Connected Physical Components (NIPC) [NIPC] 结合使用时, 控制应用程序发送给设备控制器的命令 (如 connect, disconnect 和 subscribe) 将被控制器拒绝.

mudUrl: 字符串, 表示与此设备关联的 Manufacturer Usage Description (MUD) 文件 URL. 该属性是可选的, 可变的, 并且默认返回. 如果存在, 可以按 [RFC8520] 所述使用此属性. mudUrl 值区分大小写, 且不唯一.

groups: 可选的只读复杂对象, 表示组成员关系. 其形式与 [RFC7643] 第 4.1.2 节定义的形式完全相同.

     +=============+=======+=====+=======+=========+========+========+
     | Attribute   | Multi | Req | Case  | Mutable | Return | Unique |
     |             | Value |     | Exact |         |        |        |
     +=============+=======+=====+=======+=========+========+========+
     | displayName | F     | F   | F     | RW      | Def    | None   |
     +-------------+-------+-----+-------+---------+--------+--------+
     | active      | F     | T   | F     | RW      | Def    | None   |
     +-------------+-------+-----+-------+---------+--------+--------+
     | mudUrl      | F     | F   | T     | RW      | Def    | None   |
     +-------------+-------+-----+-------+---------+--------+--------+
     | groups      | T     | F   | T     | RO      | Def    | n/a    |
     +-------------+-------+-----+-------+---------+--------+--------+

            表 1: Device Schema 属性的特征

   图例:  Req = Required, T = True, F = False, RO = ReadOnly,
          RW = ReadWrite, Def = Default

示例:

{
           "schemas": ["urn:ietf:params:scim:schemas:core:2.0:Device"],
           "id": "e9e30dba-f08f-4109-8486-d5c6a3316111",
           "displayName": "BLE Heart Monitor",
           "active": true,
           "meta": {
             "resourceType": "Device",
         "created": "2022-01-23T04:56:22Z",
             "lastModified": "2022-05-13T04:42:34Z",
             "version": "W\/\"a330bc54f0671c9\"",
             "location": "https://example.com/v2/Devices/e9e30dba-f08f-\
                                                 4109-8486-d5c6a3316111"
           }
}

图 3: Core Device 示例条目.

最后于 更新