7.6 Resource Type <symmKeyReg>_

The <symmKeyReg> resource shall represent a symmetric key that a source MAF Client or a source MEF Client has established with the MAF or MEF, respectively, for distributing to authorized Target MAF or MEF Clients and/or another MAF or MEF. The MAF or MEF Client provides a list of authorized Targets when the resource is created - the present document does not specify how the MAF or MEF associates the list with the resource. The MAF or MEF, in coordination with the identified administrating stakeholder (M2M SP or MTE), can modify the list of authorized Targets and the expirationTime.

The <symmKeyReg> resource shall contain no child resources.

The <symmKeyReg> resource shall contain the attributes specified in table 7.6-1.

Table 7.6-1: Attributes of <symmKeyReg> resource

Attributes of <symmKeyReg> Multiplicity RW /
RO /
WO Description

resourceType 1 RO See clause 9.6.1.3 of [1].

resourceID 1 RO See clause 9.6.1.3 of [1].

resourceName 1 RO See clause 9.6.1.3 of [1]. This value is used as the relative part of the identifier for the symmetric key in security protocols.

parentID 1 RO See clause 9.6.1.3 of [1].

creationTime 1 RO See clause 9.6.1.3 of [1].

labels 0..1 RW See clause 9.6.1.3 of [1].

expirationTime 1 WO See clause 9.6.1.3 of [1].

creator 1 RO See clause 9.6.1.3 of [1].

adminFQDN 1 WO FQDN of the administrating stakeholder (M2M SP or MTE) associated with this enrolment.

SUID 1 WO An SUID constraining the use of the symmetric key associated with this resource.

targetIDs 1 (L) RW List of AE-ID(s) and/or CSE-ID(s) and/or and/or Node-ID(s) identifying the AE(s) and/or CSE(s) and/or Node(s) authorized to retrieve the resource. Only the creator and administrating stakeholder (identified by adminFQDN) are authorized to access this attribute.

keyValue 1 WO The value of the key to be provided to the identifier targets. May be provided in the Create request or derived by the MAF or MEF Client and MAF or MEF from the TLS handshake parameters.

Attributes of <symmKeyReg>	Multiplicity	RW / RO / WO	Description
resourceType	1	RO	See clause 9.6.1.3 of [1].
resourceID	1	RO	See clause 9.6.1.3 of [1].
resourceName	1	RO	See clause 9.6.1.3 of [1]. This value is used as the relative part of the identifier for the symmetric key in security protocols.
parentID	1	RO	See clause 9.6.1.3 of [1].
creationTime	1	RO	See clause 9.6.1.3 of [1].
labels	0..1	RW	See clause 9.6.1.3 of [1].
expirationTime	1	WO	See clause 9.6.1.3 of [1].
creator	1	RO	See clause 9.6.1.3 of [1].
adminFQDN	1	WO	FQDN of the administrating stakeholder (M2M SP or MTE) associated with this enrolment.
SUID	1	WO	An SUID constraining the use of the symmetric key associated with this resource.
targetIDs	1 (L)	RW	List of AE-ID(s) and/or CSE-ID(s) and/or and/or Node-ID(s) identifying the AE(s) and/or CSE(s) and/or Node(s) authorized to retrieve the resource. Only the creator and administrating stakeholder (identified by adminFQDN) are authorized to access this attribute.
keyValue	1	WO	The value of the key to be provided to the identifier targets. May be provided in the Create request or derived by the MAF or MEF Client and MAF or MEF from the TLS handshake parameters.