The Group Key Management cluster (0x003F) is a Matter cluster that Manages cryptographic keys used for secure group communication.. It defines 6 commands and 4 attributes and is mandatory for 1 device type.
Group Key Management 0x003F
Manages cryptographic keys used for secure group communication.
Spec History
This cluster's ClusterRevision across the Matter releases it has shipped in. Click a version to inspect the cluster as it existed in that release.
Attributes 4
Commands 6
Features 2
| Code | Name | Type | Flags |
|---|---|---|---|
| 0x0000 | GroupKeyMap | array | Writable write: manage |
| 0x0001 | GroupTable | array | |
| 0x0002 |
MaxGroupsPerFabric
default 0
|
int16u | |
| 0x0003 |
MaxGroupKeysPerFabric
min 1 · default 1
|
int16u |
| Code | Name | Direction | Parameters |
|---|---|---|---|
| 0x00 |
KeySetWrite
invoke: administer
This command is used by Administrators to set the state of a given Group Key Set, including atomically updating the state of all epoch keys.
|
client→server |
GroupKeySet: GroupKeySetStruct |
| 0x01 |
KeySetRead
invoke: administer
This command is used by Administrators to read the state of a given Group Key Set.
|
client→server |
GroupKeySetID: int16u |
| 0x02 |
KeySetReadResponse
This command SHALL be generated in response to the KeySetRead command, if a valid Group Key Set was found.
|
server→client |
GroupKeySet: GroupKeySetStruct |
| 0x03 |
KeySetRemove
invoke: administer
This command is used by Administrators to remove all state of a given Group Key Set.
|
client→server |
GroupKeySetID: int16u |
| 0x04 |
KeySetReadAllIndices
invoke: administer
This command is used by Administrators to query a list of all Group Key Sets associated with the accessing fabric.
|
client→server | None |
| 0x05 |
KeySetReadAllIndicesResponse
This command SHALL be generated in response to KeySetReadAllIndices and it SHALL contain the list of _GroupKeySetID_ for all Group Key Sets associated with the scoped Fabric.
|
server→client |
GroupKeySetIDs: int16u |
CacheAndSync
(CS)
bit 0
The ability to support CacheAndSync security policy and MCSP
Groupcast
(GCAST)
bit 1
The device supports groups using the Groupcast cluster
Device Types Using This Cluster
Device types in the Matter spec that reference this cluster
Devices Implementing This Cluster
788 devices in the survey implement this cluster
Govee TV Light Bar
Shenzhen Qianyan Technology
Roomba
iRobot Corporation
Matterbridge Cover
Matterbridge
MG-AU06WLP-XX
MG
Philips Candle
Signify
Philips GU10
Signify
matter-thread-light
Smart Home
Smart Indoor Plug - Single outlet
Amazon Basics
Smart Plug Mini
Meross
Magic Cube WS01
Chengdu Energy Magic Cube
Roborock Robotic Vacuum Cleaner
Roborock
SMART MAT A60 TW 827 FR E27
LEDVANCE
Smart Wi-Fi Outdoor Plug
Tapo
Smart Light
Matter
Smart Button
HAOJAI
Dreame L40s Pro Ultra
Dreame
On-wall button controllers - 4 buttons MATTER
ELKO EP s.r.o
Govee Torchiere Floor Lamp
Shenzhen Qianyan Technology
Mill Wi-Fi Panel Heater
Mill International AS
Eve MotionBlinds
Eve Systems
Automatic Water Dispenser MoT
Matterbridge
Govee Outdoor S14 Bulb String Lights 2
Shenzhen Qianyan Technology
LIFX Downlight
LIFX
Switch unit with inputs for external buttons MATTER
ELKO EP s.r.o