Group Object Security for Constrained RESTful Environments (Group OSCORE)

Group Object Security for Constrained RESTful Environments (Group OSCORE) RISE AB

Isafjordsgatan 22 Kista 16440 Stockholm Sweden marco.tiloca@ri.se

Ericsson AB

Torshamnsgatan 23 Kista 16440 Stockholm Sweden goran.selander@ericsson.com

Ericsson AB

Torshamnsgatan 23 Kista 16440 Stockholm Sweden francesca.palombini@ericsson.com

Ericsson AB

Torshamnsgatan 23 Kista 16440 Stockholm Sweden john.mattsson@ericsson.com

RISE AB

Isafjordsgatan 22 Kista 16440 Stockholm Sweden rikard.hoglund@ri.se

Applications CoRE Working Group Internet-Draft This document defines the security protocol Group Object Security for Constrained RESTful Environments (Group OSCORE), providing end-to-end security of messages exchanged with the Constrained Application Protocol (CoAP) between members of a group, e.g., sent over IP multicast. In particular, the described protocol defines how OSCORE is used in a group communication setting to provide source authentication for CoAP group requests, sent by a client to multiple servers, and for protection of the corresponding CoAP responses. Group OSCORE also defines a pairwise mode where each member of the group can efficiently derive a symmetric pairwise key with each other member of the group for pairwise OSCORE communication. Group OSCORE can be used between endpoints communicating with CoAP or CoAP-mappable HTTP. About This Document Status information for this document may be found at . Discussion of this document takes place on the Constrained RESTful Environments (core) Working Group mailing list (), which is archived at . Subscribe at . Source for this draft and an issue tracker can be found at .

Introduction The Constrained Application Protocol (CoAP) is a web transfer protocol specifically designed for constrained devices and networks . Group communication for CoAP addresses use cases where deployed devices benefit from a group communication model, for example to reduce latencies, improve performance, and reduce bandwidth utilization. Use cases include lighting control, integrated building control, software and firmware updates, parameter and configuration updates, commissioning of constrained networks, and emergency multicast (see ). Group communication for CoAP mainly uses UDP/IP multicast as the underlying data transport. Object Security for Constrained RESTful Environments (OSCORE) describes a security protocol based on the exchange of protected CoAP messages. OSCORE builds on CBOR Object Signing and Encryption (COSE) and provides end-to-end encryption, integrity, replay protection, and binding of response to request between a sender and a recipient, independent of the transport layer also in the presence of intermediaries. To this end, a CoAP message is protected by including its payload (if any), certain options, and header fields into a COSE object, which is conveyed within the CoAP payload and the CoAP OSCORE Option of the protected message, thereby replacing those message fields with an authenticated and encrypted object. This document defines Group OSCORE, a security protocol for group communication with CoAP and for CoAP-mappable HTTP requests and responses, providing the same end-to-end security properties as OSCORE also in the case where requests have multiple recipients. In particular, the described protocol defines how OSCORE is used in a group communication setting to provide source authentication for group requests sent by a client to multiple servers, and for protection of the corresponding responses. Group OSCORE also defines a pairwise mode where each member of the group can efficiently derive a symmetric pairwise key with each other member of the group for pairwise-protected OSCORE communication. Just like OSCORE, Group OSCORE is independent of the transport layer and works wherever CoAP does. As with OSCORE, it is possible to combine Group OSCORE with communication security on other layers. One example is the use of transport layer security, such as DTLS , between one client and one proxy, or between one proxy and one server. This prevents observers from accessing addressing information conveyed in CoAP options that would not be protected by Group OSCORE, but would be protected by DTLS. These options include Uri-Host, Uri-Port, and Proxy-Uri. Note that DTLS does not define how to secure messages sent over IP multicast and cannot be used for end-to-end protection over a proxy. Group OSCORE is also intended to work with OSCORE-capable proxies thereby enabling, for example, nested OSCORE operations with OSCORE-protected communication between a CoAP client and a proxy, carrying messages that are additionally protected with Group OSCORE between the CoAP client and the target CoAP servers. Group OSCORE defines two modes of operation that can be used independently or together:

In the group mode, Group OSCORE requests and responses are digitally signed with the private key of the sender and the signature is embedded in the protected CoAP message. The group mode supports all COSE signature algorithms as well as signature verification by intermediaries. This mode is defined in .
In the pairwise mode, two group members exchange OSCORE requests and responses (typically) over unicast, and the messages are protected with symmetric keys not known by the other group members. These symmetric keys are derived from Diffie-Hellman shared secrets, calculated with the asymmetric keys of the sender and recipient, allowing for shorter integrity tags and therefore lower message overhead. This mode is defined in .

Both modes provide source authentication of CoAP messages. The application decides what mode to use, potentially on a per-message basis. Such decisions can be based, for instance, on pre-configured policies or dynamic assessing of the target recipient and/or resource, among other things. One important case is when requests are protected in group mode, and responses in pairwise mode. Since such responses convey shorter integrity tags instead of bigger, full-fledged signatures, this significantly reduces the message overhead in case of many responses to one request. A special deployment of Group OSCORE consists in using the pairwise mode only. For example, consider the case of a constrained-node network with a large number of CoAP endpoints and the objective to establish secure communication between any pair of endpoints with a small provisioning effort and message overhead. Since the total number of security associations that needs to be established grows with the square of the number of endpoints, it is desirable to restrict the amount of secret keying material provided to each endpoint. Moreover, a key establishment protocol would need to be executed for each security association. One solution to this issue is to deploy Group OSCORE, with the endpoints being part of a group, and to use the pairwise mode. This solution has the benefit of providing a single shared secret, while distributing only the public keys of group members or a subset of those. After that, a CoAP endpoint can locally derive the OSCORE Security Context for the other endpoint in the group, and protect CoAP communications with very low overhead . In some circumstances, Group OSCORE messages may be transported in HTTP, e.g., when they are protected with the pairwise mode and target a single recipient, or when they are protected with the group mode and target multiple CoAP recipients through cross-protocol translators such as HTTP-to-CoAP proxies . The use of Group OSCORE with HTTP is as defined for OSCORE in .

Terminology The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be interpreted as described in BCP 14 when, and only when, they appear in all capitals, as shown here. Readers are expected to be familiar with the terms and concepts described in CoAP , including "endpoint", "client", "server", "sender", and "recipient"; group communication for CoAP ; Observe ; Concise Binary Object Representation (CBOR) ; Concise Data Definition Language (CDDL) ; COSE and related countersignatures . Readers are also expected to be familiar with the terms and concepts for protection and processing of CoAP messages through OSCORE, such as "Security Context" and "Master Secret", defined in . Terminology for constrained environments, such as "constrained device" and "constrained-node network", is defined in . This document refers also to the following terminology.

Keying material: data that is necessary to establish and maintain secure communication among endpoints. This includes, for instance, keys and IVs .
Authentication credential: information associated with an entity, including that entity's public key and parameters associated with the public key. Examples of formats of authentication credentials are CBOR Web Tokens (CWTs) and CWT Claims Sets (CCSs) , X.509 certificates , and C509 certificates . Further details about authentication credentials are provided in .
Group: a set of endpoints that share group keying material and security parameters (Common Context, see ). That is, unless otherwise specified, the term group used in this document refers to a "security group" (see ), not to be confused with "CoAP group" or "application group".
Group Manager: an entity responsible for a group, required neither to be an actual group member nor to take part in the group communication. The operations of the Group Manager are defined in and its responsibilities are listed in .
Silent server: a member of a group that performs only group mode processing on incoming requests and never sends responses protected with Group OSCORE. For CoAP group communications, requests are normally sent without necessarily expecting a response. A silent server may send unprotected responses, as error responses reporting a Group OSCORE error.
Group Identifier (Gid): identifier assigned to the group, unique within the set of groups of a given Group Manager. The Gid value changes every time the group is rekeyed (see ).
Birth Gid: with respect to a group member, the Gid obtained by that group member upon (re-)joining the group.
Key Generation Number: an integer value identifying the current version of the keying material used in a group.
Source authentication: evidence that a received message in the group originated from a specific identified group member. This also provides assurance that the message was not tampered with by anyone, be it a different legitimate group member or an endpoint which is not a group member.
Group request: a CoAP request message sent by a client in the group to servers in that group.
Long exchange: an exchange of messages associated with a request that is a group request and/or an Observe request . In either case, multiple responses can follow from the same server to the request associated with the long exchange, even if the request is not an Observe request (see Section 3.1.6 of ). The client terminates a long exchange when freeing up the CoAP Token value used for the associated request, for which no further responses will be accepted afterwards.

Security Context This document refers to a group as a set of endpoints sharing keying material and security parameters for executing the Group OSCORE protocol, see . All members of a group maintain a Security Context as defined in this section. How the Security Context is established by the group members is out of scope for this document, but if there is more than one Security Context applicable to a message, then the endpoints MUST be able to tell which Security Context was latest established. The management of information about the group (i.e., identifiers, OSCORE input parameters, and keying material) is described in terms of a Group Manager (see ). An endpoint of the group may use the group mode (see ), the pairwise mode (see ), or both, depending on the modes it supports and on the parameters of the Security Context. The Security Context of Group OSCORE extends the OSCORE Security Context defined in as follows (see ).

One Common Context, shared by all the endpoints in the group and extended as defined below.
- The new parameter Authentication Credential Format, specifying the format of authentication credentials used in the group (see ).
- The new parameter Group Manager Authentication Credential, specifying the authentication credential of the Group Manager responsible for the group (see ).
- For the group mode, the Common Context is extended with the following new parameters.
  - Group Encryption Algorithm, used for encrypting and decrypting messages protected in group mode (see ).
  - Signature Algorithm, used for computing and verifying the countersignature of messages protected in group mode (see ).
  - Signature Encryption Key, used for encrypting and decrypting the countersignature of messages protected in group mode (see ).
- For the pairwise mode, the Common Context is extended with a Pairwise Key Agreement Algorithm (see ) used for the agreement on a static-static Diffie-Hellman shared secret, from which pairwise keys are derived (see ).
The content of the Common Context is long-term, as it is meant to be stable once the Common Context is established.
One Sender Context, extended with the following new parameters.
- The endpoint's own private key used to sign messages protected in group mode (see ), or for deriving pairwise keys used with the pairwise mode (see ).
- The endpoint's own authentication credential containing its public key (see ).
- For the pairwise mode, the Sender Context is extended with the Pairwise Sender Keys associated with the other endpoints (see ).
Except for the Sender Sequence Number defined in , the content of the Sender Context is long-term, as it is meant to be stable once the Sender Context is established. If the endpoint is configured exclusively as a silent server (see ), then the Sender Context is omitted.
One Recipient Context for each other endpoint from which messages are received. It is not necessary to maintain Recipient Contexts associated with endpoints from which messages are not (expected to be) received.
- Each Recipient Context is extended with the authentication credential of the other endpoint, used to verify the signature of messages protected in group mode, or for deriving the pairwise keys used with the pairwise mode (see ).
- For the pairwise mode, each Recipient Context is extended with the Pairwise Recipient Key associated with the other endpoint (see ).
Except for the Replay Window defined in , the content of each Recipient Context is long-term, as it is meant to be stable once the Recipient Context is established.

The varying part of the Group OSCORE Security Context is composed of the Sender Sequence Number in the Sender Context and the Replay Windows in the different Recipient Contexts.

Additions to the OSCORE Security Context. The elements labeled with * and with ^ are relevant only for the group mode and only for the pairwise mode, respectively.

Common Context The following sections specify how the Common Context is used and extended compared to . The Common Context may be acquired from the Group Manager (see ).

AEAD Algorithm The AEAD Algorithm (see ) SHALL identify the COSE AEAD algorithm to use for encryption and decryption when messages are protected using the pairwise mode (see ). This algorithm MUST provide integrity protection. If this parameter is not set, the pairwise mode is not used in the group.

HKDF Algorithm The HKDF Algorithm (see ) SHALL identify the used key derivation function, which MUST be one of the HMAC-based HKDF algorithms defined for COSE (see ) and registered at .

ID Context The ID Context parameter (see Sections and of ) SHALL contain the Group Identifier (Gid) of the group. The choice of the Gid format is application specific. An example of specific formatting of the Gid is given in . The application needs to specify how to handle potential collisions between Gids (see ).

Common IV The Common IV parameter (see ) SHALL identify the Common IV used in the group. Differently from OSCORE, the length of the Common IV is determined as follows.

If only one among the AEAD Algorithm and the Group Encryption Algorithm is set (see and ), the length of the Common IV is the nonce length for the set algorithm.
If both the AEAD Algorithm and the Group Encryption Algorithm are set, the length of the Common IV is the greatest nonce length among those of the two algorithms.

Authentication Credential Format The new parameter Authentication Credential Format specifies the format of authentication credentials used in the group. Further details on authentication credentials are compiled in .

Group Manager Authentication Credential The new parameter Group Manager Authentication Credential specifies the authentication credential of the Group Manager, including the Group Manager's public key. The endpoint MUST achieve proof of possession of the corresponding private key. As an example, such proof of possession is possible to achieve during the join process provided by the realization of Group Manager specified in . Further details on the provisioning of the Group Manager's authentication credential to the group members are out of the scope of this document.

Group Encryption Algorithm The new parameter Group Encryption Algorithm identifies the algorithm to use for encryption and decryption, when messages are protected in group mode (see ). This algorithm MAY provide integrity protection. If this parameter is not set, the group mode is not used in the group. A non-authenticated algorithm MUST NOT be used as Group Encryption Algorithm if it is not possible to ensure uniqueness of the (key, nonce) pairs. This is the case, for instance, for A128CTR, A192CTR, and A256CTR . Instead, examples of non-authenticated algorithms that can be used as Group Encryption Algorithm are A128CBC, A192CBC, and A256CBC .

Signature Algorithm The new parameter Signature Algorithm identifies the digital signature algorithm used for computing and verifying the countersignature on the COSE object (see Sections and of ), when messages are protected in group mode (see ). If this parameter is not set, the group mode is not used in the group.

Signature Encryption Key The new parameter Signature Encryption Key specifies the encryption key for deriving a keystream to encrypt/decrypt a countersignature, when a message is protected in group mode (see ). The Signature Encryption Key is derived as defined for Sender/Recipient Keys in , with the following differences.

The 'id' element of the 'info' array is the empty byte string.
The 'alg_aead' element of the 'info' array specifies the Group Encryption Algorithm from the Common Context (see ), encoded as a CBOR integer or text string, consistently with the "Value" field in the "COSE Algorithms" Registry for this algorithm.
The 'type' element of the 'info' array is "SEKey". The label is an ASCII string and does not include a trailing NUL byte.
L and the 'L' element of the 'info' array are the size of the key for the Group Encryption Algorithm specified in the Common Context (see ), in bytes. While the obtained Signature Encryption Key is never used with the Group Encryption Algorithm, its length was chosen to obtain a matching level of security.

Pairwise Key Agreement Algorithm The new parameter Pairwise Key Agreement Algorithm identifies the elliptic curve Diffie-Hellman algorithm used to derive a static-static Diffie-Hellman shared secret, from which pairwise keys are derived (see ) to protect messages with the pairwise mode (see ). If this parameter is not set, the pairwise mode is not used in the group. If the HKDF Algorithm specified in the Common Context is "HKDF SHA-256" (identified as "HMAC 256/256"), then the Pairwise Key Agreement Algorithm is "ECDH-SS + HKDF-256" (COSE algorithm encoding: -27). If the HKDF Algorithm specified in the Common Context is "HKDF SHA-512" (identified as "HMAC 512/512"), then the Pairwise Key Agreement Algorithm is "ECDH-SS + HKDF-512" (COSE algorithm encoding: -28). Note that the HKDF Algorithm in the Common Context is denoted by the corresponding COSE HMAC Algorithm. For example, the HKDF Algorithm "HKDF SHA-256" is specified as the HMAC Algorithm "HMAC 256/256". More generally, if Pairwise Key Agreement Algorithm is set, it MUST identify a COSE algorithm such that: i) it performs a direct ECDH Static-Static key agreement; and ii) it indicates the use of the same HKDF Algorithm used in the group as specified in the Common Context.

Sender Context and Recipient Context The Sender ID SHALL be unique for each endpoint in a group with a certain triplet (Master Secret, Master Salt, Group Identifier), see . The maximum length of a Sender ID in bytes equals L minus 6, where L is determined as follows.

If only one among the AEAD Algorithm and the Group Encryption Algorithm is set (see and ), then L is the nonce length for the set algorithm.
If both the AEAD Algorithm and the Group Encryption Algorithm are set, then L is the smallest nonce length among those of the two algorithms.

With the exception of the authentication credential of the sender endpoint, a receiver endpoint can derive a complete Security Context from a received Group OSCORE message and the Common Context (see ). The authentication credentials in the Recipient Contexts can be retrieved from the Group Manager (see ) upon joining the group. An authentication credential can alternatively be acquired from the Group Manager at a later time, for example the first time a message is received from a particular endpoint in the group (see and ). For severely constrained devices, it may be infeasible to simultaneously handle the ongoing processing of a recently received message in parallel with the retrieval of the sender endpoint's authentication credential. Such devices can be configured to drop a received message for which there is no (complete) Recipient Context, and retrieve the sender endpoint's authentication credential in order to have it available to verify subsequent messages from that endpoint. An endpoint may admit a maximum number of Recipient Contexts for a same Security Context, e.g., due to memory limitations. After reaching that limit, the endpoint has to delete a current Recipient Context to install a new one (see ). It is up to the application to define policies for Recipient Contexts to delete.

Establishment of Security Context Parameters OSCORE defines the derivation of Sender Context and Recipient Context (specifically, of Sender/Recipient Keys) and of the Common IV, from a set of input parameters (see ). The derivation of Sender/Recipient Keys and of the Common IV defined in OSCORE applies also to Group OSCORE, with the following modifications compared to .

If Group Encryption Algorithm in the Common Context is set (see ), then the 'alg_aead' element of the 'info' array MUST specify Group Encryption Algorithm from the Common Context as a CBOR integer or text string, consistently with the "Value" field in the "COSE Algorithms" Registry for this algorithm.
If Group Encryption Algorithm in the Common Context is not set, then the 'alg_aead' element of the 'info' array MUST specify AEAD Algorithm from the Common Context (see ), as per .
When deriving the Common IV, the 'L' element of the 'info' array MUST specify the length of the Common IV in bytes, which is determined as defined in .

Authentication Credentials The authentication credentials of the endpoints in a group MUST be encoded according to the format used in the group, as indicated by the Authentication Credential Format parameter in the Common Context (see ). The authentication credential of the Group Manager SHOULD be encoded according to that same format, in order to limit the number of formats that the group members have to support and handle, unless it is infeasible or impractical for the particular realization or instance of the Group Manager to have an own authentication credential encoded in that same format. The format of authentication credentials MUST provide the public key and a comprehensive set of information related to the public key algorithm, including, e.g., the used elliptic curve (when applicable). If Group Encryption Algorithm in the Common Context is not set (see ), then the public key algorithm is the Pairwise Key Agreement Algorithm used in the group (see ), else the Signature Algorithm used in the group (see ). Examples of formats of authentication credentials are CBOR Web Tokens (CWTs) and CWT Claims Sets (CCSs) , X.509 certificates , and C509 certificates . If the authentication credentials are X.509 certificates or C509 certificates, the public key algorithm is fully described by the "algorithm" field of the "SubjectPublicKeyInfo" structure, and by the "subjectPublicKeyAlgorithm" element, respectively. If authentication credentials are CBOR Web Tokens (CWTs) or CWT Claims Sets (CCSs), the public key algorithm is fully described by a COSE key type and its "kty" and "crv" parameters. Authentication credentials are used to derive pairwise keys (see ) and are included in the external additional authenticated data when processing messages (see ). In both these cases, an endpoint in a group MUST treat authentication credentials as opaque data, i.e., by considering the same binary representation made available to other endpoints in the group, possibly through a designated trusted source (e.g., the Group Manager). For example, an X.509 certificate is provided as its direct binary serialization. If C509 certificates or CWTs are used as authentication credentials, each is provided as the binary serialization of a (possibly tagged) CBOR array. If CCSs are used as authentication credentials, each is provided as the binary serialization of a (possibly tagged) CBOR map. If authentication credentials are CWTs or CCSs, then the untagged CWT or CCS associated with an entity is stored in the Security Context and used as authentication credential for that entity. If authentication credentials are X.509 / C509 certificates, CWTs, or CCSs and the authentication credential associated with an entity is provided within a chain or a bag, then only the end-entity certificate or end-entity untagged CWT / CCS is stored in the Security Context and used as authentication credential for that entity. Storing whole authentication credentials rather than only a subset of those may result in a non-negligible storage overhead. On the other hand, it also ensures that authentication credentials are correctly used in a simple, flexible and non-error-prone way, also taking into account future credential formats as entirely new or extending existing ones. In particular, it is ensured that:

When used to derive pairwise keys and when included in the external additional authenticated data, authentication credentials can also specify possible metadata and parameters related to the included public key. Besides the public key algorithm, these comprise other relevant pieces of information such as key usage, expiration time, issuer, and subject.
All endpoints using another endpoint's authentication credential use exactly the same binary serialization, as obtained and distributed by the credential provider (e.g., the Group Manager), and as originally crafted by the credential issuer. In turn, this does not require to define and maintain canonical subsets of authentication credentials and their corresponding encoding, and spares endpoints from error-prone re-encoding operations.

Depending on the particular deployment and the intended group size, limiting the storage overhead of endpoints in a group can be an incentive for system/network administrators to prefer using a compact format of authentication credentials in the first place.

Pairwise Keys Certain signature schemes, such as EdDSA and ECDSA, support a secure combined signature and encryption scheme. This section specifies the derivation of "pairwise keys" for use in the pairwise mode defined in . Group OSCORE keys used for both signature and encryption MUST be used only for purposes related to Group OSCORE. These include the processing of messages with Group OSCORE, as well as performing proof of possession of private keys, e.g., upon joining a group through the Group Manager (see ).

Derivation of Pairwise Keys Using the Group OSCORE Security Context (see ), a group member can derive AEAD keys, to protect point-to-point communication between itself and each other endpoint X in the group by means of the AEAD Algorithm from the Common Context (see ). Analogous to the construction used by OSCORE in , the key derivation of these so-called pairwise keys relies on an HKDF algorithm and is as defined below: where:

The Pairwise Sender Key is the AEAD key for processing outgoing messages addressed to endpoint X.
The Pairwise Recipient Key is the AEAD key for processing incoming messages from endpoint X.
HKDF is the OSCORE HKDF algorithm from the Common Context.
The Sender Key from the Sender Context is used as salt in the HKDF, when deriving the Pairwise Sender Key.
The Recipient Key from the Recipient Context associated with endpoint X is used as salt in the HKDF, when deriving the Pairwise Recipient Key.
Sender Auth Cred is the endpoint's own authentication credential from the Sender Context.
Recipient Auth Cred is the endpoint X's authentication credential from the Recipient Context associated with the endpoint X.
The Shared Secret is computed as a cofactor Diffie-Hellman shared secret, see Section 5.7.1.2 of , using the Pairwise Key Agreement Algorithm. The endpoint uses its private key from the Sender Context and the other endpoint's public key included in Recipient Auth Cred. Note the requirement of validation of public keys in . In case the other endpoint's public key has COSE Key Type "EC2" (e.g., for the curves P-256, P-384, and P-521), then the public key is used as is. In case the other endpoint's public key has COSE Key Type "OKP" , the procedure is described in . In particular, if the public key is for X25519 or X448, it is used as is. Otherwise, if the public key is for the curve Ed25519 or Ed448, it is first mapped to Montgomery coordinates (see ).
IKM-Sender is the Input Keying Material (IKM) used in the HKDF for the derivation of the Pairwise Sender Key. IKM-Sender is the byte string concatenation of Sender Auth Cred, Recipient Auth Cred, and the Shared Secret. The authentication credentials Sender Auth Cred and Recipient Auth Cred are binary encoded as defined in .
IKM-Recipient is the Input Keying Material (IKM) used in the HKDF for the derivation of the Pairwise Recipient Key. IKM-Recipient is the byte string concatenation of Recipient Auth Cred, Sender Auth Cred, and the Shared Secret. The authentication credentials Recipient Auth Cred and Sender Auth Cred are binary encoded as defined in .
info and L are as defined in . That is:
- The 'alg_aead' element of the 'info' array takes the value of AEAD Algorithm from the Common Context (see ).
- L and the 'L' element of the 'info' array are the size of the key for the AEAD Algorithm from the Common Context (see ), in bytes.

If EdDSA asymmetric keys are used, the Edward coordinates are mapped to Montgomery coordinates using the maps defined in Sections and of , before using the X25519 or X448 function defined in . For further details, see . ECC asymmetric keys in Montgomery or Weierstrass form are used directly in the key agreement algorithm, without coordinate mapping. After establishing a partially or completely new Security Context (see and ), the old pairwise keys MUST be deleted. Since new Sender/Recipient Keys are derived from the new group keying material (see ), every group member MUST use the new Sender/Recipient Keys when deriving new pairwise keys. As long as any two group members preserve the same asymmetric keys, their Diffie-Hellman shared secret does not change across updates of the group keying material.

ECDH with Montgomery Coordinates

Curve25519 The y-coordinate of the other endpoint's Ed25519 public key is decoded as specified in . The Curve25519 u-coordinate is recovered as u = (1 + y) / (1 - y) (mod p) following the map in . Note that the mapping is not defined for y = 1, and that y = -1 maps to u = 0 which corresponds to the neutral group element and thus will result in a degenerate shared secret. Therefore, implementations MUST abort if the y-coordinate of the other endpoint's Ed25519 public key is 1 or -1 (mod p). The private signing key byte strings (i.e., the lower 32 bytes used for generating the public key, see Step 1 of ) are decoded the same way for signing in Ed25519 and scalar multiplication in X25519. Hence, in order to compute the shared secret, the endpoint applies the X25519 function to the Ed25519 private signing key byte string and the encoded u-coordinate byte string as specified in .

Curve448 The y-coordinate of the other endpoint's Ed448 public key is decoded as specified in . The Curve448 u-coordinate is recovered as u = y^2 * (d * y^2 - 1) / (y^2 - 1) (mod p) following the map from "edwards448" in , and also using the relation x^2 = (y^2 - 1)/(d * y^2 - 1) from the curve equation. Note that the mapping is not defined for y = 1 or -1. Therefore, implementations MUST abort if the y-coordinate of the peer endpoint's Ed448 public key is 1 or -1 (mod p). The private signing key byte strings (i.e., the lower 57 bytes used for generating the public key, see Step 1 of ) are decoded the same way for signing in Ed448 and scalar multiplication in X448. Hence, in order to compute the shared secret, the endpoint applies the X448 function to the Ed448 private signing key byte string and the encoded u-coordinate byte string as specified in .

Usage of Sequence Numbers When using any of its Pairwise Sender Keys, a sender endpoint including the 'Partial IV' parameter in the protected message MUST use the current fresh value of the Sender Sequence Number from its Sender Context (see ). That is, the same Sender Sequence Number space is used for all outgoing messages protected with Group OSCORE, thus limiting both storage and complexity. When combining communications with the group mode and the pairwise mode, this may result in the Partial IV values moving forward more often than when using OSCORE . This can happen when a client engages in frequent or long sequences of one-to-one exchanges with servers in the group, by sending requests over unicast. In turn, this contributes to a sooner exhaustion of the Sender Sequence Number space of the client, which would then require to take actions for deriving a new Sender Context before resuming communications in the group (see ).

Security Context for Pairwise Mode If the pairwise mode is supported, the Security Context additionally includes the Pairwise Key Agreement Algorithm and the pairwise keys, as described at the beginning of . The pairwise keys as well as the shared secrets used in their derivation (see ) may be stored in memory or recomputed every time they are needed. The shared secret changes only when a public/private key pair used for its derivation changes, which results in the pairwise keys also changing. Additionally, the pairwise keys change if the Sender ID changes or if a new Security Context is established for the group (see ). In order to optimize protocol performance, an endpoint may store the derived pairwise keys for easy retrieval. In the pairwise mode, the Sender Context includes the Pairwise Sender Keys to use with the other endpoints (see ). In order to identify the right key to use, the Pairwise Sender Key for endpoint X may be associated with the Recipient ID of endpoint X, as defined in the Recipient Context (i.e., the Sender ID from the point of view of endpoint X). In this way, the Recipient ID can be used to lookup for the right Pairwise Sender Key. This association may be implemented in different ways, e.g., by storing the pair (Recipient ID, Pairwise Sender Key) or linking a Pairwise Sender Key to a Recipient Context.

Update of Security Context It is RECOMMENDED that the long-term part of the Security Context is stored in non-volatile memory, or that it can otherwise be reliably accessed throughout the operation of the group, e.g., after device reboots. However, also data in the long-term part of the Security Context may need to be updated, for example due to scheduled key renewal, new or re-joining members in the group, or the fact that the endpoint changes Sender ID (see ). The data in the varying part of the Security Context are updated by the endpoint when executing the security protocol, but may be lost (see ) or become outdated by exhaustion of Sender Sequence Numbers (see ).

Loss of the Varying Part of the Security Context An endpoint may lose the varying part of its Security Context due to accidental events, e.g., if a reboot occurred in an unprepared way (see ) or due to a deliberately deleted Recipient Context (see ). If it is not feasible or practically possible to store and maintain up-to-date the varying part in non-volatile memory (e.g., due to limited number of write operations), the endpoint MUST be able to detect a loss of the varying part of the Security Context, to prevent the re-use of a nonce with the same key and to handle incoming replayed messages.

Accidental Loss of Sender Context and/or Recipient Contexts In case a loss of the Sender Context and/or of the Recipient Contexts is detected (e.g., if a reboot occurred in an unprepared way), the endpoint MUST NOT protect further messages using this Security Context, to avoid reusing a nonce with the same key. Before resuming its operations in the group, the endpoint MUST retrieve new Security Context parameters from the Group Manager (see ) and use them to derive a new Sender Context and Recipient Contexts (see ). Since the new Sender Context includes newly derived encryption keys, an endpoint will not reuse the same pair (key, nonce), even when it is a server using the Partial IV of (old re-injected) requests to build the nonce for protecting the responses. From then on, the endpoint MUST use the latest installed Sender Context to protect outgoing messages. Newly derived Recipient Contexts will have a Replay Window which is initialized as valid. If an endpoint is not configured as a silent server and is not able to establish an updated Sender Context, e.g., because of lack of connectivity with the Group Manager, then the endpoint MUST NOT protect further messages using the current Security Context and MUST NOT accept incoming messages from other group members, as it is currently unable to detect possible replays. If an endpoint is configured as a silent server and is not able to establish an updated Security Context, e.g., because of lack of connectivity with the Group Manager, then the endpoint MUST NOT accept incoming messages from other group members, as it is currently unable to detect possible replays.

Deliberately Deleted Recipient Contexts The Security Context may contain a large and variable number of Recipient Contexts. While Group OSCORE in itself does not establish a maximum number of Recipient Contexts, there are circumstances by which implementations might choose to discard Recipient Contexts or have to do so in accordance with enforced application policies. Such circumstances include the need to reclaim memory or other resources on the node hosting the endpoint, for example because the predefined maximum number of Recipient Contexts has been reached in the Security Context (see ). When a Recipient Context is deleted, this not only results in losing information about previously received messages from the corresponding other endpoint. It also results in the inability to be aware of the Security Contexts from which information has been lost. Therefore, if the Recipient Context is derived again from the same Security Context, there is a risk that a replayed message is not detected. If any Recipient Context associated with any peer has ever been deleted from the current Security Context, then the Replay Window of any new Recipient Context in this Security Context MUST be initialized as invalid. An exception applies when the deleted Recipient Context was created upon receiving a message and that message was not verified successfully (see , , , and ). Messages associated with a Recipient Context that has an invalid Replay Window MUST NOT be delivered to the application. If the endpoint receives a message to be processed with any such new Recipient Context whose Replay Window is invalid, then the endpoint MUST take one of the following courses of action.

The endpoint discards the message.
The endpoint follows the procedure based on the CoAP Echo Option and specified in , in order to establish a valid Replay Window. In particular, the endpoint MUST use its Partial IV when generating the nonce and MUST include the Partial IV in the response message conveying the Echo Option. If the endpoint supports the CoAP Echo Option, then it is RECOMMENDED to take this course of action.
The endpoint retrieves or waits for new Security Context parameters from the Group Manager and derives new Sender and Recipient Contexts, as defined in . In this case the Replay Windows of all Recipient Contexts become valid if they are not already. In particular, any invalid Replay Window is re-initialized as valid and with 0 as its current lower limit.

Exhaustion of Sender Sequence Number Space Since an endpoint increments its Sender Sequence Number for each new outgoing message including a Partial IV, an endpoint can eventually exhaust the Sender Sequence Number space. Implementations MUST be able to detect an exhaustion of Sender Sequence Number space, after the endpoint has consumed the largest usable value. This may be influenced by additional limitations besides the mere 40-bit size limit of the Partial IV. Upon exhausting the Sender Sequence Number space, the endpoint MUST NOT use this Security Context to protect further messages including a Partial IV. When approaching the exhaustion of the Sender Sequence Number space, the endpoint SHOULD inform the Group Manager, retrieve new Security Context parameters from the Group Manager (see ), and use them to derive a new Sender Context (see ). It is RECOMMENDED that the endpoint takes this course of action with some margin, i.e., well before exhausting the Sender Sequence Number space, in order to avoid a period of inability to protect messages including a Partial IV. From then on, the endpoint MUST use its latest installed Sender Context to protect outgoing messages.

Retrieving New Security Context Parameters The Group Manager can assist an endpoint with an incomplete Sender Context to retrieve missing data of the Security Context and thereby become fully operational in the group again. The two main options for the Group Manager are: i) assignment of a new Sender ID to the endpoint (see ); and ii) establishment of a new Security Context for the group (see ). The update of the Replay Window in each of the Recipient Contexts is discussed in . As group membership changes, or as group members get new Sender IDs (see ), so do the relevant Recipient IDs that the other endpoints need to keep track of. As a consequence, group members may end up retaining stale Recipient Contexts that are no longer useful to verify incoming secure messages. The Recipient ID ('kid') SHOULD NOT be considered as a persistent and reliable identifier of a group member. Such an indication can be achieved only by using that member's public key, when verifying countersignatures of received messages (in group mode), or when verifying messages integrity-protected with pairwise keying material derived from authentication credentials and associated asymmetric keys (in pairwise mode). Furthermore, applications MAY define policies to: i) delete (long-)unused Recipient Contexts and reduce the impact on storage space; as well as ii) check with the Group Manager that an authentication credential with the public key included therein is currently the one associated with a 'kid' value, after a number of consecutive failed verifications.

New Sender ID for the Endpoint The Group Manager may assign a new Sender ID to an endpoint, while leaving the Gid, Master Secret, and Master Salt unchanged in the group. In this case, the Group Manager assigns a Sender ID that has not been used in the group since the latest time when the current Gid value was assigned to the group (see ). Having retrieved the new Sender ID, and potentially other missing data for the long-term part of the Security Context, the endpoint can derive a new Sender Context (see ). When doing so, the endpoint resets the Sender Sequence Number in its Sender Context to 0, and derives a new Sender Key. This is in turn used to possibly derive new Pairwise Sender Keys. From then on, the endpoint MUST use its latest installed Sender Context to protect outgoing messages. The assignment of a new Sender ID may be the result of different processes. The endpoint may request a new Sender ID, e.g., because of the impending exhaustion of the Sender Sequence Number space (see ). An endpoint may request to re-join the group, e.g., because of losing the varying part of its Security Context (see ), and is provided with a new Sender ID together with the latest data for the long-term part of the Security Context. For the other group members, the Recipient Context corresponding to the old Sender ID becomes stale (see ).

New Security Context for the Group The Group Manager may establish a new Security Context for the group (see ). The Group Manager does not necessarily establish a new Security Context for the group if one member has an outdated Security Context (see ), unless that was already planned or required for other reasons. All the group members need to acquire new Security Context parameters from the Group Manager. Once having acquired new Security Context parameters, each group member performs the following actions.

From then on, it MUST NOT use the current Security Context to start processing new messages for the considered group.
It completes any ongoing message processing for the considered group.
It derives and installs a new Security Context. In particular:
- It re-derives the keying material stored in its Sender Context and Recipient Contexts (see ). The Master Salt used for the re-derivations is the updated Master Salt parameter if provided by the Group Manager, or the empty byte string otherwise.
- It resets its Sender Sequence Number in its Sender Context to 0.
- It re-initializes the Replay Window of each Recipient Context as valid and with 0 as its current lower limit.
- For each long exchange where it is a client and that it wants to keep active, it sets the Response Number of each associated server as not initialized (see ).

From then on, it can resume processing new messages for the considered group. In particular:

It MUST use its latest installed Sender Context to protect outgoing messages.
It SHOULD use only its latest installed Recipient Contexts to process incoming messages, unless application policies admit to temporarily retain and use the old, recent, Security Context (see ).

The distribution of a new Gid and Master Secret may result in temporarily misaligned Security Contexts among group members. In particular, this may result in a group member not being able to process messages received right after a new Gid and Master Secret have been distributed. A discussion on practical consequences and possible ways to address them, as well as on how to handle the old Security Context, is provided in .

The COSE Object Building on , this section defines how to use COSE to wrap and protect data in the original message. Like OSCORE, Group OSCORE uses the untagged COSE_Encrypt0 structure with an Authenticated Encryption with Associated Data (AEAD) algorithm. Unless otherwise specified, the following modifications to what is defined for OSCORE apply for both the group mode and the pairwise mode of Group OSCORE.

Countersignature When protecting a message in group mode, the 'unprotected' field MUST additionally include the following parameter:

Countersignature0 version 2: its value is set to the countersignature of the COSE object. The countersignature is computed by the sender as described in Sections and of , by using its private key and according to the Signature Algorithm in the Security Context. In particular, the Countersign_structure contains the context text string "CounterSignature0", the external_aad as defined in of this document, and the ciphertext of the COSE object as payload.

Clarifications on Using a Countersignature The literature commonly refers to a countersignature as a signature computed by an entity A over a document already protected by a different entity B. However, the COSE_Countersignature0 structure belongs to the set of abbreviated countersignatures defined in Sections and of , which were designed primarily to deal with the problem of encrypted group messaging, but where it is required to know who originated the message. Since the parameters for computing or verifying the abbreviated countersignature generated by A are provided by the same context used to describe the security processing performed by B and to be countersigned, these structures are applicable also when the two entities A and B are actually the same one, like the sender of a Group OSCORE message protected in group mode.

The 'kid' and 'kid context' parameters The value of the 'kid' parameter in the 'unprotected' field of response messages MUST be set to the Sender ID of the endpoint transmitting the message, if the request was protected in group mode. That is, unlike in , the 'kid' parameter is always present in responses to a request that was protected in group mode. The value of the 'kid context' parameter in the 'unprotected' field of request messages MUST be set to the ID Context, i.e., the Group Identifier value (Gid) of the group. That is, unlike in , the 'kid context' parameter is always present in requests.

Nonce Computation The nonce is constructed like in OSCORE, with the difference that Step 4 in is replaced with:

and then XOR with X bytes from the Common IV's start, where X is the length in bytes of the nonce.

For example, if X = 7 and the Common IV is 0x00112233445566778899aabbcc (13 bytes), then the bytes to XOR are 0x00112233445566 (7 bytes). The constructed nonce is used both by the AEAD Algorithm (see ) and by the Group Encryption Algorithm (see ), independent of whether they are AEAD or plain encryption algorithms. Algorithms that do not use a nonce are not supported, as per .

Additional Authenticated Data The external_aad of the Additional Authenticated Data (AAD) is different compared to OSCORE and is defined in this section. The same external_aad structure is used in group mode and pairwise mode for encryption/decryption (see ), as well as in group mode for computing and verifying the countersignature (see Sections and of ). In particular, the external_aad includes also the Signature Algorithm, the Group Encryption Algorithm, the Pairwise Key Agreement Algorithm, the value of the 'kid context' in the COSE object of the request, the OSCORE Option of the protected message, the sender's authentication credential, and the Group Manager's authentication credential. The external_aad SHALL be a CBOR array wrapped in a bstr object as defined below, following the notation of :

external_aad Compared with , the aad_array has the following differences.

The 'algorithms' array is extended as follows. The parameter 'alg_aead' MUST be set to the CBOR simple value null (0xf6) if the parameter AEAD Algorithm is not set in the Common Context of the Security Context used (see ). Otherwise, regardless of whether the endpoint supports the pairwise mode or not, this parameter MUST specify AEAD Algorithm from the Common Context (see ) as per . Furthermore, the 'algorithms' array additionally includes:
- 'alg_group_enc', which specifies Group Encryption Algorithm from the Common Context of the Security Context used (see ). This parameter MUST be set to the CBOR simple value null (0xf6) if the parameter Group Encryption Algorithm in the Common Context is not set. Otherwise, regardless of whether the endpoint supports the group mode or not, this parameter MUST specify Group Encryption Algorithm as a CBOR integer or text string, consistently with the "Value" field in the "COSE Algorithms" Registry for this algorithm.
- 'alg_signature', which specifies Signature Algorithm from the Common Context of the Security Context used (see ). This parameter MUST be set to the CBOR simple value null (0xf6) if the parameter Signature Algorithm in the Common Context is not set. Otherwise, regardless of whether the endpoint supports the group mode or not, this parameter MUST specify Signature Algorithm as a CBOR integer or text string, consistently with the "Value" field in the "COSE Algorithms" Registry for this algorithm.
- 'alg_pairwise_key_agreement', which specifies Pairwise Key Agreement Algorithm from the Common Context of the Security Context used (see ). This parameter MUST be set to the CBOR simple value null (0xf6) if Pairwise Key Agreement Algorithm in the Common Context is not set. Otherwise, regardless of whether the endpoint supports the pairwise mode or not, this parameter MUST specify Pairwise Key Agreement Algorithm as a CBOR integer or text string, consistently with the "Value" field in the "COSE Algorithms" Registry for this algorithm.
The new element 'request_kid_context' contains the value of the 'kid context' in the COSE object of the request (see ). This enables endpoints to safely keep a long exchange active beyond a possible change of Gid (i.e., of ID Context), following a group rekeying (see ). In fact, it ensures that every response within a long exchange cryptographically matches with only one request (i.e., the request associated with that long exchange), rather than with multiple requests that were protected with different keying material but share the same 'request_kid' and 'request_piv' values.
The new element 'OSCORE_option', containing the value of the OSCORE Option present in the protected message, encoded as a binary string. This prevents the attack described in when using the group mode, as further explained in . Note for implementation: this construction requires the OSCORE Option of the message to be generated and finalized before computing the ciphertext of the COSE_Encrypt0 object (when using the group mode or the pairwise mode) and before calculating the countersignature (when using the group mode). Also, the aad_array needs to be large enough to contain the largest possible OSCORE Option.
The new element 'sender_cred', containing the sender's authentication credential. This parameter MUST be set to a CBOR byte string, which encodes the sender's authentication credential in its original binary representation made available to other endpoints in the group (see ).
The new element 'gm_cred', containing the Group Manager's authentication credential. This parameter MUST be set to a CBOR byte string, which encodes the Group Manager's authentication credential in its original binary representation made available to other endpoints in the group (see ). This prevents the attack described in .

OSCORE Header Compression Group OSCORE relies on a header compression mechanism similar to the one used by OSCORE and specified in . Examples are provided in .

Encoding of the OSCORE Option Value and Group OSCORE Payload The OSCORE header compression defined in is used for compactly encoding the COSE_Encrypt0 object specified in of this document, with the following differences.

When the Group OSCORE message is protected in group mode, the message payload SHALL encode the ciphertext of the COSE object, concatenated with the encrypted countersignature of the COSE object. That is:
- The plain, original countersignature of the COSE object, namely SIGNATURE, is specified in the "Countersignature0 version 2" parameter within the 'unprotected' field of the COSE object (see ).
- The encrypted countersignature, namely ENC_SIGNATURE, is computed as ENC_SIGNATURE = SIGNATURE XOR KEYSTREAM where KEYSTREAM is derived as per .
When the Group OSCORE message is protected in pairwise mode, the message payload SHALL encode the ciphertext of the COSE object.
This document defines the usage of the sixth least significant bit, called "Group Flag", in the first byte of the OSCORE Option containing the OSCORE flag bits. This flag bit is specified in .
The Group Flag MUST be set to 1 if the Group OSCORE message is protected using the group mode (see ).
The Group Flag MUST be set to 0 if the Group OSCORE message is protected using the pairwise mode (see ). The Group Flag MUST also be set to 0 for ordinary OSCORE messages processed according to .

Keystream Derivation for Countersignature Encryption The following defines how an endpoint derives the keystream KEYSTREAM, used to encrypt/decrypt the countersignature of an outgoing/incoming message M protected in group mode. The keystream SHALL be derived as follows, by using the HKDF Algorithm from the Common Context (see Section 3.2 of ), which consists of composing the HKDF-Extract and HKDF-Expand steps . KEYSTREAM = HKDF(salt, IKM, info, L) The input parameters of HKDF are as follows.

salt takes as value the Partial IV (PIV) used to protect M. Note that, if M is a response, salt takes as value either: i) the fresh Partial IV generated by the server and included in the response; or ii) the same Partial IV of the request generated by the client and not included in the response.
IKM is the Signature Encryption Key from the Common Context (see ).
info is the serialization of a CBOR array with the structure defined below, following the notation of :

where:

id is the Sender ID of the endpoint that generated PIV.
id_context is the ID Context (Gid) used when protecting M. Note that, in the case of group rekeying, a server might use a different Gid when protecting a response, compared to the Gid that it used to verify (that the client used to protect) the request, see .
type is the CBOR simple value true (0xf5) if M is a request, or the CBOR simple value false (0xf4) otherwise.
L is the size of the countersignature, as per Signature Algorithm from the Common Context (see ), in bytes.

Examples of Compressed COSE Objects This section covers a list of OSCORE Header Compression examples of Group OSCORE used in group mode (see ) or in pairwise mode (see ). The examples assume that the COSE_Encrypt0 object is set (which means the CoAP message and cryptographic material is known). Note that the examples do not include the full CoAP unprotected message or the full Security Context, but only the input necessary to the compression mechanism, i.e., the COSE_Encrypt0 object. The output is the compressed COSE object as defined in and divided into two parts, since the object is transported in two CoAP fields: OSCORE Option and payload. The examples assume that the plaintext (see ) is 6 bytes long, and that the AEAD tag is 8 bytes long, hence resulting in a ciphertext which is 14 bytes long. When using the group mode, the COSE_Countersignature0 byte string as described in is assumed to be 64 bytes long.

Examples in Group Mode Request with ciphertext = 0xaea0155667924dff8a24e4cb35b9, kid = 0x25, Partial IV = 5 and kid context = 0x44616c.

Before compression (96 bytes):

After compression (85 bytes):

Response with ciphertext = 0x60b035059d9ef5667c5a0710823b, kid = 0x52 and no Partial IV.

Before compression (88 bytes):

After compression (80 bytes):

Examples in Pairwise Mode Request with ciphertext = 0xaea0155667924dff8a24e4cb35b9, kid = 0x25, Partial IV = 5 and kid context = 0x44616c.

Before compression (29 bytes):

After compression (21 bytes):

Response with ciphertext = 0x60b035059d9ef5667c5a0710823b and no Partial IV.

Before compression (18 bytes):

After compression (14 bytes):

Message Binding, Sequence Numbers, Freshness, and Replay Protection Like OSCORE, Group OSCORE provides message binding of responses to requests, as well as uniqueness of (key, nonce) pairs (see Sections and of , respectively).

Supporting Multiple Responses in Long Exchanges For each of its ongoing long exchanges, a client maintains one Response Number for each different server. Then, separately for each server, the client uses the associated Response Number to perform ordering and replay protection of responses received from that server within that long exchange (see ). That is, the Response Number has the same purpose that the Notification Number has in OSCORE (see Section 4.1.3.5.2 of ), but a client uses it for handling any response from the associated server within a long exchange. Group OSCORE allows a long exchange to remain active indefinitely, even if the group is rekeyed (thus changing the ID Context) or the client obtains a new Sender ID. As defined in , this is achieved by the client and server(s) storing the 'kid' and 'kid context' used in the original request, throughout the whole duration of the long exchange. Upon leaving the group or before re-joining the group, a group member MUST terminate all the ongoing long exchanges that it has started in the group as a client. This frees up the CoAP Token associated with the corresponding request.

Freshness If the application requires freshness, e.g., according to time- or event-based policies (see ), a server can use the approach in as a variant of the Challenge-Response procedure based on the Echo Option before delivering request messages from a client to the application. Like in OSCORE , assuming an honest server, the message binding guarantees that a response is not older than the request it replies to. Therefore, building on , the following properties hold for Group OSCORE.

The freshness of a response can be assessed if it is received soon after the request. For responses within a long exchange, this assessment gets weaker with time. If such responses are Observe notifications , it is RECOMMENDED that the client regularly re-register the observation. If the request was neither a group request nor an Observe request, there is at most a single valid response and only from one, individually targeted server in the group. Thus, freshness can be assessed depending on when the request was sent.
It is not guaranteed that a misbehaving server did not create the response before receiving the request, i.e., Group OSCORE does not verify server aliveness.
For requests and responses, the received Partial IV allows a recipient to determine the relative order of requests or responses.

Replay Protection Like in OSCORE , the replay protection relies on the Partial IV of incoming messages. A server updates the Replay Window of its Recipient Contexts based on the Partial IV values in received request messages, which correspond to the Sender Sequence Numbers of the clients. Note that there can be large jumps in these Sender Sequence Number values, for example when a client exchanges unicast messages with other servers. The operation of validating the Partial IV and performing replay protection MUST be atomic. and describe the update of Replay Windows after the loss of data from the Security Context and the retrieving of new Security Context parameters. The protection from replay of requests is performed as per , separately for each client and by leveraging the Replay Window in the corresponding Recipient Context. The protection from replay of responses in a long exchange is performed as defined in of this document.

Replay Protection of Responses A client uses the method defined in this section in order to check whether a received response is a replay. This especially applies to responses received within a long exchange, during which multiple such responses can be received from the same server to the corresponding request. These include Observe notifications ; and non-notification responses as a reply to a group request, which the client can receive until the CoAP Token value associated with the group request is freed up (see Section 3.1.6 of ). When sending a response (both successful and error), a server MUST include its Sender Sequence Number as Partial IV in the response, except when sending the first response to the corresponding request, in which case the Partial IV in the response MAY be omitted. In order to protect against replay, the client SHALL maintain for each ongoing long exchange one Response Number for each different server. The Response Number is a non-negative integer containing the largest Partial IV of the responses received from that server during the long exchange, while using the same Security Context. Then, separately for each server, the client uses the associated Response Number to perform ordering and replay protection of the responses from that server during the long exchange, by comparing their Partial IVs with one another and against the Response Number. For every long exchange, the Response Number associated with a server is initialized to the Partial IV of the response from that server such that, within the long exchange, it is the first response from that server to include a Partial IV and to be successfully verified with the used Security Context. Note that, when a new Security Context is established in the group, the client sets the Response Number of each associated server as not initialized (see ), hence later responses within the same long exchange and protected with the new Security Context will result in a new initialization of Response Numbers. Furthermore, for every long exchange, a client MUST only accept at most one response without Partial IV from each server, and treat it as the oldest response from that server within that long exchange. During a long exchange, a client receiving a response containing a Partial IV SHALL compare the Partial IV with the Response Number associated with the replying server within that long exchange. The client MUST stop processing a response from a server, if that response has a Partial IV that has been previously received from that server during that long exchange, while using the same Security Context. Applications MAY decide that a client only processes responses within a long exchange if those have a greater Partial IV than the Response Number associated with the replying server within that long exchange. This limits the storage overhead on the client to maintaining one Response Number per replying server within the long exchange. Conversely, more permissive applications can allow clients to also process responses that have a smaller Partial IV than the Response Number associated with the replying server. For a client, the ability to detect previously received Partial IVs while admitting the processing of such responses comes at the cost of additional storage overhead, for which a reasonable bound has to be defined by the application. A possible way to achieve that relies on using a sliding Replay Window uniquely paired with the replying server within the long exchange, similarly to that used by a server for detecting replayed requests. If the verification of the response succeeds, and the received Partial IV (when included) was greater than the Response Number associated with the replying server, then the client SHALL overwrite that Response Number with the received Partial IV. As long as a server uses the same Security Context to protect its responses to the same request, the client MUST consider the response with the highest Partial IV as the freshest response from that server among those protected with that Security Context, regardless of the order of arrival. Within a long exchange, implementations need to make sure that a response without Partial IV is considered the oldest response from the replying server within that long exchange. The method defined in this section is not relevant for responses to requests that are neither group requests nor Observe requests. In fact, for each of such requests, there is at most one response and only from one individually targeted server in the group.

Message Reception Upon receiving a protected message, a recipient endpoint retrieves a Security Context as in . An endpoint MUST be able to distinguish between a Security Context to process OSCORE messages as in and a Group OSCORE Security Context to process Group OSCORE messages as defined in this document. The way to accomplish this distinction is implementation specific. For example, an endpoint can take into account the different structure of the Security Context defined in , e.g., based on the presence of Signature Algorithm and Pairwise Key Agreement Algorithm in the Common Context. Alternatively, at the cost of increasing storage, implementations can use an additional parameter in the Security Context, to explicitly mark that it is intended for processing Group OSCORE messages. If either of the following conditions holds, a recipient endpoint MUST discard the incoming protected message:

The Group Flag is set to 0 and the retrieved Security Context is associated with an OSCORE group, but the endpoint does not support the pairwise mode or any of the following parameters is not set in the Security Context: the AEAD Algorithm and the Pairwise Key Agreement Algorithm.
The Group Flag is set to 1 and the retrieved Security Context is associated with an OSCORE group, but the endpoint does not support the group mode or any of the following parameters is not set in the Security Context: the Group Encryption Algorithm and the Signature Algorithm.
The Group Flag is set to 1 but there is no Security Context associated with an OSCORE group. Future specifications may define how to process incoming messages protected with Security Contexts as in , when the Group Flag bit is set to 1.

Otherwise, if a Security Context associated with an OSCORE group is retrieved, the recipient endpoint processes the message with Group OSCORE, using the group mode (see ) if the Group Flag is set to 1, or the pairwise mode (see ) if the Group Flag is set to 0. Note that if the Group Flag is set to 0 and the recipient endpoint retrieves a Security Context which is valid to process the message but is not associated with an OSCORE group, then the message is processed according to .

Message Processing in Group Mode When using the group mode, messages are protected and processed as specified in with the modifications described in this section. The security objectives of the group mode are discussed in . The possible use of the group mode is indicated by the Group Manager as part of the group data provided to new group members when joining the group, according to which the parameters Group Encryption Algorithm and Signature Algorithm in the Security Context are set (see ). During all the steps of the message processing, an endpoint MUST use the same Security Context for the considered group. That is, an endpoint MUST NOT install a new Security Context for that group (see ) until the message processing is completed. The group mode SHOULD be used to protect group requests intended for multiple recipients or for the whole group. This applies to both requests directly addressed to multiple recipients, e.g., sent by the client over multicast, as well as requests sent by the client over unicast to a proxy that forwards them to the intended recipients over multicast . Exceptions where the requirement above is not fulfilled and the pairwise mode is used to protect group requests include: the efficient discovery of a server's address in the group (see ); or the enabling of simple constructions where a variation of the pairwise mode protects requests possibly intended to multiple servers, in such a way that the corresponding responses are effectively cacheable by intermediaries (e.g., see ). As per , group requests sent over multicast MUST be Non-confirmable, and thus are not retransmitted by the CoAP messaging layer. Instead, applications should store such outgoing messages for a predefined, sufficient amount of time, in order to correctly perform potential retransmissions at the application layer. If performed, these retransmissions are repetitions of previous protected messages, which the sender endpoint does not protect again with Group OSCORE. According to , responses to Non-confirmable group requests SHOULD also be Non-confirmable, but endpoints MUST be prepared to receive Confirmable responses in reply to a Non-confirmable group request. Confirmable group requests are acknowledged when sent over non-multicast transports, as specified in . Furthermore, endpoints in the group locally perform error handling and processing of invalid messages according to the same principles adopted in . In addition, a recipient MUST stop processing and reject any message that is malformed and that does not follow the format specified in of this document, or that is not cryptographically validated in a successful way as per the processing defined in and of this document. In either case, it is RECOMMENDED that a server does not send back any error message in reply to a received request if either of the following conditions holds:

The server is not able to identify whether the received request is a group request, i.e., as sent to all servers in the group.
The server identifies the received request as a group request.

This prevents servers from replying with multiple error messages to a client sending a group request, so avoiding the risk of flooding and possibly congesting the network.

Protecting the Request When using the group mode to protect a request, a client proceeds as described in with the following modifications.

In Step 2, the Additional Authenticated Data is modified as described in of this document.
In Step 4, the encryption of the COSE object is modified as described in of this document. The encoding of the compressed COSE object is modified as described in of this document. In particular, the Group Flag MUST be set to 1. The Group Encryption Algorithm from the Common Context MUST be used.
In Step 5, the countersignature is computed and the format of the OSCORE message is modified as described in and of this document. In particular, the payload of the Group OSCORE message includes also the encrypted countersignature.

In addition, the following applies when sending a request that establishes a long exchange.

If the client intends to keep the long exchange active beyond a possible change of Sender ID, the client MUST store the value of the 'kid' parameter from the request, and retain it until the long exchange is terminated. Even in case the client is individually rekeyed and receives a new Sender ID from the Group Manager (see ), the client MUST NOT update the stored 'kid' parameter value associated with the long exchange and the corresponding request.
If the client intends to keep the long exchange active beyond a possible change of ID Context following a group rekeying (see ), then the following applies.
- The client MUST store the value of the 'kid context' parameter from the request, and retain it until the long exchange is terminated. Upon establishing a new Security Context with a new Gid as ID Context (see ), the client MUST NOT update the stored 'kid context' parameter value associated with the long exchange and the corresponding request.
- The client MUST store an invariant identifier of the group, which is immutable even if the Security Context of the group is re-established. For example, this invariant identifier can be the "group name" in , where it is used for joining the group and retrieving the current group keying material from the Group Manager. After a group rekeying, the client might have missed both the rekeying messages and the servers' first responses that are protected with the new Security Context and include the new ID Context (Gid) in the 'kid context' parameter (see ). In such a case, while still not knowing the new ID Context (Gid) used in the group, the client is able to retrieve the current group keying material from the Group Manager, using the invariant identifier to unambiguously refer to the group.

Verifying the Request Upon receiving a protected request with the Group Flag set to 1, following the procedure in , a server proceeds as described in with the following modifications.

In Step 2, the decoding of the compressed COSE object follows of this document. In particular:
- If the server discards the request due to not retrieving a Security Context associated with the OSCORE group, the server MAY respond with a 4.01 (Unauthorized) error message. When doing so, the server MAY set an Outer Max-Age Option with value zero, and MAY include a descriptive string as diagnostic payload.
- If the received 'kid context' matches an existing ID Context (Gid) but the received 'kid' does not match any Recipient ID in this Security Context, then the server MAY create a new Recipient Context for this Recipient ID and initialize it according to , and also retrieve the authentication credential associated with the Recipient ID to be stored in the new Recipient Context. Such a configuration is application specific. If the application does not specify dynamic derivation of new Recipient Contexts, then the server SHALL stop processing the request.
In Step 4, the Additional Authenticated Data is modified as described in of this document.
In Step 6, the server also verifies the countersignature by using the public key from the client's authentication credential stored in the associated Recipient Context. In particular:
- If the server does not have the public key of the client yet, the server MUST stop processing the request and MAY respond with a 5.03 (Service Unavailable) response. The response MAY include a Max-Age Option, indicating to the client the number of seconds after which to retry. If the Max-Age Option is not present, specifies a default retry time of 60 seconds.
- The signature verification as defined below SHOULD be performed before decrypting the COSE object. An exception applies to implementations that cannot perform the two steps in this order. Those implementations MUST ensure that no access to the plaintext is possible before a successful signature verification and MUST prevent any possible leak of time-related information that can yield side-channel attacks.
- The server retrieves the encrypted countersignature ENC_SIGNATURE from the message payload, and computes the original countersignature SIGNATURE as SIGNATURE = ENC_SIGNATURE XOR KEYSTREAM where KEYSTREAM is derived as per .
- The server verifies the original countersignature SIGNATURE as described in Sections and of by using the client's public key and according to the Signature Algorithm in the Security Context. In particular, the Countersign_structure contains the context text string "CounterSignature0", the external_aad as defined in of this document, and the ciphertext of the COSE object as payload.
- If the signature verification fails, the server SHALL stop processing the request, SHALL NOT update the Replay Window, and MAY respond with a 4.00 (Bad Request) response. Such a response MAY include an Outer Max-Age Option with value zero, and its diagnostic payload MAY contain a string, which, if present, MUST be "Decryption failed" as if the decryption of the COSE object had failed.
- When decrypting the COSE object using the Recipient Key, the Group Encryption Algorithm from the Common Context MUST be used.
Additionally, if the used Recipient Context was created upon receiving this request and the message is not verified successfully, the server MAY delete that Recipient Context. When this behavior is specified by the application, it mitigates attacks that aim at overloading the server's storage. If the server deletes the used Recipient Context in this particular circumstance, then this deletion does not require the server to initialize as invalid the Replay Window of any new Recipient Context created later within the Security Context (see ).

A server SHOULD NOT process a request if the received Recipient ID ('kid') is equal to its own Sender ID in its own Sender Context. However, in some applications the server can prepare a request to be sent to itself (e.g., see ), in which case such requests would be expected. In addition, the following applies if the request establishes a long exchange and the server intends to reply with multiple responses.

The server MUST store the value of the 'kid' parameter from the request, and retain it until the last response has been sent. The server MUST NOT update the stored value of the 'kid' parameter associated with the request, even if the client is individually rekeyed and starts using a new Sender ID received from the Group Manager (see ).
The server MUST store the value of the 'kid context' parameter from the request, and retain it until the last response has been sent, i.e., beyond a possible change of ID Context following a group rekeying (see ). That is, upon establishing a new Security Context with a new Gid as ID Context (see ), the server MUST NOT update the stored value of a 'kid context' parameter associated with the request.

Protecting the Response When using the group mode to protect a response, a server proceeds as described in with the following modifications. Note that the server always protects a response with the Sender Context from its latest Security Context, and that establishing a new Security Context resets the Sender Sequence Number to 0 (see and ).

In Step 2, the Additional Authenticated Data is modified as described in of this document. In addition, the following applies if the server intends to reply with multiple responses within the long exchange established by the corresponding request.
- The server MUST use the stored value of the 'kid' parameter from the request (see ), as value for the 'request_kid' parameter in the external_aad (see ).
- The server MUST use the stored value of the 'kid context' parameter from the request (see ), as value for the 'request_kid_context' parameter in the external_aad (see ).
In Step 3, if either of the following conditions holds, the server MUST include its Sender Sequence Number as Partial IV in the response and use it to build the nonce to protect the response. This prevents the server from reusing the nonce from the request together with the same encryption key.
- The response is not the first response that the server sends to the request.
- The server is using a different Security Context for the response than the one that was used to verify the request (see ).
In Step 4, the encryption of the COSE object is modified as described in of this document. The encoding of the compressed COSE object is modified as described in of this document. In particular, the Group Flag MUST be set to 1. The Group Encryption Algorithm from the Common Context MUST be used. In addition, the following applies.
- If the server is using a different ID Context (Gid) for the response than the one that was used to verify the request (see ) and this is the first response from the server to that request, then the new ID Context MUST be included in the 'kid context' parameter of the response.
- The server may be replying to a request that was protected with an old Security Context. After completing the establishment of a new Security Context, the server MUST protect all the responses to that request with the Sender Context of the new Security Context. For each ongoing long exchange, the server can help the client to synchronize, by including also the 'kid context' parameter in responses following a group rekeying, with value set to the ID Context (Gid) of the new Security Context. If there is a known upper limit to the duration of a group rekeying, the server SHOULD include the 'kid context' parameter during that time. Otherwise, the server SHOULD include it until the Max-Age has expired for the last response sent before the installation of the new Security Context.
- The server can obtain a new Sender ID from the Group Manager when individually rekeyed (see ) or when re-joining the group. In such a case, the server can help the client to synchronize by including the 'kid' parameter in a response protected in group mode even when the request was protected in pairwise mode (see ). That is, when responding to a request protected in pairwise mode, the server SHOULD include the 'kid' parameter in a response protected in group mode, if it is replying to that client for the first time since the assignment of its new Sender ID.
In Step 5, the countersignature is computed and the format of the OSCORE message is modified as described in and of this document. In particular the payload of the Group OSCORE message includes also the encrypted countersignature (see ).

Verifying the Response Upon receiving a protected response with the Group Flag set to 1, following the procedure in , a client proceeds as described in with the modifications described in this section. Note that a client may receive a response protected with a Security Context different from the one used to protect the corresponding request, and that, upon the establishment of a new Security Context, the client re-initializes its Replay Windows in its Recipient Contexts (see ).

In Step 2, the decoding of the compressed COSE object is modified as described in of this document. In particular, a 'kid' may not be present if the response is a reply to a request protected in pairwise mode. In such a case, the client assumes the response 'kid' to be the Recipient ID for the server for which the request protected in pairwise mode was intended. If the response 'kid context' matches an existing ID Context (Gid) but the received/assumed 'kid' does not match any Recipient ID in this Security Context, then the client MAY create a new Recipient Context for this Recipient ID and initialize it according to , and also retrieve the authentication credential associated with the Recipient ID to be stored in the new Recipient Context. If the application does not specify dynamic derivation of new Recipient Contexts, then the client SHALL stop processing the response.
In Step 3, the Additional Authenticated Data is modified as described in of this document. In addition, the following applies if the client processes a response to a request within a long exchange.
- The client MUST use the stored value of the 'kid' parameter from the request (see ), as value for the 'request_kid' parameter in the external_aad (see ).
- The client MUST use the stored value of the 'kid context' parameter from the request (see ), as value for the 'request_kid_context' parameter in the external_aad (see ).
This ensures that, throughout a long exchange, the client can correctly verify the received responses, even if the client is individually rekeyed and starts using a new Sender ID received from the Group Manager (see ), as well as when it installs a new Security Context with a new ID Context (Gid) following a group rekeying (see ).
In Step 5, the client also verifies the countersignature by using the public key from the server's authentication credential stored in the associated Recipient Context. In particular:
- The signature verification as defined below SHOULD be performed before decrypting the COSE object. An exception applies to implementations that cannot perform the two steps in this order. Those implementations MUST ensure that no access to the plaintext is possible before a successful signature verification and MUST prevent any possible leak of time-related information that can yield side-channel attacks.
- The client retrieves the encrypted countersignature ENC_SIGNATURE from the message payload, and computes the original countersignature SIGNATURE as SIGNATURE = ENC_SIGNATURE XOR KEYSTREAM where KEYSTREAM is derived as per . The client verifies the original countersignature SIGNATURE.
- If the verification of the countersignature fails, the client: i) SHALL stop processing the response; and ii) SHALL NOT update the Response Number associated with the server.
- After a successful verification of the countersignature, the client performs also the following actions in case the request was protected in pairwise mode (see ).
  - If the 'kid' parameter is present in the response, the client checks whether this received 'kid' is equal to the expected 'kid', i.e., the known Recipient ID for the server for which the request was intended.
  - If the 'kid' parameter is not present in the response, the client checks whether the server that has sent the response is the same one for which the request was intended. This can be done by checking that the public key used to verify the countersignature of the response is equal to the public key included in the authentication credential Recipient Auth Cred, which was taken as input to derive the Pairwise Sender Key used for protecting the request (see ).
  In either case, if the client determines that the response has come from a different server than the expected one, then the client: i) SHALL discard the response and SHALL NOT deliver it to the application; ii) SHALL NOT update the Response Number associated with the server. Otherwise, the client hereafter considers the received 'kid' as the current Recipient ID for the server.
In Step 5, when decrypting the COSE object using the Recipient Key, the Group Encryption Algorithm from the Common Context MUST be used. In addition, the client performs the following actions if the response is received within a long exchange.
- The ordering and the replay protection of responses received from the server during the long exchange are performed as per of this document, by using the Response Number associated with that server within that long exchange. In case of unsuccessful decryption and verification of a response, the client SHALL NOT update the Response Number associated with the server.
- When receiving the first valid response from the server within the long exchange, the client MUST store the kid "kid1" of that server for that long exchange. If the 'kid' field is included in the OSCORE Option of the response, its value specifies "kid1". If the request was protected in pairwise mode (see ), the 'kid' field may not be present in the OSCORE Option of the response (see ). In this case, the client assumes "kid1" to be the Recipient ID for the server for which the request was intended.
- When receiving another valid response to the same request from the same server - which can be identified and recognized through the same public key used to verify the countersignature and included in the server's authentication credential - the client determines the kid "kid2" of the server as above for "kid1", and MUST check whether "kid2" is equal to the stored "kid1". If "kid1" and "kid2" are different, the client SHOULD NOT accept the response as valid to be delivered to the application, and SHOULD NOT update the Response Number associated with the server. Exceptions can apply as the client can retain the information required to order the responses, or if the client application does not require response ordering altogether. Servers MUST NOT rely on clients tolerating this, unless it was explicitly agreed on (e.g., as part of the group's setup).
Note that, if "kid2" is different from "kid1" and the 'kid' field is omitted from the response - which is possible if the request was protected in pairwise mode - then the client will compute a wrong keystream to decrypt the countersignature (i.e., by using "kid1" rather than "kid2" in the 'id' field of the 'info' array in ), thus subsequently failing to verify the countersignature and discarding the response. This ensures that the client remains able to correctly perform the ordering and replay protection of responses within a long exchange, even if the server legitimately starts using a new Sender ID, as received from the Group Manager when individually rekeyed (see ) or when re-joining the group.
In Step 8, if the used Recipient Context was created upon receiving this response and the message is not verified successfully, the client MAY delete that Recipient Context. When this behavior is specified by the application, it mitigates attacks that aim at overloading the client's storage. If the client deletes the used Recipient Context in this particular circumstance, then this deletion does not require the client to initialize as invalid the Replay Window of any new Recipient Context created later within the Security Context (see ).

External Signature Checkers When a message is protected in group mode, it is possible for designated external signature checkers to verify the countersignature of the message. For example, an external signature checker can be an intermediary gateway that intercepts messages protected in group mode and ensures that they reach the intended recipients only if it successfully verifies their countersignatures. Since they do not join a group as members, external signature checkers need to retrieve from the Group Manager the authentication credentials of group members and other selected group data, such as the current Signature Encryption Key (see ). describes how the Group Manager supports signature checkers. When receiving a message protected in group mode, a signature checker proceeds as follows.

The signature checker retrieves the encrypted countersignature ENC_SIGNATURE from the message payload, and computes the original countersignature SIGNATURE as SIGNATURE = ENC_SIGNATURE XOR KEYSTREAM where KEYSTREAM is derived as per .
The signature checker verifies the original countersignature SIGNATURE, by using the public key of the sender endpoint as included in that endpoint's authentication credential. The signature checker determines the right authentication credential based on the ID Context (Gid) and the Sender ID of the sender endpoint.

Note that the following applies when attempting to verify the countersignature of a response message.

The response may not include a Partial IV and/or an ID Context. In such a case, the signature checker considers the same values from the corresponding request, i.e., the request matching with the response by CoAP Token value.
The response may not include a Sender ID. This can happen when the response protected in group mode matches a request protected in pairwise mode (see ), with a case in point provided by . In such a case, the signature checker needs to use other means (e.g., source addressing information of the server endpoint) to identify the correct authentication credential including the public key to use for verifying the countersignature of the response.

The particular actions following a successful or unsuccessful verification of the countersignature are application specific and out of the scope of this document.

Message Processing in Pairwise Mode When using the pairwise mode of Group OSCORE, messages are protected and processed as in with the modifications described in this section. The security objectives of the pairwise mode are discussed in . The possible use of the pairwise mode is indicated by the Group Manager as part of the group data provided to new group members when joining the group, according to which the parameters AEAD Algorithm and Pairwise Key Agreement Algorithm in the Security Context are set (see ). The pairwise mode takes advantage of an existing Security Context to establish keying material shared exclusively with each other member. For encryption and decryption operations in pairwise mode, the AEAD Algorithm from the Common Context is used (see ). In order to use the pairwise mode in a group where the group mode is also used (i.e., Group Encryption Algorithm and Signature Algorithm in the Security Context are set), the signature scheme of the group mode MUST support a combined signature and encryption scheme. For example, this can rely on signing operations using ECDSA, and encryption operations using AES-CCM with keying material derived through ECDH. The pairwise mode does not support external verifiers of source authentication and message integrity like the group mode does, e.g., for external signature checkers (see ). An endpoint implementing only a silent server does not support the pairwise mode. Endpoints using the CoAP Echo Option in a group where the AEAD Algorithm and Pairwise Key Agreement Algorithm are set MUST support the pairwise mode. When using the challenge-response method defined in , this prevents the attack described in , which leverages requests sent over unicast to a single group member and protected in group mode. The pairwise mode cannot be used to protect messages intended for multiple recipients, as the keying material used for the pairwise mode is shared only between two endpoints. However, a sender can use the pairwise mode to protect a message sent to (but not intended for) multiple recipients, if interested in a response from only one of them. For instance, this is useful to support the address discovery service defined in , when a single 'kid' value is indicated in the payload of a request sent to multiple recipients, e.g., over multicast.

Pre-Conditions In order to protect an outgoing message in pairwise mode, the sender needs to know the authentication credential and the Recipient ID for the recipient endpoint, as stored in the Recipient Context associated with that endpoint (see ). Typically, the sender endpoint sends the message protected in pairwise mode over unicast, so that the message is delivered only to the intended recipient endpoint for which it is protected. This requires the sender to know the individual address of that recipient endpoint, which the sender may not know at any given point in time. For instance, right after having joined the group, a client may know the authentication credential and Recipient ID for a given server, but not the addressing information required to reach it with an individual, one-to-one request. In order to make addressing information of individual endpoints available, servers in the group MAY expose a resource to which a client can send a request targeting a set of servers, identified by their 'kid' values specified in the request payload, or implicitly if the request is sent in pairwise mode. Further details of such an interface are out of scope for this document.

Main Differences from OSCORE The pairwise mode protects messages between two members of a group, essentially following but with the following notable differences.

The 'kid' and 'kid context' parameters of the COSE object are used as defined in of this document.
The external_aad defined in of this document is used for the encryption and decryption process.
The Pairwise Sender/Recipient Keys used as Sender/Recipient keys are derived as defined in of this document.

Protecting the Request When using the pairwise mode to protect a request, a client SHALL proceed as described in with the differences summarized in of this document. Furthermore, when sending a request that establishes a long exchange, what is specified in of this document holds, with respect to storing the value of the 'kid' and 'kid context' parameters, and to storing an invariant identifier of the group.

Verifying the Request Upon receiving a protected request with the Group Flag set to 0, following the procedure in , a server SHALL proceed as described in with the differences summarized in of this document. The following differences also apply.

If the server discards the request due to not retrieving a Security Context associated with the OSCORE group or to not supporting the pairwise mode, the server MAY respond with a 4.01 (Unauthorized) error message or a 4.02 (Bad Option) error message, respectively. When doing so, the server MAY set an Outer Max-Age Option with value zero, and MAY include a descriptive string as diagnostic payload.
If a new Recipient Context is created for this Recipient ID, new Pairwise Sender/Recipient Keys are also derived (see ). The new Pairwise Sender/Recipient Keys are deleted if the Recipient Context is deleted as a result of the message not being successfully verified.
What is specified in of this document holds with respect to the following points.
- The possible, dynamic creation and configuration of a Recipient Context upon receiving the request.
- The possible deletion of a Recipient Context created upon receiving the request, in case the request is not verified successfully.
- The rule about processing the request where the received Recipient ID ('kid') is equal to the server's Sender ID.
- The storing of the value of the 'kid' and 'kid context' parameters from the request, if the server intends to reply with multiple responses within the long exchange established by the request.

Protecting the Response When using the pairwise mode to protect a response, a server SHALL proceed as described in with the differences summarized in of this document. The following differences also apply.

What is specified in of this document holds with respect to the following points.
- The protection of a response when using a different Security Context than the one used to verify the corresponding request (see ). That is, the server always protects a response with the Sender Context from its latest Security Context, and establishing a new Security Context resets the Sender Sequence Number to 0 (see and ).
- The use of the stored value of the 'kid' and 'kid context' parameters, if the server intends to reply with multiple responses within the long exchange established by the request.
- The rules for the inclusion of the server's Sender Sequence Number as Partial IV in a response, as used to build the nonce to protect the response.
- The rules for the inclusion of the ID Context (Gid) in the 'kid context' parameter of a response, if the ID Context used for the response differs from the one used to verify the request (see ), also for helping the client to synchronize.
- The rules for the inclusion of the Sender ID in the 'kid' parameter of a response to a request that was protected in pairwise mode, if the server has obtained a new Sender ID from the Group Manager when individually rekeyed (see ), thus helping the client to synchronize.

Verifying the Response Upon receiving a protected response with the Group Flag set to 0, following the procedure in , a client SHALL proceed as described in with the differences summarized in of this document. The following differences also apply.

The client may receive a response protected with a Security Context different from the one used to protect the corresponding request. Also, upon the establishment of a new Security Context, the client re-initializes its Replay Windows in its Recipient Contexts (see ).
The same as described in holds with respect to handling the 'kid' parameter of the response, when received as a reply to a request protected in pairwise mode. The client can also in this case check whether the replying server is the expected one, by relying on the server's public key. However, since the response is protected in pairwise mode, the public key is not used for verifying a countersignature as in . Instead, the expected server's authentication credential - namely Recipient Auth Cred and including the server's public key - was taken as input to derive the Pairwise Recipient Key used to decrypt and verify the response (see ).
If a new Recipient Context is created for this Recipient ID, new Pairwise Sender/Recipient Keys are also derived (see ). The new Pairwise Sender/Recipient Keys are deleted if the Recipient Context is deleted as a result of the message not being successfully verified.
What is specified in of this document holds with respect to the following points.
- The possible, dynamic creation and configuration of a Recipient Context upon receiving the response.
- The use of the stored value of the 'kid' and 'kid context' parameters, when processing a response received within a long exchange.
- The performing of ordering and replay protection for responses received within a long exchange.
- The possible deletion of a Recipient Context created upon receiving the response, in case the response is not verified successfully.

Challenge-Response Based Freshness and Replay Window Recovery This section describes how a server endpoint can verify freshness of a request by means of a challenge-response exchange with a client using the Echo Option for CoAP specified in . The same mechanism, with small alterations, is also used by the server when first processing a request using a Recipient Context whose Replay Window was initialized as invalid. If the application requires freshness, e.g., according to time- or event-based policies (see ), a server proceeds as described below upon receiving a request from a particular client for the first time. The server processes the message as described in this document, but, even if valid, does not deliver it to the application. Instead, the server replies to the client with a Group OSCORE protected 4.01 (Unauthorized) response message, including only the Echo Option and no diagnostic payload. The server MUST use its Partial IV when generating the nonce for protecting the response conveying the Echo Option, and MUST include the Partial IV in the response. The Echo Option value SHOULD NOT be reused; if it is reused, it MUST be highly unlikely to have been recently used with this client. Since this response is protected with the Security Context used in the group, the client will consider the response valid upon successfully decrypting and verifying it. The server stores the Echo Option value included in the response together with the pair (gid,kid), where 'gid' is the Group Identifier of the OSCORE group and 'kid' is the Sender ID of the client in the group. These are specified in the 'kid context' and 'kid' fields of the OSCORE Option of the request, respectively. After a group rekeying has been completed and a new Security Context has been established in the group, which results also in a new Group Identifier (see ), the server MUST delete all the stored Echo values associated with members of the group. After receiving a 4.01 (Unauthorized) response that includes an Echo Option and originates from a verified group member, a subsequent client request sent to that server and echoing the Echo Option value MUST be a message sent unicast to that server. If in the group the AEAD Algorithm and Pairwise Key Agreement Algorithm are set in the Security Context, the client MUST use the pairwise mode to protect the request, as per . Note that, as defined in , endpoints that are members of such a group and that use the Echo Option support the pairwise mode. In a group where the AEAD Algorithm and Pairwise Key Agreement Algorithm are not set, only the group mode can be used. Hence, requests including the Echo Option can be protected only with the Group Mode, with the caveat due to the risk for those requests to be redirected to a different server than the intended one, as discussed in . The client does not necessarily resend the same request, but can instead send a more recent one if the application permits it. This allows the client to not retain previously sent requests for full retransmission, unless the application explicitly requires otherwise. In either case, the client uses a fresh Sender Sequence Number value from its own Sender Context. If the client stores requests for possible retransmission with the Echo Option, it should not store a given request for longer than a preconfigured time interval. Note that the unicast request echoing the Echo Option is correctly treated and processed, since the 'kid context' field including the Group Identifier of the OSCORE group is still present in the OSCORE Option as part of the COSE object (see ). Upon receiving the unicast request including the Echo Option, the server performs the following verifications.

If the server does not store an Echo Option value for the pair (gid,kid), it considers: i) the time t1 when it has established the Security Context used to protect the received request; and ii) the time t2 when the request has been received. Since a valid request cannot be older than the Security Context used to protect it, the server verifies that (t2 - t1) is less than the largest amount of time acceptable to consider the request fresh.
If the server stores an Echo Option value for the pair (gid,kid) associated with that same client in the same group, the server verifies that the option value equals that same stored value previously sent to that client.

If the verifications above fail, the server MUST NOT process the request further and MAY send a 4.01 (Unauthorized) response including an Echo Option, hence performing a new challenge-response exchange. If the verifications above are successful, the server considers the Recipient Context associated with the sender client and proceeds as follows.

If the Replay Window is invalid, the steps below occur.
1. The server updates the Replay Window by marking as received the Sender Sequence Number from the latest received request. This becomes the lower limit of the Replay Window, while all the greater Sender Sequence Number values within the Replay Window are marked as not received.
2. The server makes the Replay Window valid, and accepts the request as fresh.
If the Replay Window is already valid, the server discards the verification result and accepts the request as fresh or treats it as a replay, according to the existing Replay Window.

A server should not deliver requests from a given client to the application until one valid request from that same client has been verified as fresh via an echoed Echo Option included therein. A server may perform the challenge-response described above at any time, e.g., after a device reboot occurred in an unprepared way. A client has to be ready to perform the challenge-response based on the Echo Option if a server starts it. Message freshness is further discussed in .

Implementation Compliance Like in , HKDF SHA-256 is the mandatory-to-implement HKDF. An endpoint may support only the group mode, or only the pairwise mode, or both. For endpoints that support the group mode, the following applies.

For endpoints that use authenticated encryption, the AEAD algorithm AES-CCM-16-64-128 defined in is mandatory to implement as Group Encryption Algorithm (see ).
For endpoints that use non-authenticated encryption, the algorithm A128CBC defined in is mandatory to implement as Group Encryption Algorithm (see ).
mandates that COSE libraries supporting either the AES-CTR or AES-CBC algorithm and accepting Additional Authenticated Data (AAD) as input must return an error if one of these non-AEAD content encryption algorithms is selected. In case the used Group Encryption Algorithm (see ) does not provide integrity protection, the following applies. When invoking the execution of the Group Encryption Algorithm, the Group OSCORE implementation MUST NOT provide any AAD to the COSE library, unless AAD is always expected as input. In the latter case, the AAD will not be protected by the Group Encryption Algorithm, which is unable to do so. If the used COSE library adheres to the mandate in , then a Group OSCORE implementation requires that the COSE library supports using the Group Encryption Algorithm without taking AAD as input.
For many constrained IoT devices, it is problematic to support more than one signature algorithm. The following applies with respect to the Signature Algorithm (see ). Less constrained endpoints MUST implement at least one of the following and SHOULD implement both: the EdDSA signature algorithm together with the elliptic curve Ed25519 ; the ECDSA signature algorithm together with the elliptic curve P-256. Constrained endpoints MUST implement at least one of the following and, if affordable, SHOULD implement both: the EdDSA signature algorithm together with the elliptic curve Ed25519 ; the ECDSA signature algorithm together with the elliptic curve P-256.
Endpoints that implement the ECDSA signature algorithm MAY use "deterministic ECDSA" as specified in . Pure deterministic elliptic-curve signature algorithms such as deterministic ECDSA and EdDSA have the advantage of not requiring access to a source of high-quality randomness. However, these signature algorithms have been shown vulnerable to some side-channel and fault injection attacks due to their determinism, which can result in extracting a device's private key. As suggested in , this can be addressed by combining both randomness and determinism .

For endpoints that support the pairwise mode, the following applies.

The AEAD algorithm AES-CCM-16-64-128 defined in is mandatory to implement as AEAD Algorithm (see ).
The ECDH-SS + HKDF-256 algorithm specified in is mandatory to implement as Pairwise Key Agreement Algorithm (see ).
The following applies with respect to ECDH curves. Less constrained endpoints MUST implement at least one of the following ECDH curves and SHOULD implement both: the X25519 curve ; the P-256 curve. Constrained endpoints MUST implement at least one of the following ECDH curves and, if affordable, SHOULD implement both: the X25519 curve ; the P-256 curve.

Constrained IoT devices may alternatively represent Montgomery curves and (twisted) Edwards curves in the short-Weierstrass form Wei25519, with which the algorithms ECDSA25519 and ECDH25519 can be used for signature operations and Diffie-Hellman secret calculation, respectively .

Web Linking The use of Group OSCORE or OSCORE MAY be indicated by a target "gosc" attribute in a web link to a resource, e.g., using a link-format document if the resource is accessible over CoAP. The "gosc" attribute is a hint indicating that the destination of that link is only accessible using Group OSCORE or OSCORE, and unprotected access to it is not supported. Note that this is simply a hint, it does not include any security context material or any other information required to run Group OSCORE or OSCORE. A value MUST NOT be given for the "gosc" attribute; any present value MUST be ignored by parsers. The "gosc" attribute MUST NOT appear more than once in a given link-value; occurrences after the first MUST be ignored by parsers. When a link-value includes the "gosc" attribute, the link-value MUST also include the "osc" attribute defined in . If the endpoint parsing the link-value supports Group OSCORE and understands the "gosc" attribute, then the parser MUST ignore the "osc" attribute, which is overshadowed by the "gosc" attribute. The example in shows a use of the "gosc" attribute: the client does resource discovery on a server and gets back a list of resources, one of which includes the "gosc" attribute indicating that the resource is protected with Group OSCORE or OSCORE. The link-format notation (see ) is used.

Example of using the "gosc" attribute in a web link. ;gosc;osc, ;if="sensor" ]]>

The Group Manager As with OSCORE, endpoints communicating with Group OSCORE need to establish the relevant Security Context. Group OSCORE endpoints need to acquire OSCORE input parameters, information about the group(s) and about other endpoints in the group(s). Every group is associated with a Group Manager that is responsible for distributing security parameters and keying material within the group, among other tasks. The details of how the Group Manager interacts with (candidate) group members or with external entities like signature checkers, as well as the protocols used for those interactions, are out of scope. The Group Manager assigns unique Group Identifiers (Gids) to the groups under its control. Within each of such groups, the Group Manager assigns unique Sender IDs (and thus Recipient IDs) to the respective group members. The maximum length of Sender IDs depends on the length of the nonce for the algorithms used in the group (see ). The Gid value assigned to a group is associated with a dedicated space for the values of Sender ID and Recipient ID of the members of that group. When an endpoint (re-)joins a group, it is provided with the current Gid to use in the group. The Group Manager also assigns an integer Key Generation Number counter to each of its groups, identifying the current version of the keying material used in that group. Further details about identifiers and keys are provided in . The Group Manager maintains records of the authentication credentials of endpoints in a group, and provides information about the group and its members to other group members (see ). Optionally, the Group Manager provides information about the group and its members to external entities with a specific role, such as signature checkers (see ). The list of responsibilities of the Group Manager is compiled in . One realization of a Group Manager is specified in , where the process by which an endpoint (re-)joins a group is based on the ACE framework for authentication and authorization in constrained environments .

Set-up of New Endpoints From the Group Manager, an endpoint acquires group data such as the Gid and OSCORE input parameters including its own Sender ID, with which it can derive the Sender Context. When joining the group or later on as a group member, an endpoint can also retrieve from the Group Manager the authentication credential of the Group Manager as well as the authentication credential and other information associated with other members of the group, with which it can derive the corresponding Recipient Context. An application can configure a group member to asynchronously retrieve information about Recipient Contexts, e.g., by Observing a resource at the Group Manager to get updates on the group membership. Upon endpoints' joining, the Group Manager collects their authentication credentials and MUST verify proof of possession of the respective private key. As an example, such proof of possession is possible to achieve during the join process provided by the realization of Group Manager specified in . Together with the requested authentication credentials of other group members, the Group Manager MUST provide the joining endpoints with the Sender ID of the associated group members and the current Key Generation Number in the group (see ). An endpoint may join a group, for example, by explicitly interacting with the responsible Group Manager, or by being configured with some tool performing the tasks of the Group Manager. When becoming members of a group, endpoints are not required to know how many and what endpoints are in the same group. Communications that the Group Manager has with joining endpoints and group members MUST be secured. Specific details on how to secure such communications are out of the scope of this document. The Group Manager MUST verify that the joining endpoint is authorized to join the group. To this end, the Group Manager can directly authorize the joining endpoint, or expect it to provide authorization evidence previously obtained from a trusted entity. Further details about the authorization of joining endpoints are out of the scope of this document. In case of successful authorization check, the Group Manager provides the joining endpoint with the keying material to initialize the Security Context. The actual provisioning of keying material and parameters to the joining endpoint is out of the scope of this document.

Management of Group Keying Material In order to establish a new Security Context for a group, the Group Manager MUST generate and assign to the group a new Group Identifier (Gid) and a new value for the Master Secret parameter. When doing so, a new value for the Master Salt parameter MAY also be generated and assigned to the group. When establishing the new Security Context, the Group Manager SHOULD preserve the current value of the Sender ID of each group member in order to ensure an efficient key rollover. Exceptions can apply if there are compelling reasons for making available again some of the Sender ID values currently used. The specific group key management scheme used to distribute new keying material is out of the scope of this document. A simple group key management scheme is defined in . When possible, the delivery of rekeying messages should use a reliable transport, in order to reduce chances of group members missing a rekeying instance. The use of an unreliable transport MUST NOT forego enforcing congestion control as appropriate for that transport. The set of group members should not be assumed as fixed, i.e., the group membership is subject to changes, possibly on a frequent basis. The Group Manager MUST rekey the group without undue delay when one or more endpoints leave the group. An endpoint may leave the group at own initiative, or may be evicted from the group by the Group Manager, e.g., in case the endpoint is compromised, or is suspected to be compromised (as determined by the Group Manager through its own means or based on information that it obtains from a trusted source such as an Intrusion Detection System or an issuer of authentication credentials). In either case, rekeying the group excludes such endpoints from future communications in the group, and thus preserves forward security. If a network node is compromised or suspected to be compromised, the Group Manager MUST evict from the group all the endpoints hosted by that node that are members of the group and rekey the group accordingly. If required by the application, the Group Manager MUST also rekey the group when one or more new joining endpoints are added to the group, thus preserving backward security. Separately for each group, the value of the Key Generation Number increases by one each time the Group Manager distributes new keying material to that group (see below). The establishment of the new Security Context for the group takes the following steps.

The Group Manager MUST increment the Key Generation Number for the group by 1. It is up to the Group Manager what actions to take when a wrap-around of the Key Generation Number is detected.
The Group Manager MUST build a set of stale Sender IDs including:
- The Sender IDs that, during the current Gid, were both assigned to an endpoint and subsequently relinquished (see ).
- The current Sender IDs of the group members that the upcoming group rekeying aims to exclude from future group communications, if any.
The Group Manager rekeys the group, by distributing:
- The new keying material, i.e., the new Master Secret, the new Gid and (optionally) the new Master Salt.
- The new Key Generation Number from Step 1.
- The set of stale Sender IDs from Step 2.
Further information may be distributed, depending on the specific group key management scheme used in the group.

When receiving the new group keying material, a group member considers the received stale Sender IDs and performs the following actions.

The group member MUST remove every authentication credential associated with a stale Sender ID from its list of group members' authentication credentials used in the group.
The group member MUST delete each of its Recipient Contexts used in the group whose corresponding Recipient ID is a stale Sender ID.

After that, the group member installs the new keying material and derives the corresponding new Security Context. A group member might miss one or more consecutive instances of group rekeying. As a result, the group member will retain old group keying material with Key Generation Number GEN_OLD. Eventually, the group member can notice the discrepancy, e.g., by repeatedly failing to verify incoming messages, or by explicitly querying the Group Manager for the current Key Generation Number. Once the group member gains knowledge of having missed a group rekeying, it MUST delete the old keying material it stores. Then, the group member proceeds according to the following steps.

The group member retrieves from the Group Manager the current group keying material, together with the current Key Generation Number GEN_NEW. The group member MUST NOT install the obtained group keying material yet.
The group member asks the Group Manager for the set of stale Sender IDs between GEN_OLD and GEN_NEW.
If no exact and complete indication can be obtained from the Group Manager, the group member MUST remove all the authentication credentials from its list of group members' authentication credentials used in the group and MUST delete all its Recipient Contexts used in the group. Otherwise, the group member MUST remove every authentication credential associated with a stale Sender ID from its list of group members' authentication credentials used in the group, and MUST delete each of its Recipient Contexts used in the group whose corresponding Recipient ID is a stale Sender ID.
The group member installs the current group keying material, and derives the corresponding new Security Context.

Alternatively, the group member can re-join the group. In such a case, the group member MUST take one of the following two actions.

First, the group member performs Steps 2 and 3 above. Then, the group member re-joins the group.
The group member re-joins the group with the same roles it currently has in the group, and, during the re-join process, it asks the Group Manager for the authentication credentials of all the current group members. Then, given Z the set of authentication credentials received from the Group Manager, the group member removes every authentication credential which is not in Z from its list of group members' authentication credentials used in the group, and deletes each of its Recipient Contexts used in the group that does not include any of the authentication credentials in Z.

By removing authentication credentials and deleting Recipient Contexts associated with stale Sender IDs, it is ensured that a recipient endpoint storing the latest group keying material does not store the authentication credentials of sender endpoints that are not current group members. This in turn allows group members to rely on stored authentication credentials to confidently verify the group membership of sender endpoints, when receiving incoming messages protected in group mode (see ). Strictness in managing the authentication credentials and Recipient Contexts associated with other group members is required for two reasons. First, as further discussed in , it ensures that the group mode can be used securely, even in a group where the Group Encryption Algorithm does not provide integrity protection (see ) and external signature checkers are used (see ). Second, it ensures that the wrong (old) authentication credential associated with a group member A is never used with a Sender ID that used to be associated with A and has been later issued to a different group member B (see ), thus preventing the need to recover from an identity mix-up.

Recycling of Identifiers This section specifies how the Group Manager handles and possibly reassigns Gid values and Sender ID values in a group.

Recycling of Group Identifiers Since the Gid value changes every time a group is rekeyed, it can happen that, after several rekeying instances, the whole space of Gid values has been used for the group in question. When this happens, the Group Manager has no available Gid values to use that have never been assigned to the group during the group's lifetime. The occurrence of such an event and how long it would take to occur depend on the format and encoding of Gid values used in the group (see, e.g., ), as well as on the frequency of rekeying instances yielding a change of Gid value. Independently for each group under its control, the Group Manager can take one of the two following approaches.

The Group Manager does not reassign Gid values. That is, once the whole space of Gid values has been used for a group, the Group Manager terminates the group and may re-establish a new group.
While the Gid value changes every time a group is rekeyed, the Group Manager can reassign Gid values previously used during a group's lifetime. By doing so, the group can continue to exist even once the whole space of Gid values has been used. The Group Manager MAY support and use this approach, according to what is specified in .

Reassignment of Group Identifiers If the Group Manager performs the reassignment of Gid values previously used during a group's lifetime, the Group Manager MUST take additional actions when handling Gid values and rekeying the group, as specified below. When a node (re-)joins the group and it is provided with the current Gid to use in the group, the Group Manager considers such a Gid as the Birth Gid of that endpoint for that group. For each group member, the Group Manager MUST store the latest corresponding Birth Gid until that member leaves the group. In case the endpoint has in fact re-joined the group, the newly determined Birth Gid overwrites the one currently stored. When establishing a new Security Context for the group, the Group Manager takes the additional following step between Steps 1 and 2 of . A. The Group Manager MUST check if the new Gid to be distributed is equal to the Birth Gid of any of the current group members. If any of such "elder members" is found in the group, then:

The Group Manager MUST evict the elder members from the group. That is, the Group Manager MUST terminate their membership and, in the following steps, it MUST rekey the group in such a way that the new keying material is not provided to those evicted elder members. This ensures that any response from the same server to the request of a long exchange can never successfully match against the request of two different long exchanges. The excluded elder members could eventually re-join the group, thus terminating any of their ongoing long exchanges (see ). Therefore, it is ensured by construction that no client can have with the same server two ongoing long exchanges, such that the two respective requests were protected using the same Partial IV, Gid, and Sender ID.

Recycling of Sender IDs From the moment T_start when a Gid is assigned to a group until the moment when a new Gid is assigned to that same group, the following restrictions apply within the group.

The Group Manager MUST NOT assign a Sender ID that was already the Sender ID of an endpoint in the group at T_start.
The Group Manager MUST NOT assign a given Sender ID more than once.

That is, under the ongoing use of the current Gid, a given Sender ID is not reassigned to the same or a different endpoint. This prevents from reusing a Sender ID ('kid') with the same triple (Gid, Master Secret, Master Salt). Within these restrictions, the Group Manager can assign a Sender ID used under an old Gid value (including under a same, recycled Gid value), thus avoiding Sender ID values to irrecoverably grow in size. Even when an endpoint joining a group is recognized as a current member of that group, e.g., through the ongoing secure communication association, the Group Manager MUST assign a new Sender ID different than the one currently used by the endpoint in the group, unless the group is rekeyed first and a new Gid value is established.

Relation between Identifiers and Keying Material overviews the different identifiers and keying material components, considering their relation and possible reuse across group rekeying.

Support for Signature Checkers The Group Manager may serve signature checkers, e.g., intermediary gateways, which verify countersignatures of messages protected in group mode (see ). These entities do not join a group as members, but can retrieve authentication credentials of group members and other selected group data from the Group Manager. In order to verify countersignatures of messages in a group, a signature checker needs to retrieve the following information about the group:

The current ID Context (Gid) used in the group.
The authentication credentials of the group members and of the Group Manager. If the signature checker is provided with a CWT or a CCS for a given entity, then the authentication credential associated with that entity is the untagged CWT or CCS. If the signature checker is provided with a chain or a bag of X.509 / C509 certificates, or of CWTs, or of CCSs for a given entity, then the authentication credential associated with that entity is the end-entity certificate or end-entity untagged CWT / CCS.
The current Signature Encryption Key (see ).
The identifiers of the algorithms used in the group (see ), i.e.: i) Group Encryption Algorithm and Signature Algorithm; and ii) AEAD Algorithm and Pairwise Key Agreement Algorithm, if such parameters are set in the Common Context (see and ).

A signature checker MUST be authorized before it can retrieve such information, for example with the use of .

Implementation Status Note to RFC Editor: when deleting this section, please also delete RFC 7942 from the references of this document. (Boilerplate as per :) This section records the status of known implementations of the protocol defined by this specification at the time of posting of this Internet-Draft, and is based on a proposal described in . The description of implementations in this section is intended to assist the IETF in its decision processes in progressing drafts to RFCs. Please note that the listing of any individual implementation here does not imply endorsement by the IETF. Furthermore, no effort has been spent to verify the information presented here that was supplied by IETF contributors. This is not intended as, and must not be construed to be, a catalog of available implementations or their features. Readers are advised to note that other implementations may exist. According to , "this will allow reviewers and working groups to assign due consideration to documents that have the benefit of running code, which may serve as evidence of valuable experimentation and feedback that have made the implemented protocols more mature. It is up to the individual working groups to use this information as they see fit".

Implementation #1

Responsible organization: RISE Research Institutes of Sweden AB
Implementation's name: Group OSCORE for Eclipse Californium
Available at: https://github.com/rikard-sics/californium/tree/group_oscore
Description: Implementation in Java, building on Eclipse Californium, see:
- https://github.com/eclipse-californium/californium
- http://eclipse.dev/californium/
Implementation's level of maturity: prototype
The implementation supports:
- The group mode and the pairwise mode.
- Mapping of public keys for the curve Ed25519 into Montgomery coordinates to use with X25519.
- The following COSE encryption algorithms: AES-CCM-16-64-128, AES-CCM-16-128-128, AES-CCM-16-64-256, AES-CCM-16-128-256, AES_CCM-64-64-128, AES-CCM-64-128-128, AES-CCM-64-64-256, AES-CCM-64-128-256, A128GCM, A192GCM, A256GCM, ChaCha20/Poly1305, A128CBC, A192CBC, A256CBC.
- The following HKDF algorithms: HKDF SHA-256 (identified as the COSE Algorithm "HMAC 256/256") and HKDF SHA-512 (identified as the COSE Algorithm "HMAC 512/512").
- The following COSE signature algorithms: ECDSA with curves P-256, P-384, and P-521, as well as EdDSA with curve Ed25519.
- The following COSE key agreement algorithms: ECDH-SS + HKDF-256 and ECDH-SS + HKDF-512, both of which using either keys of COSE Key Type "EC2" with the curve P-256, P-384, and P-521, or keys of COSE Key Type "OKP" key with X25519.
- The following authentication credential format: CWT Claims Sets (CCSs).
Version compatibility: From version -23 onwards.
Licensing: according to the same dual license of Eclipse Californium, i.e., according to the "Eclipse Distribution License 1.0" and the "Eclipse Public License 2.0". See:
- https://github.com/eclipse-californium/californium/blob/main/LICENSE
- https://www.eclipse.org/org/documents/edl-v10.php
- https://www.eclipse.org/legal/epl-2.0/
Contact information: Rikard Höglund - rikard.hoglund@ri.se
Information last updated on: 2025-02-06

Implementation #2

Implementation's name: aiocoap
Available at: https://codeberg.org/aiocoap/aiocoap
Description: A Python CoAP library with support for multiple transports and security mechanisms. The library provides also utility programs.
Implementation's level of maturity: Stable support for OSCORE; Group OSCORE is minimal.
The implementation supports:
- The group mode and the pairwise mode.
- Mapping of public keys for the curve Ed25519 into Montgomery coordinates to use with X25519.
- The following COSE encryption algorithms: 1-3, 10-13, 24, 30-33, -65531
- The following HKDF algorithms: HKDF SHA-256, -384, -512.
- The following COSE signature algorithms: EdDSA on Ed25519, ECDSA w/ SHA-256 on P-256
- The following COSE key agreement algorithms: ECDH on P-256 and curve25519.
- The following authentication credential format: currently n/a (user provides pairs of credentials and keys)
Version compatibility: -23
Licensing: MIT
Implementation experience: Mostly smooth; the differentiation between the regular and the group AEAD algorithm, and more generally finding the right parameters to input into the (abstracted) KDF part, was tedious and error prone (because Group OSCORE largely relies on OSCORE extension points that were anticipated, but that was not).
Contact information: Christian Amsüss - christian@amsuess.com
Information last updated on: 2025-02-06

Interoperability The two implementations mentioned in and have successfully completed interoperability tests. That occurred multiple times when covering earlier versions of the protocol, as well as specifically for version -23 of the Internet Draft, during the IETF 121 meeting in Dublin (Ireland) in November 2024 and later on in February 2025. The scenarios considered during the interoperability tests are as follows:

(A) Authentication credential format: CWT Claims Sets (CCSs).
(B) Message protection:
- (B1) Both requests and responses protected in group mode.
- (B2) Requests protected in group mode and responses protected in pairwise mode.
- (B3) Requests protected in pairwise mode and responses protected in group mode.
- (B4) Both requests and responses protected in pairwise mode.
(C) Signature algorithm: EdDSA with curve Ed25519.
(D) HKDF algorithms: HKDF SHA-256.
(E) Key agreement algorithms: ECDH-SS + HKDF-256, following a mapping of public keys for the curve Ed25519 into Montgomery coordinates to use with X25519.
(F) The following pairs of (Group Encryption Algorithm, AEAD Algorithm), for all the cases B1, B2, B3, and B4 above:
- (AES-CCM-16-64-128, AES-CCM-16-64-128).
- (ChaCha20/Poly1305, ChaCha20/Poly1305).
- (AES-CCM-16-64-128, ChaCha20/Poly1305).
- (ChaCha20/Poly1305, AES-CCM-16-64-128).
- (A128CBC, AES-CCM-16-64-128).

Security Considerations The same considerations from on the security properties of OSCORE hold for Group OSCORE, with the differences discussed in the following. Those considerations are about the reference threat model, the support for Proxy operations, the protection of message fields, and the uniqueness of (key, nonce) pairs (which is further discussed in of this document). For Group OSCORE, the Sender Context and Recipient Context additionally contain asymmetric keys, which are used to provide source authentication: in group mode, by means of countersignatures (see ); in pairwise mode, by using Diffie-Hellman (see ). The key pair can, for example, be generated by the endpoint or provisioned during manufacturing. Note that, even if an endpoint is authorized to be a group member and to take part in group communications, there is a risk that it behaves inappropriately. For instance, it can forward the content of messages in the group to unauthorized entities. However, in many use cases, the devices in the group belong to a common authority and are configured by a commissioner (see ), which limits this risk in practice and enables a prompt detection/reaction in case of misbehaving. With respect to unprotected message fields, the following holds. First, the 'kid context' of request messages is part of the Additional Authenticated Data, making it possible to keep long exchanges active safely beyond a possible change of ID Context (Gid) following a group rekeying (see ). Second, the countersignature included in a Group OSCORE message protected in group mode is also computed over the value of the OSCORE Option, which is also part of the Additional Authenticated Data used in the signing process. This is further discussed in of this document. In accordance with , all elements used in Group OSCORE as opaque binary values (e.g., Sender ID, ID Context) are not to be interpreted as text, Unicode, or otherwise. Implementations ought not to apply encoding transformations to the content of those elements, e.g., UTF-8 decoding or normalization. Information elements that may contain text such as those found within authentication credentials (e.g., X.509 distinguished names, CWT claims, or JSON Web Key fields) are to be treated as opaque structured data and to be interpreted only according to the rules of the credential format as defined in their respective specifications. This avoids misinterpretation, Unicode normalization attacks, or mismatches in identity comparison. As discussed in , Group OSCORE addresses security attacks against CoAP listed in Sections – of , especially when run over IP multicast. Group OSCORE does not aim to meet the following properties:

Verification of server aliveness, as discussed in .
Protection of network addressing information, as discussed in .
Management of group membership and group keying material, which is entrusted to the Group Manager (see ). Related security considerations are discussed in and .
Confidentiality protection of the OSCORE Option. Related privacy considerations are discussed in .

The rest of this section first discusses security aspects to be taken into account when using Group OSCORE. Then it goes through aspects covered in the security considerations of OSCORE (see ), and discusses how they hold when Group OSCORE is used.

Security of the Group Mode The group mode defined in relies on shared group keying material to protect communication within a group. Using the group mode has the implications discussed below. This section uses the term 'group members' to describe endpoints which possess the latest version of the group keying material.

Source authentication of messages sent to a group is ensured through a countersignature, which is computed by the sender endpoint using its own private key and then appended to the message payload. The countersignature is also encrypted using a keystream derived from the group keying material (see and ). This ensures group privacy, i.e., an attacker cannot track an endpoint over two groups by linking messages between the two groups unless the attacker is also a member of both groups.
Messages are encrypted at a group level (group-level data confidentiality), i.e., they can be decrypted by any member of the group, but not by an external adversary or other external entities other than the Group Manager responsible for the group.
If the used Group Encryption Algorithm provides integrity protection, then it also ensures group authentication and proof of group membership, but not source authentication. That is, it ensures that a message sent to a group has been sent by a member of that group, but not necessarily by the alleged sender. In fact, any group member is able to derive the Sender Key used by the actual sender endpoint, and thus can compute a valid authentication tag. Therefore, the message content could originate from any of the current group members. Furthermore, if the used Group Encryption Algorithm does not provide integrity protection, then it does not ensure any level of message authentication or proof of group membership. On the other hand, proof of group membership is always ensured by construction through the strict management of the group keying material (see ). That is, the group is rekeyed when members leave and the current group members are informed of former group members. Thus, a current group member storing the latest group keying material does not store the authentication credential of any former group member. This allows a recipient endpoint to rely on the stored authentication credentials and public keys included therein, in order to always confidently verify the group membership of a sender endpoint when processing an incoming message, i.e., to verify that the sender endpoint was a group member when it signed the message. In turn, this prevents a former group member from possibly re-signing and injecting in the group a stored message that was protected with old keying material. A case in point is discussed in .

The security properties of the group mode are summarized below.

Asymmetric source authentication, by means of a countersignature.
Symmetric group authentication, by means of an authentication tag (only for Group Encryption Algorithms providing integrity protection).
Symmetric group confidentiality, by means of symmetric encryption.
Proof of group membership, by strictly managing the group keying material, as well as by means of integrity tags when using a Group Encryption Algorithm that provides also integrity protection.
Group privacy, by encrypting the countersignature.

The group mode fulfills the security properties above while also displaying the following benefits. First, the use of a Group Encryption Algorithm that does not provide integrity protection results in a minimal communication overhead, by limiting the message payload to the ciphertext without integrity tag together with the encrypted countersignature. Second, it is possible to deploy semi-trusted entities such as signature checkers (see ), which can break property 5, but cannot break properties 1, 2, 3, and 4.

Example of Need for Proof of Group Membership As a case in point, the importance of reliable proof of group membership is evident in a group where the Group Encryption Algorithm does not provide integrity protection. Suppose a group member leaves the group and, after the group rekeying, associates with the group as external signature checker (see ). When doing so, it obtains from the Group Manager the new Signature Encryption Key, from which it can derive keystreams for encrypting and decrypting the countersignatures of messages protected in group mode. However, when participating in the group rekeying, the current group members deleted the Recipient Context and authentication credential of the former group member. Consequently, the signature checker is not able to successfully inject messages protected in group mode, as encrypted with the old group keying material, signed with its own private key, and with the countersignature encrypted by means of the latest Signature Encryption Key. That is, if the signature checker attempts to do that, then the group members will fail to verify the messages from the signature checker and thus will discard those messages.

Security of the Pairwise Mode The pairwise mode defined in protects messages by using pairwise symmetric keys, derived from the static-static Diffie-Hellman shared secret computed from the asymmetric keys of the sender and recipient endpoint (see ). The used AEAD Algorithm MUST provide integrity protection. Therefore, the pairwise mode ensures both pairwise data-confidentiality and source authentication of messages, without using countersignatures. Furthermore, the recipient endpoint achieves proof of group membership for the sender endpoint, since only current group members have the required keying material to derive a valid Pairwise Sender/Recipient Key. Finally, the pairwise mode ensures group privacy, i.e., an attacker cannot track an endpoint over two groups by linking messages between the two groups unless the attacker is also a member of both groups. This follows from two different groups using different and uncorrelated group keying material, which yields different and uncorrelated pairwise keys for the same endpoint in any two groups. Therefore, the authentication tags generated by an endpoint in a group have no correlation with those generated by the same endpoint in another group. The security properties of the pairwise mode are summarized below.

Symmetric source authentication, by means of an authentication tag.
Symmetric pairwise confidentiality, by means of symmetric encryption.
Proof of group membership, by strictly managing the group keying material, as well as by means of integrity tags.
Group privacy, by virtue of the uncorrelated pairwise keys used in any two different groups.

The long-term storing of the Diffie-Hellman shared secret is a potential security issue. In fact, if the shared secret of two group members is leaked, a third group member can exploit it to derive their pairwise keys and use those to impersonate either of the two group members to the other, or to decrypt previously stored messages exchanged between those two members and protected with their pairwise keys. The possibility of such leakage should be considered more likely than the leakage of a private key, which could be rather protected at a significantly higher level than generic memory, e.g., by using a Trusted Platform Module. Therefore, there is a trade-off between the maximum amount of time a same shared secret is stored and the frequency of its re-computing.

Uniqueness of (key, nonce) The proof for uniqueness of (key, nonce) pairs in is also valid in group communication scenarios. That is, given an OSCORE group:

Uniqueness of Sender IDs within the group is enforced by the Group Manager. In fact, from the moment when a Gid is assigned to a group until the moment when a new Gid is assigned to that same group, the Group Manager does not reassign a Sender ID within the group (see ).
The case A in concerns all requests as well as all responses including a Partial IV (e.g., Observe notifications or any other subsequent responses after the first one). In this case, the same considerations from apply here as well.
The case B in concerns responses not including a Partial IV (e.g., a single response to a request). In this case, the same considerations from apply here as well.

As a consequence, each message encrypted/decrypted with the same Sender Key is processed by using a different (ID_PIV, PIV) pair. This means that nonces used by any fixed encrypting endpoint are unique. Thus, each message is processed with a different (key, nonce) pair.

Management of Group Keying Material The protocol described in this document should take into account the risk of compromise of group members. In particular, this document specifies that a key management scheme for secure revocation and renewal of Security Contexts and group keying material MUST be adopted. specifies a simple rekeying scheme for renewing the Security Context in a group. Alternative rekeying schemes that are more scalable with the group size may be needed in dynamic, large groups where endpoints can join and leave at any time, in order to limit the impact on performance due to the Security Context and keying material update.

Denial of Service An adversary may leverage the loss of Sender Contexts and/or Recipient Contexts as described in , in order to perform a Denial of Service attack and prevent some group members from communicating altogether. That is, the adversary can first block the communication path between the Group Manager and some individual group members. This can be achieved, for instance, by injecting fake responses to DNS queries for the Group Manager hostname, or by removing a network link used for routing traffic towards the Group Manager. Then, the adversary can induce an unprepared reboot for some endpoints in the group, e.g., by triggering a short power outage. After that, such endpoints that have lost their Sender Context and/or Recipient Contexts following the reboot would not be able to obtain new Security Context parameters from the Group Manager, as specified in . Thus, they would not be able to further communicate in the group until connectivity with the Group Manager is restored.

Update of Security Context and Key Rotation A group member can receive a message shortly after the group has been rekeyed, and new security parameters and keying material have been distributed by the Group Manager. This may result in a client using an old Security Context to protect a request, and a server using a different new Security Context to protect a corresponding response. As a consequence, clients may receive a response protected with a Security Context different from the one used to protect the corresponding request. In particular, a server may first get a request protected with the old Security Context, then install the new Security Context, and only after that produce a response to send back to the client. In such a case, as specified in , the server MUST protect the potential response using the new Security Context. Specifically, the server MUST include its Sender Sequence Number as Partial IV in the response and use it to build the nonce to protect the response. This prevents the nonce from the request from being reused with the new Security Context. The client will process that response using the new Security Context, provided that it has installed the new security parameters and keying material before the message processing. In case block-wise transfer is used, the same considerations from hold. Furthermore, as described below, a group rekeying may temporarily result in misaligned Security Contexts between the sender and recipient of a given message.

Late Update on the Sender In this case, the sender protects a message using the old Security Context, i.e., before having installed the new Security Context. However, the recipient receives the message after having installed the new Security Context, and is thus unable to correctly process it. A possible way to ameliorate this issue is to preserve the old retained Security Context for a maximum amount of time defined by the application. By doing so, the recipient can still try to process the received message using the old retained Security Context. This makes particular sense when the recipient is a client, that would hence be able to process incoming responses protected with the old retained Security Context used to protect the associated request. If, as typically expected, the old Gid is not included in the response, then the client will first fail to process the response using the latest Security Context, and then use the old retained Security Context as a second attempt. Instead, a recipient server can immediately process an incoming request with the old retained Security Context, as signaled by the old Gid that is always included in requests. However, the server could simply discard such an incoming request, which is preferable from a security point of view. This tolerance preserves the processing of secure messages throughout a long-lasting key rotation, as group rekeying processes may likely take a long time to complete, especially in large groups. On the other hand, a former (compromised) group member can abusively take advantage of this, and send messages protected with the old retained Security Context. Therefore, a conservative application policy should not permit the retention of old Security Contexts.

Late Update on the Recipient In this case, the sender protects a message using the new Security Context, but the recipient receives that message before having installed the new Security Context. Therefore, the recipient would not be able to correctly process the message and hence discards it. If the recipient installs the new Security Context shortly after that and the sender endpoint retransmits the message, the former will still be able to receive and correctly process the message. In any case, the recipient should actively ask the Group Manager for an updated Security Context according to an application-defined policy, for instance after a given number of unsuccessfully decrypted incoming messages.

Collision of Group Identifiers In case endpoints are deployed in multiple groups managed by different non-synchronized Group Managers, it is possible for Group Identifiers of different groups to coincide. This does not impair the security of the AEAD Algorithm and of the Group Encryption Algorithm. In fact, as long as the Master Secret is different for different groups and this condition holds over time, keys are different among different groups. In case multiple groups use the same IP multicast address, the entity assigning that address may help limiting the chances to experience such collisions of Group Identifiers. In particular, it may allow the Group Managers of those groups using the same IP multicast address to share their respective list of assigned Group Identifiers currently in use.

Cross-group Message Injection A given endpoint is allowed to and would likely use the same pair (private key, authentication credential) in multiple OSCORE groups, possibly administered by different Group Managers. When a sender endpoint sends a message protected in pairwise mode to a recipient endpoint in an OSCORE group, a malicious group member may attempt to inject the message to a different OSCORE group also including the same endpoints (see ). This relies on altering the content of the OSCORE Option in such a way that the MAC in the ciphertext will still be correctly validated, which has a success probability depending on the size of the MAC. As discussed in , the attack is practically infeasible if the message is protected in group mode, thanks to the countersignature also bound to the OSCORE Option through the Additional Authenticated Data used in the signing process (see ).

Attack Description Let us consider:

Two OSCORE groups G1 and G2, with ID Context (Group ID) Gid1 and Gid2, respectively. Both G1 and G2 use the AEAD cipher AES-CCM-16-64-128, i.e., the MAC of the ciphertext is 8 bytes in size.
A sender endpoint X which is member of both G1 and G2, and uses the same pair (private key, authentication credential) in both groups. The endpoint X has Sender ID Sid1 in G1 and Sender ID Sid2 in G2. The pairs (Sid1, Gid1) and (Sid2, Gid2) identify the same authentication credential of X in G1 and G2, respectively.
A recipient endpoint Y which is member of both G1 and G2, and uses the same pair (private key, authentication credential) in both groups. The endpoint Y has Sender ID Sid3 in G1 and Sender ID Sid4 in G2. The pairs (Sid3, Gid1) and (Sid4, Gid2) identify the same authentication credential of Y in G1 and G2, respectively.
A malicious endpoint Z is also member of both G1 and G2. Hence, Z is able to derive the Sender Keys used by X in G1 and G2.

When X sends a message M1 addressed to Y in G1 and protected in pairwise mode, Z can intercept M1, and attempt to forge a valid message M2 to be injected in G2, making it appear as still sent by X to Y and valid to be accepted. In more detail, Z intercepts and stops message M1, and forges a message M2 by changing the value of the OSCORE Option from M1 as follows: the 'kid context' is set to G2 (rather than G1); and the 'kid' is set to Sid2 (rather than Sid1). Then, Z injects message M2 as addressed to Y in G2. Upon receiving M2, there is a probability equal to 2^-64 that Y successfully verifies the same unchanged MAC by using the Pairwise Recipient Key associated with X in G2. Note that Z does not know the pairwise keys of X and Y, since it does not know and is not able to compute their shared Diffie-Hellman secret. Therefore, Z is not able to check offline if a performed forgery is actually valid, before sending the forged message to G2.

Attack Prevention in Group Mode When a Group OSCORE message is protected in group mode, the countersignature is also computed over the value of the OSCORE Option, which is part of the Additional Authenticated Data used in the signing process (see ). That is, other than over the ciphertext, the countersignature is computed over: the ID Context (Gid) and the Partial IV, which are always present in requests; as well as the Sender ID of the message originator, which is always present in requests as well as in responses to requests protected in group mode. Since the signing process also takes as input the ciphertext of the COSE_Encrypt0 object, the countersignature is bound not only to the intended OSCORE group, hence to the triplet (Master Secret, Master Salt, ID Context), but also to a specific Sender ID in that group and to its specific symmetric key used for AEAD encryption, hence to the quartet (Master Secret, Master Salt, ID Context, Sender ID). This makes it practically infeasible to perform the attack described in , since it would require the adversary to additionally forge a valid countersignature that replaces the original one in the forged message M2.

Prevention of Group Cloning Attack Both when using the group mode and the pairwise mode, the message protection covers also the Group Manager's authentication credential. This is included in the Additional Authenticated Data used in the signing process and/or in the integrity-protected encryption process (see ). By doing so, an endpoint X member of a group G1 cannot perform the following attack.

X sets up a group G2 where it acts as Group Manager.
X makes G2 a "clone" of G1, i.e., G1 and G2 use the same algorithms and have the same Master Secret, Master Salt, and ID Context.
X collects a message M sent to G1 and injects it in G2.
Members of G2 accept M and believe it to be originated in G2.

The attack above is effectively prevented, since message M is protected by including the authentication credential of G1's Group Manager in the Additional Authenticated Data. Therefore, members of G2 do not successfully verify and decrypt M, since they correctly use the authentication credential of X as Group Manager of G2 when attempting to.

Group OSCORE for Unicast Requests If a request is intended to be sent over unicast as addressed to a single group member, it is NOT RECOMMENDED for the client to protect the request by using the group mode as defined in . This does not include the case where the client sends a request over unicast to a proxy, to be forwarded to multiple intended recipients over multicast . In this case, the client typically protects the request with the group mode, even though it is sent to the proxy over unicast (see ). If the client uses the group mode with its own Sender Key to protect a unicast request to a group member, an on-path adversary can, right then or later on, redirect that request to one/many different group member(s) over unicast, or to the whole OSCORE group over multicast. By doing so, the adversary can induce the target group member(s) to perform actions intended for one group member only. Note that the adversary can be external, i.e., they do not need to also be a member of the OSCORE group. This is due to the fact that the client is not able to indicate the single intended recipient in a way which is secure and possible to process for Group OSCORE on the server side. In particular, Group OSCORE does not protect network addressing information such as the IP address of the intended recipient server. It follows that the server(s) receiving the redirected request cannot verify whether that was the original intention of the client, and would thus simply assume so. The impact of such an attack depends especially on the REST method of the request, i.e., the Inner CoAP Code of the OSCORE request message. In particular, safe methods such as GET and FETCH would trigger (several) unintended responses from the targeted server(s), while not resulting in destructive behavior. On the other hand, non safe methods such as PUT, POST, and PATCH/iPATCH would result in the target server(s) taking active actions on their resources and possible cyber-physical environment, with the risk of destructive consequences and possible implications for safety. A client can instead use the pairwise mode as defined in , in order to protect a request sent to a single group member by using pairwise keying material (see ). This prevents the attack discussed above by construction, as only the intended server is able to derive the pairwise keying material used by the client to protect the request. Before delivering to the application an incoming request protected in group mode that was sent over unicast, a server should carefully consider the impact that processing the request would have, without dismissing the possibility that the request reception was in fact the result of the attack discussed above. This is especially important for endpoints implementing only a silent server, since they do not support the pairwise mode and thus are able to process only requests protected in group mode. Application policies can also define specific exceptional cases where it is safe for a server to deliver such requests to the application, which can then take a final decision about whether acting on the request or not. For instance, such decision can leverage an application-level unique identifier of the server specified in the payload of the request. In a group where the AEAD Algorithm and Pairwise Key Agreement Algorithm are set in the Security Context, an endpoint supporting the pairwise mode SHOULD use it to protect requests sent to a single group member over unicast. Using the group mode to protect such requests would make the request possible to decrypt and verify for any other group member; this may sometimes be a desired property (e.g. see ). The use of block-wise transfers with group communication for CoAP is as discussed in . Note that, after the first request targeting all servers in the group over multicast, a client can switch to sending unicast requests for retrieving further blocks from the servers. In particular, after a first block-wise request that targets all servers in the group and includes the CoAP Block2 Option, the retrieval of further blocks can use unicast requests, which should therefore be protected using the pairwise mode. Similarly, if the first request that targeted all servers in the group did not include the CoAP Block2 Option and the corresponding responses included the Block2 Option at the servers' own initiative, then the retrieval of further blocks can use unicast requests, which should therefore be protected using the pairwise mode. Additional considerations are discussed in , with respect to requests including a CoAP Echo Option that have to be sent over unicast, as a challenge-response method for servers to achieve freshness or to initialize as valid a previously invalid Replay Window.

End-to-end Protection The same considerations from hold for Group OSCORE. Additionally, (D)TLS and Group OSCORE can be combined for protecting message exchanges occurring over unicast. However, it is not possible to combine (D)TLS and Group OSCORE for protecting message exchanges where messages are sent over multicast.

Master Secret Group OSCORE derives the Security Context using the same construction used by OSCORE, and by using the Group Identifier of a group as the related ID Context. Hence, the same required properties of the Security Context parameters discussed in hold for this document. With particular reference to the OSCORE Master Secret, it has to be kept secret among the members of the respective OSCORE group and the Group Manager responsible for that group. Also, the Master Secret must have a good amount of randomness, and the Group Manager can generate it offline using a good random number generator. This includes the case where the Group Manager rekeys the group by generating and distributing a new Master Secret. Randomness requirements for security are described in .

Replay Protection As in OSCORE , Group OSCORE relies on Sender Sequence Numbers included in the COSE message field 'Partial IV' and used to build nonces. Note that the Partial IV of an endpoint does not necessarily grow monotonically. For instance, upon exhaustion of the endpoint's Sender Sequence Number space, the endpoint's Partial IV space also gets exhausted. As discussed in , this results either in the endpoint being individually rekeyed and getting a new Sender ID, or in the establishment of a new Security Context in the group. Therefore, uniqueness of (key, nonce) pairs (see ) is preserved when a new Security Context is established. Since one-to-many communication such as multicast usually involves unreliable transports, the simplification of the Replay Window to a size of 1 suggested in is not viable with Group OSCORE, unless exchanges in the group rely only on unicast messages. A server's Replay Window may be initialized as invalid (see ). The server can either retrieve a new Group OSCORE Security Context, or make a Replay Window valid (see ) before accepting further incoming messages from other group members.

Message Ordering Assuming that the other endpoint is honest, Group OSCORE provides relative ordering of received messages. For a given Group OSCORE Security Context, the received Partial IV (when included) allows the recipient endpoint to determine the order in which requests or responses were sent by the other endpoint. If the Partial IV was omitted in a response, this indicates that it was the oldest response from the sender endpoint to the corresponding request (like notification responses in OSCORE, see ). A received response is not older than the corresponding request.

Message Freshness As in OSCORE, Group OSCORE provides only the guarantee that the request is not older than the Group OSCORE Security Context used to protect it. Other aspects of freshness are discussed in . The challenge-response approach described in provides an assurance of freshness of the request without depending on the honesty of the client. However, it can result in an impact on performance which is undesirable or unbearable, especially in large groups where many endpoints at the same time might join as new members. Endpoints configured as silent servers are not able to perform the challenge-response described above, as they do not store a Sender Context to secure the 4.01 (Unauthorized) response to the client. Thus, silent servers should adopt alternative approaches to make their Replay Windows valid. For example, a silent server can retrieve or wait for new Security Context parameters from the Group Manager and derive new Recipient Contexts. When doing so, the Replay Windows of all Recipient Contexts become valid if they are not already. In particular, any invalid Replay Window is re-initialized as valid and with 0 as its current lower limit. Since requests including the Echo Option are sent over unicast, a server can be the victim of the attack discussed in if such requests are protected in group mode. Instead, protecting those requests with the pairwise mode prevents the attack above. In fact, only the server involved in the challenge-response exchange is able to derive the pairwise key used by the client to protect the request including the Echo Option. In either case, an internal on-path adversary would not be able to transpose the Echo Option value of two different unicast requests, sent by a same client to any two different servers in the group. In fact, even if the group mode was used, this would require the adversary to forge the countersignature of both requests. As a consequence, each of the two servers remains able to selectively accept a request with the Echo Option only if it is waiting for that exact integrity-protected Echo Option value, and is thus the intended recipient.

Client Aliveness Like in OSCORE (see ), a server may verify the aliveness of the client by using the CoAP Echo Option as described in . In the interest of avoiding otherwise unnecessary uses of such an approach, the server can exploit the fact that the received request cannot be older than the Security Context used to protect it. This effectively allows the server to verify the client aliveness relative to the installation of the latest group keying material.

Cryptographic Considerations The same considerations from about the maximum Sender Sequence Number hold for Group OSCORE. As discussed in , an endpoint that experiences an exhaustion of its own Sender Sequence Number space MUST NOT protect further messages including a Partial IV, until it has derived a new Sender Context. This prevents the endpoint from reusing the same nonce with the same Sender Key. In order to renew its own Sender Context, the endpoint SHOULD inform the Group Manager, which can either renew the whole Security Context by means of group rekeying, or provide only that endpoint with a new Sender ID value. In either case, the endpoint derives a new Sender Context, and in particular a new Sender Key. Additionally, the same considerations from hold for Group OSCORE, about building the nonce and the secrecy of the Security Context parameters. The group mode uses the "encrypt-then-sign" construction, i.e., the countersignature is computed over the COSE_Encrypt0 object (see ). This is motivated by enabling signature checkers (see ), which do not join a group as members but are allowed to verify countersignatures of messages protected in group mode without being able to decrypt those messages (see ). If the Group Encryption Algorithm used in group mode provides integrity protection, countersignatures of COSE_Encrypt0 with short authentication tags do not provide the security properties associated with the same algorithm used in COSE_Sign (see ). To provide 128-bit security against collision attacks, the tag length MUST be at least 256-bits. A countersignature of a COSE_Encrypt0 with AES-CCM-16-64-128 provides at most 32 bits of integrity protection. The derivation of pairwise keys defined in is compatible with ECDSA and EdDSA asymmetric keys, but is not compatible with RSA asymmetric keys. For the public key translation from Ed25519 (Ed448) to X25519 (X448) specified in , variable time methods can be used since the translation operates on public information. Any byte string of appropriate length is accepted as a public key for X25519 (X448) in . It is therefore not necessary for security to validate the translated public key (assuming the translation was successful). The security of using the same key pair for Diffie-Hellman and for signing (by considering the ECDH procedure in as a Key Encapsulation Mechanism (KEM)) is demonstrated in and . Applications using ECDH (except X25519 and X448) based KEM in are assumed to verify that a peer endpoint's public key is on the expected curve and that the shared secret is not the point at infinity. The KEM in checks that the shared secret is different from the point at infinity, as does the procedure in Section 5.7.1.2 of which is referenced in . By extending Theorem 2 of , shows that the same key pair can be used with X25519 and Ed25519 (X448 and Ed448) for the KEM specified in . By symmetry in the KEM used in this document, both endpoints can consider themselves to have the recipient role in the KEM - as discussed in Section 7 of - and rely on the mentioned proofs for the security of their key pairs. Theorem 3 in shows that the same key pair can be used for an ECDH based KEM and ECDSA. The KEM uses a different KDF than in , but the proof only depends on that the KDF has certain required properties, which are the typical assumptions about HKDF, e.g., that output keys are pseudorandom. In order to comply with the assumptions of Theorem 3, received public keys MUST be successfully validated, see Section 5.6.2.3.4 of . The validation MAY be performed by a trusted Group Manager. For to apply as it is written, public keys need to be in the expected subgroup. For this, we rely on cofactor Diffie-Hellman as per Section 5.7.1.2 of , which is referenced in . HashEdDSA variants of Ed25519 and Ed448 are not used by COSE (see ), and are not covered by the analysis in . Hence, they MUST NOT be used with the public keys used to derive pairwise keys as specified in this document.

Message Segmentation The same considerations from hold for Group OSCORE.

Privacy Considerations Group OSCORE ensures end-to-end integrity protection and encryption of the message payload and of all the options that are not used for proxy operations. In particular, options are processed according to the same class U/I/E that they have for OSCORE. Therefore, the same privacy considerations from hold for Group OSCORE, with the following addition.

When protecting a message in group mode, the countersignature is encrypted by using a keystream derived from the group keying material (see and ). This ensures group privacy. That is, an attacker cannot track an endpoint over two groups by linking messages between the two groups, unless being also a member of those groups.

Furthermore, the following privacy considerations hold about the OSCORE Option, which may reveal information on the communicating endpoints.

The 'kid' parameter, which is intended to help a recipient endpoint to find the right Recipient Context, may reveal information about the Sender Endpoint. When both a request and the corresponding responses include the 'kid' parameter, this may reveal information about both a client sending a request and all the possibly replying servers sending their own individual response.
The 'kid context' parameter, which is intended to help a recipient endpoint to find the right Security Context, reveals information about the sender endpoint. In particular, it reveals that the sender endpoint is a member of a particular OSCORE group, whose current Group ID is indicated in the 'kid context' parameter.

When receiving a group request, each of the recipient endpoints can reply with a response that includes its Sender ID as 'kid' parameter. All these responses will be matchable with the request through the CoAP Token. Thus, even if these responses do not include a 'kid context' parameter, it becomes possible to understand that the responder endpoints are in the same group of the requester endpoint. Furthermore, using the approach described in to make Replay Windows valid may reveal when a server device goes through a reboot. This can be mitigated by the server device storing the precise state of the Replay Window of each known client on a clean shutdown. Finally, the approach described in to prevent collisions of Group Identifiers from different Group Managers may reveal information about events in the respective OSCORE groups. In particular, a Group Identifier changes when the corresponding group is rekeyed. Thus, Group Managers might use the shared list of Group Identifiers to infer the rate and patterns of group membership changes triggering a group rekeying, e.g., due to newly joined members or evicted (compromised) members. In order to alleviate this privacy concern, it should be hidden from the Group Managers which exact Group Manager has currently assigned which Group Identifiers in its OSCORE groups.

IANA Considerations Note to RFC Editor: Please replace "[RFC-XXXX]" with the RFC number of this document and delete this paragraph. This document has the following actions for IANA.

OSCORE Flag Bits Registry IANA is asked to add the following entry to the "OSCORE Flag Bits" registry within the "Constrained RESTful Environments (CoRE) Parameters" registry group. Registrations in the OSCORE Flag Bits Registry

Bit Position	Name	Description	Reference
2	Group Flag	For using a Group OSCORE Security Context, set to 1 if the message is protected with the group mode	[RFC-XXXX]

Target Attributes Registry IANA is asked to add the following entry to the "Target Attributes" registry within the "Constrained RESTful Environments (CoRE) Parameters" registry group.

References Normative References Group Communication for the Constrained Application Protocol (CoAP) IoTconsultancy.nl RISE AB The Constrained Application Protocol (CoAP) is a web transfer protocol for constrained devices and constrained networks. In a number of use cases, constrained devices often naturally operate in groups (e.g., in a building automation scenario, all lights in a given room may need to be switched on/off as a group). This document specifies the use of CoAP for group communication, including the use of UDP/IP multicast as the default underlying data transport. Both unsecured and secured CoAP group communication are specified. Security is achieved by use of the Group Object Security for Constrained RESTful Environments (Group OSCORE) protocol. The target application area of this specification is any group communication use cases that involve resource-constrained devices or networks that support CoAP. This document replaces and obsoletes RFC 7390, while it updates RFC 7252 and RFC 7641. Randomness Requirements for Security Security systems are built on strong cryptographic algorithms that foil pattern analysis attempts. However, the security of these systems is dependent on generating secret quantities for passwords, cryptographic keys, and similar quantities. The use of pseudo-random processes to generate secret quantities can result in pseudo-security. A sophisticated attacker may find it easier to reproduce the environment that produced the secret quantities and to search the resulting small set of possibilities than to locate the quantities in the whole of the potential number space. Choosing random quantities to foil a resourceful and motivated adversary is surprisingly difficult. This document points out many pitfalls in using poor entropy sources or traditional pseudo-random number generation techniques for generating such quantities. It recommends the use of truly random hardware techniques and shows that the existing hardware on many systems can be used for this purpose. It provides suggestions to ameliorate the problem when a hardware solution is not available, and it gives examples of how large such quantities need to be for some applications. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements. HMAC-based Extract-and-Expand Key Derivation Function (HKDF) This document specifies a simple Hashed Message Authentication Code (HMAC)-based key derivation function (HKDF), which can be used as a building block in various protocols and applications. The key derivation function (KDF) is intended to support a wide range of applications and requirements, and is conservative in its use of cryptographic hash functions. This document is not an Internet Standards Track specification; it is published for informational purposes. Deterministic Usage of the Digital Signature Algorithm (DSA) and Elliptic Curve Digital Signature Algorithm (ECDSA) This document defines a deterministic digital signature generation procedure. Such signatures are compatible with standard Digital Signature Algorithm (DSA) and Elliptic Curve Digital Signature Algorithm (ECDSA) digital signatures and can be processed with unmodified verifiers, which need not be aware of the procedure described therein. Deterministic signatures retain the cryptographic security features associated with digital signatures but can be more easily implemented in various environments, since they do not need access to a source of high-quality randomness. The Constrained Application Protocol (CoAP) The Constrained Application Protocol (CoAP) is a specialized web transfer protocol for use with constrained nodes and constrained (e.g., low-power, lossy) networks. The nodes often have 8-bit microcontrollers with small amounts of ROM and RAM, while constrained networks such as IPv6 over Low-Power Wireless Personal Area Networks (6LoWPANs) often have high packet error rates and a typical throughput of 10s of kbit/s. The protocol is designed for machine- to-machine (M2M) applications such as smart energy and building automation. CoAP provides a request/response interaction model between application endpoints, supports built-in discovery of services and resources, and includes key concepts of the Web such as URIs and Internet media types. CoAP is designed to easily interface with HTTP for integration with the Web while meeting specialized requirements such as multicast support, very low overhead, and simplicity for constrained environments. Observing Resources in the Constrained Application Protocol (CoAP) The Constrained Application Protocol (CoAP) is a RESTful application protocol for constrained nodes and networks. The state of a resource on a CoAP server can change over time. This document specifies a simple protocol extension for CoAP that enables CoAP clients to "observe" resources, i.e., to retrieve a representation of a resource and keep this representation updated by the server over a period of time. The protocol follows a best-effort approach for sending new representations to clients and provides eventual consistency between the state observed by each client and the actual resource state at the server. Elliptic Curves for Security This memo specifies two elliptic curves over prime fields that offer a high level of practical security in cryptographic applications, including Transport Layer Security (TLS). These curves are intended to operate at the ~128-bit and ~224-bit security level, respectively, and are generated deterministically based on a list of required properties. Edwards-Curve Digital Signature Algorithm (EdDSA) This document describes elliptic curve signature scheme Edwards-curve Digital Signature Algorithm (EdDSA). The algorithm is instantiated with recommended parameters for the edwards25519 and edwards448 curves. An example implementation and test vectors are provided. Web Linking This specification defines a model for the relationships between resources on the Web ("links") and the type of those relationships ("link relation types"). It also defines the serialisation of such links in HTTP headers with the Link header field. Concise Data Definition Language (CDDL): A Notational Convention to Express Concise Binary Object Representation (CBOR) and JSON Data Structures This document proposes a notational convention to express Concise Binary Object Representation (CBOR) data structures (RFC 7049). Its main goal is to provide an easy and unambiguous way to express structures for protocol messages and data formats that use CBOR or JSON. Object Security for Constrained RESTful Environments (OSCORE) This document defines Object Security for Constrained RESTful Environments (OSCORE), a method for application-layer protection of the Constrained Application Protocol (CoAP), using CBOR Object Signing and Encryption (COSE). OSCORE provides end-to-end protection between endpoints communicating using CoAP or CoAP-mappable HTTP. OSCORE is designed for constrained nodes and networks supporting a range of proxy operations, including translation between different transport protocols. Although an optional functionality of CoAP, OSCORE alters CoAP options processing and IANA registration. Therefore, this document updates RFC 7252. Concise Binary Object Representation (CBOR) The Concise Binary Object Representation (CBOR) is a data format whose design goals include the possibility of extremely small code size, fairly small message size, and extensibility without the need for version negotiation. These design goals make it different from earlier binary serializations such as ASN.1 and MessagePack. This document obsoletes RFC 7049, providing editorial improvements, new details, and errata fixes while keeping full compatibility with the interchange format of RFC 7049. It does not create a new version of the format. CBOR Object Signing and Encryption (COSE): Structures and Process Concise Binary Object Representation (CBOR) is a data format designed for small code size and small message size. There is a need to be able to define basic security services for this data format. This document defines the CBOR Object Signing and Encryption (COSE) protocol. This specification describes how to create and process signatures, message authentication codes, and encryption using CBOR for serialization. This specification additionally describes how to represent cryptographic keys using CBOR. This document, along with RFC 9053, obsoletes RFC 8152. CBOR Object Signing and Encryption (COSE): Initial Algorithms Concise Binary Object Representation (CBOR) is a data format designed for small code size and small message size. There is a need to be able to define basic security services for this data format. This document defines a set of algorithms that can be used with the CBOR Object Signing and Encryption (COSE) protocol (RFC 9052). This document, along with RFC 9052, obsoletes RFC 8152. Constrained Application Protocol (CoAP): Echo, Request-Tag, and Token Processing This document specifies enhancements to the Constrained Application Protocol (CoAP) that mitigate security issues in particular use cases. The Echo option enables a CoAP server to verify the freshness of a request or to force a client to demonstrate reachability at its claimed network address. The Request-Tag option allows the CoAP server to match block-wise message fragments belonging to the same request. This document updates RFC 7252 with respect to the following: processing requirements for client Tokens, forbidding non-secure reuse of Tokens to ensure response-to-request binding when CoAP is used with a security protocol, and amplification mitigation (where the use of the Echo option is now recommended). CBOR Object Signing and Encryption (COSE): Countersignatures Concise Binary Object Representation (CBOR) is a data format designed for small code size and small message size. CBOR Object Signing and Encryption (COSE) defines a set of security services for CBOR. This document defines a countersignature algorithm along with the needed header parameters and CBOR tags for COSE. This document updates RFC 9052. CBOR Object Signing and Encryption (COSE): AES-CTR and AES-CBC The Concise Binary Object Representation (CBOR) data format is designed for small code size and small message size. CBOR Object Signing and Encryption (COSE) is specified in RFC 9052 to provide basic security services using the CBOR data format. This document specifies the conventions for using AES-CTR and AES-CBC as content encryption algorithms with COSE. COSE Algorithms IANA Recommendation for Pair-Wise Key-Establishment Schemes Using Discrete Logarithm Cryptography - NIST Special Publication 800-56A, Revision 3 Key words for use in RFCs to Indicate Requirement Levels In many standards track documents several words are used to signify the requirements in the specification. These words are often capitalized. This document defines these words as they should be interpreted in IETF documents. This document specifies an Internet Best Current Practices for the Internet Community, and requests discussion and suggestions for improvements. Ambiguity of Uppercase vs Lowercase in RFC 2119 Key Words RFC 2119 specifies common key words that may be used in protocol specifications. This document aims to reduce the ambiguity by clarifying that only UPPERCASE usage of the key words have the defined special meanings. Informative References Key Management for Group Object Security for Constrained RESTful Environments (Group OSCORE) Using Authentication and Authorization for Constrained Environments (ACE) RISE AB Ericsson AB This document defines an application profile of the Authentication and Authorization for Constrained Environments (ACE) framework, to request and provision keying material in group communication scenarios that are based on the Constrained Application Protocol (CoAP) and are secured with Group Object Security for Constrained RESTful Environments (Group OSCORE). This application profile delegates the authentication and authorization of Clients, which join an OSCORE group through a Resource Server acting as Group Manager for that group. This application profile leverages protocol-specific transport profiles of ACE to achieve communication security, server authentication, and proof of possession for a key owned by the Client and bound to an OAuth 2.0 access token. Comparison of CoAP Security Protocols Ericsson Ericsson INRIA This document analyzes and compares the sizes of key exchange flights and the per-packet message size overheads when using different security protocols to secure CoAP. Small message sizes are very important for reducing energy consumption, latency, and time to completion in constrained radio network such as Low-Power Wide Area Networks (LPWANs). The analyzed security protocols are DTLS 1.2, DTLS 1.3, TLS 1.2, TLS 1.3, cTLS, EDHOC, OSCORE, and Group OSCORE. The DTLS and TLS record layers are analyzed with and without 6LoWPAN- GHC compression. DTLS is analyzed with and without Connection ID. Observe Notifications as CoAP Multicast Responses RISE AB RISE AB Ericsson AB The Constrained Application Protocol (CoAP) allows clients to "observe" resources at a server, and receive notifications as unicast responses upon changes of the resource state. In some use cases, such as based on publish-subscribe, it would be convenient for the server to send a single notification addressed to all the clients observing a same target resource. This document updates RFC7252 and RFC7641, and defines how a server sends observe notifications as response messages over multicast, synchronizing all the observers of a same resource on a same shared Token value. Besides, this document defines how Group OSCORE can be used to protect multicast notifications end-to-end between the server and the observer clients. Alternative Elliptic Curve Representations Struik Security Consultancy This document specifies how to represent Montgomery curves and (twisted) Edwards curves as curves in short-Weierstrass form and illustrates how this can be used to carry out elliptic curve computations leveraging existing implementations and specifications of, e.g., ECDSA and ECDH using NIST prime curves. We also provide extensive background material that may be useful for implementers of elliptic curve cryptography. CBOR Encoded X.509 Certificates (C509 Certificates) Ericsson AB Ericsson AB RISE AB RISE AB IN Groupe This document specifies a CBOR encoding of X.509 certificates. The resulting certificates are called C509 Certificates. The CBOR encoding supports a large subset of RFC 5280 and all certificates compatible with the RFC 7925, IEEE 802.1AR (DevID), CNSA 1.0, RPKI, GSMA eUICC, and CA/Browser Forum Baseline Requirements profiles. C509 is deployed in different settings including, in-vehicle and vehicle-to-cloud communication, Unmanned Aircraft Systems (UAS), and Global Navigation Satellite System (GNSS). When used to re-encode DER encoded X.509 certificates, the CBOR encoding can in many cases reduce the size of RFC 7925 profiled certificates by over 50% while also significantly reducing memory and code size compared to ASN.1. The CBOR encoded structure can alternatively be signed directly ("natively signed"), which does not require re-encoding for the signature to be verified. The TLSA selectors registry defined in RFC 6698 is extended to include C509 certificates. The document also specifies C509 Certificate Requests, C509 COSE headers, a C509 TLS certificate type, and a C509 file format. OSCORE-capable Proxies RISE AB RISE AB Object Security for Constrained RESTful Environments (OSCORE) can be used to protect CoAP messages end-to-end between two endpoints at the application layer, also in the presence of intermediaries such as proxies. This document defines how to use OSCORE for protecting CoAP messages also between an origin application endpoint and an intermediary, or between two intermediaries. Also, it defines rules to escalate the protection of a CoAP option, in order to encrypt and integrity-protect it whenever possible. Finally, it defines how to secure a CoAP message by applying multiple, nested OSCORE protections, e.g., both end-to-end between origin application endpoints; and between an application endpoint and an intermediary or between two intermediaries. Therefore, this document updates RFC 8613. Furthermore, this document updates RFC 8768, by explicitly defining the processing with OSCORE for the CoAP option Hop-Limit. The approach defined in this document can be seamlessly used with Group OSCORE, for protecting CoAP messages when group communication is used in the presence of intermediaries. Proxy Operations for CoAP Group Communication RISE AB IoTconsultancy.nl This document defines a specific realization of proxy intended for scenarios that use group communication for the Constrained Application Protocol (CoAP). Such a proxy processes a single request sent by a client typically over unicast and distributes the request to a group of servers, e.g., over UDP/IP multicast as the defined default transport protocol. Then, the proxy collects the individual responses from those servers and relays those responses back to the client, in a way that allows the client to distinguish the responses and their origin servers through embedded addressing information. This document updates RFC7252 with respect to caching of response messages at proxies. Hedged ECDSA and EdDSA Signatures Ericsson Ericsson Ericsson Deterministic elliptic-curve signatures such as deterministic ECDSA and EdDSA have gained popularity over randomized ECDSA as their security does not depend on a source of high-quality randomness. Recent research, however, has found that implementations of these signature algorithms may be vulnerable to certain side-channel and fault injection attacks due to their deterministic nature. One countermeasure to such attacks is hedged signatures where the calculation of the per-message secret number includes both fresh randomness and the message. This document updates RFC 6979 and RFC 8032 to recommend hedged constructions in deployments where side- channel attacks and fault injection attacks are a concern. The updates are invisible to the validator of the signature and compatible with existing ECDSA and EdDSA validators. Cacheable OSCORE RISE AB Group communication with the Constrained Application Protocol (CoAP) can be secured end-to-end using Group Object Security for Constrained RESTful Environments (Group OSCORE), also across untrusted intermediary proxies. However, this sidesteps the proxies' abilities to cache responses from the origin server(s). This specification restores cacheability of protected responses at proxies, by introducing consensus requests which any client in a group can send to one server or multiple servers in the same group. UTF-8, a transformation format of ISO 10646 ISO/IEC 10646-1 defines a large character set called the Universal Character Set (UCS) which encompasses most of the world's writing systems. The originally proposed encodings of the UCS, however, were not compatible with many current applications and protocols, and this has led to the development of UTF-8, the object of this memo. UTF-8 has the characteristic of preserving the full US-ASCII range, providing compatibility with file systems, parsers and other software that rely on US-ASCII values but are transparent to other values. This memo obsoletes and replaces RFC 2279. Transmission of IPv6 Packets over IEEE 802.15.4 Networks This document describes the frame format for transmission of IPv6 packets and the method of forming IPv6 link-local addresses and statelessly autoconfigured addresses on IEEE 802.15.4 networks. Additional specifications include a simple header compression scheme using shared context and provisions for packet delivery in IEEE 802.15.4 meshes. [STANDARDS-TRACK] Internet Security Glossary, Version 2 This Glossary provides definitions, abbreviations, and explanations of terminology for information system security. The 334 pages of entries offer recommendations to improve the comprehensibility of written material that is generated in the Internet Standards Process (RFC 2026). The recommendations follow the principles that such writing should (a) use the same term or definition whenever the same concept is mentioned; (b) use terms in their plainest, dictionary sense; (c) use terms that are already well-established in open publications; and (d) avoid terms that either favor a particular vendor or favor a particular technology or mechanism over other, competing techniques that already exist or could be developed. This memo provides information for the Internet community. Internet X.509 Public Key Infrastructure Certificate and Certificate Revocation List (CRL) Profile This memo profiles the X.509 v3 certificate and X.509 v2 certificate revocation list (CRL) for use in the Internet. An overview of this approach and model is provided as an introduction. The X.509 v3 certificate format is described in detail, with additional information regarding the format and semantics of Internet name forms. Standard certificate extensions are described and two Internet-specific extensions are defined. A set of required certificate extensions is specified. The X.509 v2 CRL format is described in detail along with standard and Internet-specific extensions. An algorithm for X.509 certification path validation is described. An ASN.1 module and examples are provided in the appendices. [STANDARDS-TRACK] Compression Format for IPv6 Datagrams over IEEE 802.15.4-Based Networks This document updates RFC 4944, "Transmission of IPv6 Packets over IEEE 802.15.4 Networks". This document specifies an IPv6 header compression format for IPv6 packet delivery in Low Power Wireless Personal Area Networks (6LoWPANs). The compression format relies on shared context to allow compression of arbitrary prefixes. How the information is maintained in that shared context is out of scope. This document specifies compression of multicast addresses and a framework for compressing next headers. UDP header compression is specified within this framework. [STANDARDS-TRACK] Constrained RESTful Environments (CoRE) Link Format This specification defines Web Linking using a link format for use by constrained web servers to describe hosted resources, their attributes, and other relationships between links. Based on the HTTP Link Header field defined in RFC 5988, the Constrained RESTful Environments (CoRE) Link Format is carried as a payload and is assigned an Internet media type. "RESTful" refers to the Representational State Transfer (REST) architecture. A well-known URI is defined as a default entry point for requesting the links hosted by a server. [STANDARDS-TRACK] Terminology for Constrained-Node Networks The Internet Protocol Suite is increasingly used on small devices with severe constraints on power, memory, and processing resources, creating constrained-node networks. This document provides a number of basic terms that have been useful in the standardization work for constrained-node networks. Block-Wise Transfers in the Constrained Application Protocol (CoAP) The Constrained Application Protocol (CoAP) is a RESTful transfer protocol for constrained nodes and networks. Basic CoAP messages work well for small payloads from sensors and actuators; however, applications will need to transfer larger payloads occasionally -- for instance, for firmware updates. In contrast to HTTP, where TCP does the grunt work of segmenting and resequencing, CoAP is based on datagram transports such as UDP or Datagram Transport Layer Security (DTLS). These transports only offer fragmentation, which is even more problematic in constrained nodes and networks, limiting the maximum size of resource representations that can practically be transferred. Instead of relying on IP fragmentation, this specification extends basic CoAP with a pair of "Block" options for transferring multiple blocks of information from a resource representation in multiple request-response pairs. In many important cases, the Block options enable a server to be truly stateless: the server can handle each block transfer separately, with no need for a connection setup or other server-side memory of previous block transfers. Essentially, the Block options provide a minimal way to transfer larger representations in a block-wise fashion. A CoAP implementation that does not support these options generally is limited in the size of the representations that can be exchanged, so there is an expectation that the Block options will be widely used in CoAP implementations. Therefore, this specification updates RFC 7252. Guidelines for Mapping Implementations: HTTP to the Constrained Application Protocol (CoAP) This document provides reference information for implementing a cross-protocol network proxy that performs translation from the HTTP protocol to the Constrained Application Protocol (CoAP). This will enable an HTTP client to access resources on a CoAP server through the proxy. This document describes how an HTTP request is mapped to a CoAP request and how a CoAP response is mapped back to an HTTP response. This includes guidelines for status code, URI, and media type mappings, as well as additional interworking advice. CBOR Web Token (CWT) CBOR Web Token (CWT) is a compact means of representing claims to be transferred between two parties. The claims in a CWT are encoded in the Concise Binary Object Representation (CBOR), and CBOR Object Signing and Encryption (COSE) is used for added application-layer security protection. A claim is a piece of information asserted about a subject and is represented as a name/value pair consisting of a claim name and a claim value. CWT is derived from JSON Web Token (JWT) but uses CBOR rather than JSON. The Datagram Transport Layer Security (DTLS) Protocol Version 1.3 This document specifies version 1.3 of the Datagram Transport Layer Security (DTLS) protocol. DTLS 1.3 allows client/server applications to communicate over the Internet in a way that is designed to prevent eavesdropping, tampering, and message forgery. The DTLS 1.3 protocol is based on the Transport Layer Security (TLS) 1.3 protocol and provides equivalent security guarantees with the exception of order protection / non-replayability. Datagram semantics of the underlying transport are preserved by the DTLS protocol. This document obsoletes RFC 6347. Authentication and Authorization for Constrained Environments Using the OAuth 2.0 Framework (ACE-OAuth) This specification defines a framework for authentication and authorization in Internet of Things (IoT) environments called ACE-OAuth. The framework is based on a set of building blocks including OAuth 2.0 and the Constrained Application Protocol (CoAP), thus transforming a well-known and widely used authorization solution into a form suitable for IoT devices. Existing specifications are used where possible, but extensions are added and profiles are defined to better serve the IoT use cases. Key Provisioning for Group Communication Using Authentication and Authorization for Constrained Environments (ACE) This document defines how to use the Authentication and Authorization for Constrained Environments (ACE) framework to distribute keying material and configuration parameters for secure group communication. Candidate group members that act as Clients and are authorized to join a group can do so by interacting with a Key Distribution Center (KDC) acting as the Resource Server, from which they obtain the keying material to communicate with other group members. While defining general message formats as well as the interface and operations available at the KDC, this document supports different approaches and protocols for secure group communication. Therefore, details are delegated to separate application profiles of this document as specialized instances that target a particular group communication approach and define how communications in the group are protected. Compliance requirements for such application profiles are also specified. On the Joint Security of Encryption and Signature in EMV On using the same key pair for Ed25519 and an X25519 based KEM Improving Awareness of Running Code: The Implementation Status Section This document describes a simple process that allows authors of Internet-Drafts to record the status of known implementations by including an Implementation Status section. This will allow reviewers and working groups to assign due consideration to documents that have the benefit of running code, which may serve as evidence of valuable experimentation and feedback that have made the implemented protocols more mature. This process is not mandatory. Authors of Internet-Drafts are encouraged to consider using the process for their documents, and working groups are invited to think about applying the process to all of their protocol specifications. This document obsoletes RFC 6982, advancing it to a Best Current Practice.

Assumptions and Security Objectives This section presents a set of assumptions and security objectives for the protocol described in this document. The rest of this section refers to three types of groups:

Application group, i.e., a set of CoAP endpoints that share a common pool of resources.
Security group, as defined in of this document. There can be a one-to-one or a one-to-many relation between security groups and application groups, and vice versa.
CoAP group, i.e., a set of CoAP endpoints where each endpoint is configured to receive one-to-many CoAP requests, e.g., sent to the group's associated IP multicast address and UDP port as defined in . An endpoint may be a member of multiple CoAP groups. There can be a one-to-one or a one-to-many relation between application groups and CoAP groups. Note that a device sending a CoAP request to a CoAP group is not necessarily itself a member of that group: it is a member only if it also has a CoAP server endpoint listening to requests for this CoAP group, sent to the associated IP multicast address and port. In order to provide secure group communication, all members of a CoAP group as well as all further endpoints configured only as clients sending CoAP (multicast) requests to the CoAP group have to be member of a security group. There can be a one-to-one or a one-to-many relation between security groups and CoAP groups, and vice versa.

Assumptions The following points are assumed to be already addressed and are out of the scope of this document.

Multicast communication topology: this document considers both 1-to-N (one sender and multiple recipients) and M-to-N (multiple senders and multiple recipients) communication topologies. The 1-to-N communication topology is the simplest group communication scenario that would serve the needs of a typical Low-power and Lossy Network (LLN). Examples of use cases that benefit from secure group communication are provided in . In a 1-to-N communication model, only a single client transmits data to the CoAP group, in the form of request messages; in an M-to-N communication model (where M and N do not necessarily have the same value), M clients transmit data to the CoAP group. According to , any possible proxy entity is supposed to know about the clients. Also, every client expects and is able to handle multiple response messages associated with a same request sent to the CoAP group.
Group size: security solutions for group communication should be able to adequately support different and possibly large security groups. The group size is the current number of members in a security group. In the use cases mentioned in this document, the number of clients (normally the controlling devices) is expected to be much smaller than the number of servers (i.e., the controlled devices). A security solution for group communication that supports 1 to 50 clients would be able to properly cover the group sizes required for most use cases that are relevant for this document. The maximum group size is expected to be in the range of hundreds to thousands of devices, with large groups easier to manage if including several silent servers. Security groups larger than that should be divided into smaller independent groups. One should not assume that the set of members of a security group remains fixed. That is, the group membership is subject to changes, possibly on a frequent basis.
Communication with the Group Manager: an endpoint must use a secure dedicated channel when communicating with the Group Manager, also when not registered as a member of the security group.
Provisioning and management of Security Contexts: a Security Context must be established among the members of the security group. A secure mechanism must be used to generate, revoke and (re-)distribute keying material, communication policies and security parameters in the security group. The actual provisioning and management of the Security Context is out of the scope of this document.
Multicast data security cipher suite: all members of a security group must use the same cipher suite to provide authenticity, integrity and confidentiality of messages in the group. The cipher suite is specified as part of the Security Context.
Ensuring backward security: a new device joining the security group should not have access to any old Security Contexts used before its joining. This ensures that a new member of the security group is not able to decrypt confidential data sent before it has joined the security group. The adopted key management scheme should ensure that the Security Context is updated to ensure backward confidentiality. The actual mechanism to update the Security Context and renew the group keying material in the security group upon a new member's joining has to be defined as part of the group key management scheme.
Ensuring forward security: entities that leave the security group should not have access to any future Security Contexts or message exchanged within the security group after their leaving. This ensures that a former member of the security group is not able to decrypt confidential data sent within the security group anymore. Also, it ensures that a former member is not able to send protected messages to the security group anymore. The actual mechanism to update the Security Context and renew the group keying material in the security group upon a member's leaving has to be defined as part of the group key management scheme.

Security Objectives The protocol described in this document aims at fulfilling the following security objectives:

Data replay protection: request messages or response messages replayed within the security group must be detected.
Data confidentiality: messages sent within the security group shall be encrypted.
Group-level data confidentiality: the group mode provides group-level data confidentiality since messages are encrypted at a group level, i.e., in such a way that they can be decrypted by any member of the security group, but not by an external adversary or other external entities.
Pairwise data confidentiality: the pairwise mode especially provides pairwise data confidentiality, since messages are encrypted using pairwise keying material shared between any two group members, hence they can be decrypted only by the intended single recipient.
Source message authentication: messages sent within the security group shall be authenticated. That is, it is essential to ensure that a message is originated by a member of the security group in the first place, and in particular by a specific, identifiable member of the security group.
Message integrity: messages sent within the security group shall be integrity protected. That is, it is essential to ensure that a message has not been tampered with, either by a group member, or by an external adversary or other external entities which are not members of the security group.
Message ordering: it must be possible to determine the ordering of messages coming from a single sender. Like in OSCORE , a recipient endpoint can determine the relative order of requests or responses from another sender endpoint by means of their Partial IV. It is not required to determine ordering of messages from different senders.

List of Use Cases Group Communication for CoAP provides the necessary background for multicast-based CoAP communication, with particular reference to low-power and lossy networks (LLNs) and resource constrained environments. The interested reader is encouraged to first read to understand the non-security related details. This section discusses a number of use cases that benefit from secure group communication, and refers to the three types of groups from . Specific security requirements for these use cases are discussed in .

Lighting control: consider a building equipped with IP-connected lighting devices, switches, and border routers. The lighting devices acting as servers are organized into application groups and CoAP groups, according to their physical location in the building. For instance, lighting devices in a room or corridor can be configured as members of a single application group and corresponding CoAP group. Those lighting devices together with the switches acting as clients in the same room or corridor can be configured as members of the corresponding security group. Switches are then used to control the lighting devices by sending on/off/dimming commands to all lighting devices in the CoAP group, while border routers connected to an IP network backbone (which is also multicast-enabled) can be used to interconnect routers in the building. Consequently, this would also enable logical groups to be formed even if devices with a role in the lighting application may be physically in different subnets (e.g., on wired and wireless networks). Connectivity between lighting devices may be realized, for instance, by means of IPv6 and (border) routers supporting 6LoWPAN . Group communication enables synchronous operation of a set of connected lights, ensuring that the light preset (e.g., dimming level or color) of a large set of luminaires are changed at the same perceived time. This is especially useful for providing a visual synchronicity of light effects to the user. As a practical guideline, events within a 200 ms interval are perceived as simultaneous by humans, which is necessary to ensure in many setups. Devices may reply back to the switches that issue on/off/dimming commands, in order to report about the execution of the requested operation (e.g., OK, failure, error) and their current operational status. In a typical lighting control scenario, a single switch is the only entity responsible for sending commands to a set of lighting devices. In more advanced lighting control use cases, an M-to-N communication topology would be required, for instance in case multiple sensors (presence or day-light) are responsible to trigger events to a set of lighting devices. Especially in professional lighting scenarios, the roles of client and server are configured by the lighting commissioner, and devices strictly follow those roles.
Integrated building control: enabling Building Automation and Control Systems (BACSs) to control multiple heating, ventilation, and air-conditioning units to predefined presets. Controlled units can be organized into application groups and CoAP groups in order to reflect their physical position in the building, e.g., devices in the same room can be configured as members of a single application group and corresponding CoAP group. As a practical guideline, events within intervals of seconds are typically acceptable. Controlled units are expected to possibly reply back to the BACS issuing control commands, in order to report about the execution of the requested operation (e.g., OK, failure, error) and their current operational status.
Software and firmware updates: software and firmware updates often comprise quite a large amount of data. This can overload a Low-power and Lossy Network (LLN) that is otherwise typically used to deal with only small amounts of data, on an infrequent base. Rather than sending software and firmware updates as unicast messages to each individual device, multicasting such updated data to a larger set of devices at once displays a number of benefits. For instance, it can significantly reduce the network load and decrease the overall time latency for propagating this data to all devices. Even if the complete whole update process itself is secured, securing the individual messages is important, in case updates consist of relatively large amounts of data. In fact, checking individual received data piecemeal for tampering avoids that devices store large amounts of partially corrupted data and that they detect tampering hereof only after all data has been received. Devices receiving software and firmware updates are expected to possibly reply back, in order to provide a feedback about the execution of the update operation (e.g., OK, failure, error) and their current operational status.
Parameter and configuration update: by means of multicast communication, it is possible to update the settings of a set of similar devices, both simultaneously and efficiently. Possible parameters are related, for instance, to network load management or network access control. Devices receiving parameter and configuration updates are expected to possibly reply back, to provide a feedback about the execution of the update operation (e.g., OK, failure, error) and their current operational status.
Commissioning of Low-power and Lossy Network (LLN) systems: a commissioning device is responsible for querying all devices in the local network or a selected subset of them, in order to discover their presence, and be aware of their capabilities, default configuration, and operating conditions. Queried devices displaying similarities in their capabilities and features, or sharing a common physical location can be configured as members of a single application group and corresponding CoAP group. Queried devices are expected to reply back to the commissioning device, in order to notify their presence, and provide the requested information and their current operational status.
Emergency multicast: a particular emergency-related information (e.g., natural disaster) is generated and multicast by an emergency notifier, and relayed to multiple devices. The latter may reply back to the emergency notifier, in order to provide their feedback and local information related to the ongoing emergency. This kind of setups should additionally rely on a fault-tolerant multicast algorithm, such as Multicast Protocol for Low-Power and Lossy Networks (MPL).

Example of Group Identifier Format This section provides an example of how the Group Identifier (Gid) can be formatted. That is, the Gid can be composed of two parts, namely a Group Prefix and a Group Epoch. For each group, the Group Prefix is constant over time and is uniquely defined in the set of all the groups associated with the same Group Manager. The choice of the Group Prefix for a given group's Security Context is application specific. The size of the Group Prefix directly impact on the maximum number of distinct groups under the same Group Manager. The Group Epoch is set to 0 upon the group's initialization, and is incremented by 1 each time new keying material, together with a new Gid, is distributed to the group in order to establish a new Security Context (see ). As an example, a 3-byte Gid can be composed of: i) a 1-byte Group Prefix '0xb1' interpreted as a raw byte string; and ii) a 2-byte Group Epoch interpreted as an unsigned integer ranging from 0 to 65535. Then, after having established the Common Context 61532 times in the group, its Gid will assume value '0xb1f05c'. Using an immutable Group Prefix for a group with a Group Manager that does not reassign Gid values (see ) limits the total number of rekeying instances. With a Group Manager that does reassign Gid values, it limits the maximum active number of rekeying instances that a CoAP observation can persist through. In either case, the group epoch size needs to be chosen depending on the expected rate of rekeying instances. As discussed in , if endpoints are deployed in multiple groups managed by different non-synchronized Group Managers, it is possible that Group Identifiers of different groups coincide at some point in time. In this case, a recipient has to handle coinciding Group Identifiers, and has to try using different Security Contexts to process an incoming message, until the right one is found and the message is correctly verified. Therefore, it is favorable that Group Identifiers from different Group Managers have a size that result in a small probability of collision. How small this probability should be is up to system designers.

Responsibilities of the Group Manager The Group Manager is responsible for performing the following tasks:

Creating and managing OSCORE groups. This includes the assignment of a Gid to every newly created group, ensuring uniqueness of Gids within the set of its OSCORE groups and, optionally, the secure recycling of Gids.
Defining policies for authorizing the joining of its OSCORE groups.
Handling the join process to add new endpoints as group members.
Establishing the Common Context part of the Security Context, and providing it to authorized group members during the join process, together with the corresponding Sender Context.
Updating the Key Generation Number and the Gid of its OSCORE groups, upon renewing the respective Security Context.
Generating and managing Sender IDs within its OSCORE groups, as well as assigning and providing them to new endpoints during the join process, or to current group members upon request of renewal or re-joining. This includes ensuring that:
- Each Sender ID is unique within each of the OSCORE groups;
- Each Sender ID is not reassigned within the same group since the latest time when the current Gid value was assigned to the group. That is, the Sender ID is not reassigned even to a current group member re-joining the same group, without a rekeying happening first.
Defining communication policies for each of its OSCORE groups, and signaling them to new endpoints during the join process.
Renewing the Security Context of an OSCORE group upon membership change, by revoking and renewing common security parameters and keying material (rekeying).
Providing the management keying material that a new endpoint requires to participate in the rekeying process, consistently with the key management scheme used in the group joined by the new endpoint.
Assisting a group member that has missed a group rekeying instance to understand which authentication credentials and Recipient Contexts to delete, as associated with former group members.
Acting as key repository, in order to handle the authentication credentials of the members of its OSCORE groups, and providing such authentication credentials to other members of the same group upon request. The actual storage of authentication credentials may be entrusted to a separate secure storage device or service.
Validating that the format and parameters of authentication credentials of group members are consistent with the public key algorithm and related parameters used in the respective OSCORE group.

The Group Manager specified in provides this functionality.

Document Updates

Version -26 to -27

Clarified "SHOULD" for the Group Manager's authentication credential having the same format of that of the group members.
Avoid unnecessary details on Sequence Number wrap-around.
Clarified that using unreliable transports must not forego congestion control.
Clarified means for the Group Manager to determine compromised group members.
Normative "SHOULD" for preserving current Sender IDs upon group rekeying.
Updated security considerations:
- Explicit list of security properties of the pairwise mode.
- Clarified group-level data confidentiality in the group mode.
- Explicit list of security properties not aimed to be met.
- Security considerations on treating opaque binary data as such.
Minor clarifications and editorial improvements.

Version -25 to -26

Terminology for Security Context: avoid "immutable"; use "long-term" and "varying".
Reference on achieving proof of possession for group members and Group Manager.
Not only CWTs but also CCSs can be tagged.
Exceptional handling after deleting a Recipient Context.
Clearer handling of incoming messages if the Replay Window is invalid.
The exhaustion of Sender Sequence Numbers should be handled with margin.
Highlighted overhead for accepting out-of-order responses within a long exchange.
Generalization of exceptions to behaviors that are defined as SHOULD.
Clearer phrasing for the requirement on early signature verification.
Clearer generalization of delivery of messages protected in pairwise mode.
Generalized use of the Block2 Option in protected (group) requests.
Clearer statements on implementation compliance.
Suggested means for silent servers to make Replay Windows valid again.
Optional procedure for reassigning Gids moved to the document body.
Specific definition of reassignment of Sender IDs in a group.
Discussed server-side mitigations against unicast requests protected in group mode.
Removed hypothetical discussions on alternative protocol designs.
Discussion on Denial of Service moved to security considerations.
Expanded considerations on leakage of Diffie-Hellman shared secret.
Editorial clarifications and fixes.

Version -24 to -25

Made RFC 5869 a normative reference.
Removed request to add a note in the "CoAP Option Numbers" registry.
More precise phrasing on using the encryption nonce.

Version -23 to -24

Added section "Implementation Status", according to RFC 7942.
Fixed "P-521" (instead of "P-512").

Version -22 to -23

Examples of non-AEAD algorithms as Group Encryption Algorithm.
Implementation compliance on non-AEAD algorithms.
Clarified that the HKDF Algorithm must be an HMAC-based HKDF.
Easier description of using Common IV to compute the nonce.
Consistent use of "nonce", "key", and "AEAD key".
Repositioned content about the Group Manager.
Editorial improvements.

Version -21 to -22

Removed mentioning of the CBOR encoding of the HKDF Algorithm.
Rephrased consequences on loss of Recipient Contexts.
Removed requirement on 0 as initial value of the Key Generation Number.
Improved handling of responses from a server that changes Sender ID.
Relax constrictions of Block-wise with group communication.
Removed the concept of synchronization with the Client's Sender Sequence Number.
Improved content on Challenge-Response based freshness and Replay Window recovery.
Use the acronym CCSs for CWT Claims Sets.
Mentioned wrap-around of the Key Generation Number.
Added IANA consideration on the "CoAP Option Numbers" registry.
Updated references.
Editorial improvements.

Version -20 to -21

Updated author list.
Terminology: improved definition of "group request".
Editorial: removed quotation marks when using the CBOR simple values true, false, and null.
Editorial: expanded name of the "CoRE Parameters" registry group.

Version -19 to -20

Change Controller for the target attribute "gosc" set to "IETF".

Version -18 to -19

Unified presentation of handling of multiple responses.
Added Rikard Höglund as Contributor.

Version -17 to -18

Changed document title.
Possible use with CoAP-mappable HTTP.
Added Common Context parameter "Authentication Credential Format".
Renamed "Group Encryption Key" to "Signature Encryption Key". Consistent fixes in its derivation.
Renamed "Signature Encryption Algorithm" to "Group Encryption Algorithm".
Ensured a single Common IV, also when the two encryption algorithms have different nonce sizes.
Guidelines on the Pairwise Key Agreement Algorithm and derivation of the Diffie-Hellman secret.
The possible use of a mode follows from the set parameters.
The Group Manager is always present; 'gm_cred' in the external_aad cannot be null anymore.
The authentication credential of the Group Manager can have a different format than that of the group members'.
Set-up of new endpoints moved to document body.
The encrypted countersignature is a result of the header compression, not of COSE.
Revised examples of compressed and non-compressed COSE object.
Removed excessive requirements on group rekeying scheduling.
More considerations on the strictness of group key management.
Clearer alternatives on retaining an old Security Context.
Revised used of terminology on freshness.
Clarifications, fixes and editorial improvements.

Version -16 to -17

Definition and registration of the target attribute "gosc".
Reference update and editorial fixes.

Version -15 to -16

Clients "SHOULD" use the group mode for one-to-many requests.
Handling of multiple non-notification responses.
Revised presentation of security properties.
Improved listing of operations defined for the group mode that are inherited by the pairwise mode.
Editorial improvements.

Version -14 to -15

Updated references and editorial fixes.

Version -13 to -14

Replaced "node" with "endpoint" where appropriate.
Replaced "owning" with "storing" (of keying material).
Distinction between "authentication credential" and "public key".
Considerations on storing whole authentication credentials.
Considerations on Denial of Service.
Recycling of Group IDs by tracking the "Birth Gid" of each group member is now optional to support and use for the Group Manager.
Fine-grained suppression of error responses.
Changed section title "Mandatory-to-Implement Compliance Requirements" to "Implementation Compliance".
"Challenge-Response Synchronization" moved to the document body.
RFC 7641 and draft-ietf-core-echo-request-tag as normative references.
Clarifications and editorial improvements.

Version -12 to -13

Fixes in the derivation of the Group Encryption Key.
Added Mandatory-to-Implement compliance requirements.
Changed UCCS to CCS.

Version -11 to -12

No mode of operation is mandatory to support.
Revised parameters of the Security Context, COSE object and external_aad.
Revised management of keying material for the Group Manager.
Informing of former members when rekeying the group.
Admit encryption-only algorithms in group mode.
Encrypted countersignature through a keystream.
Added public key of the Group Manager as key material and protected data.
Clarifications about message processing, especially notifications.
Guidance for message processing of external signature checkers.
Updated derivation of pairwise keys, with more security considerations.
Termination of ongoing observations as client, upon leaving or before re-joining the group.
Recycling Group IDs by tracking the "Birth Gid" of each group member.
Expanded security and privacy considerations about the group mode.
Removed appendices on skipping signature verification and on COSE capabilities.
Fixes and editorial improvements.

Version -10 to -11

Loss of Recipient Contexts due to their overflow.
Added diagram on keying material components and their relation.
Distinction between anti-replay and freshness.
Preservation of Sender IDs over rekeying.
Clearer cause-effect about reset of SSN.
The GM provides public keys of group members with associated Sender IDs.
Removed 'par_countersign_key' from the external_aad.
One single format for the external_aad, both for encryption and signing.
Presence of 'kid' in responses to requests protected in pairwise mode.
Inclusion of 'kid_context' in notifications following a group rekeying.
Pairwise mode presented with OSCORE as baseline.
Revised examples with signature values.
Decoupled growth of clients' Sender Sequence Numbers and loss of synchronization for server.
Sender IDs not recycled in the group under the same Gid.
Processing and description of the Group Flag bit in the OSCORE Option.
Usage of the pairwise mode for multicast requests.
Clarifications on synchronization using the Echo Option.
General format of context parameters and external_aad elements, supporting future registered COSE algorithms (new Appendix).
Fixes and editorial improvements.

Version -09 to -10

Removed 'Counter Signature Key Parameters' from the Common Context.
New parameters in the Common Context covering the DH secret derivation.
New countersignature header parameter from draft-ietf-cose-countersign.
Stronger policies non non-recycling of Sender IDs and Gid.
The Sender Sequence Number is reset when establishing a new Security Context.
Added 'request_kid_context' in the aad_array.
The server can respond with 5.03 if the client's public key is not available.
The observer client stores an invariant identifier of the group.
Relaxed storing of original 'kid' for observer clients.
Both client and server store the 'kid_context' of the original observation request.
The server uses a fresh PIV if protecting the response with a Security Context different from the one used to protect the request.
Clarifications on MTI algorithms and curves.
Removed optimized requests.
Overall clarifications and editorial revision.

Version -08 to -09

Pairwise keys are discarded after group rekeying.
Signature mode renamed to group mode.
The parameters for countersignatures use the updated COSE registries. Newly defined IANA registries have been removed.
Pairwise Flag bit renamed as Group Flag bit, set to 1 in group mode and set to 0 in pairwise mode.
Dedicated section on updating the Security Context.
By default, sender sequence numbers and replay windows are not reset upon group rekeying.
An endpoint implementing only a silent server does not support the pairwise mode.
Separate section on general message reception.
Pairwise mode moved to the document body.
Considerations on using the pairwise mode in non-multicast settings.
Optimized requests are moved as an appendix.
Normative support for the signature and pairwise mode.
Revised methods for synchronization with clients' sender sequence number.
Appendix with example values of parameters for countersignatures.
Clarifications and editorial improvements.

Version -07 to -08

Clarified relation between pairwise mode and group communication (Section 1).
Improved definition of "silent server" (Section 1.1).
Clarified when a Recipient Context is needed (Section 2).
Signature checkers as entities supported by the Group Manager (Section 2.3).
Clarified that the Group Manager is under exclusive control of Gid and Sender ID values in a group, with Sender ID values under each Gid value (Section 2.3).
Mitigation policies in case of recycled 'kid' values (Section 2.4).
More generic exhaustion (not necessarily wrap-around) of sender sequence numbers (Sections 2.5 and 10.11).
Pairwise key considerations, as to group rekeying and Sender Sequence Numbers (Section 3).
Added reference to static-static Diffie-Hellman shared secret (Section 3).
Note for implementation about the external_aad for signing (Sectino 4.3.2).
Retransmission by the application for group requests over multicast as Non-confirmable (Section 7).
A server MUST use its own Partial IV in a response, if protecting it with a different context than the one used for the request (Section 7.3).
Security considerations: encryption of pairwise mode as alternative to group-level security (Section 10.1).
Security considerations: added approach to reduce the chance of global collisions of Gid values from different Group Managers (Section 10.5).
Security considerations: added implications for block-wise transfers when using the signature mode for requests over unicast (Section 10.7).
Security considerations: (multiple) supported signature algorithms (Section 10.13).
Security considerations: added privacy considerations on the approach for reducing global collisions of Gid values (Section 10.15).
Updates to the methods for synchronizing with clients' sequence number (Appendix E).
Simplified text on discovery services supporting the pairwise mode (Appendix G.1).
Editorial improvements.

Version -06 to -07

Updated abstract and introduction.
Clarifications of what pertains a group rekeying.
Derivation of pairwise keying material.
Content re-organization for COSE Object and OSCORE header compression.
Defined the Pairwise Flag bit for the OSCORE Option.
Supporting CoAP Observe for group requests and responses.
Considerations on message protection across switching to new keying material.
New optimized mode based on pairwise keying material.
More considerations on replay protection and Security Contexts upon key renewal.
Security considerations on Group OSCORE for unicast requests, also as affecting the usage of the Echo Option.
Clarification on different types of groups considered (application/security/CoAP).
New pairwise mode, using pairwise keying material for both requests and responses.

Version -05 to -06

Group IDs mandated to be unique under the same Group Manager.
Clarifications on parameter update upon group rekeying.
Updated external_aad structures.
Dynamic derivation of Recipient Contexts made optional and application specific.
Optional 4.00 response for failed signature verification on the server.
Removed client handling of duplicated responses to multicast requests.
Additional considerations on public key retrieval and group rekeying.
Added Group Manager responsibility on validating public keys.
Updates IANA registries.
Reference to RFC 8613.
Editorial improvements.

Version -04 to -05

Added references to draft-dijk-core-groupcomm-bis.
New parameter Counter Signature Key Parameters (Section 2).
Clarification about Recipient Contexts (Section 2).
Two different external_aad for encrypting and signing (Section 3.1).
Updated response verification to handle Observe notifications (Section 6.4).
Extended Security Considerations (Section 8).
New "Counter Signature Key Parameters" IANA Registry (Section 9.2).

Version -03 to -04

Added the new "Counter Signature Parameters" in the Common Context (see Section 2).
Added recommendation on using "deterministic ECDSA" if ECDSA is used as countersignature algorithm (see Section 2).
Clarified possible asynchronous retrieval of keying material from the Group Manager, in order to process incoming messages (see Section 2).
Structured Section 3 into subsections.
Added the new 'par_countersign' to the aad_array of the external_aad (see Section 3.1).
Clarified non reliability of 'kid' as identity identifier for a group member (see Section 2.1).
Described possible provisioning of new Sender ID in case of Partial IV wrap-around (see Section 2.2).
The former signature bit in the Flag Byte of the OSCORE Option value is reverted to reserved (see Section 4.1).
Updated examples of compressed COSE object, now with the sixth less significant bit in the Flag Byte of the OSCORE Option value set to 0 (see Section 4.3).
Relaxed statements on sending error messages (see Section 6).
Added explicit step on computing the countersignature for outgoing messages (see Sections 6.1 and 6.3).
Handling of just created Recipient Contexts in case of unsuccessful message verification (see Sections 6.2 and 6.4).
Handling of replied/repeated responses on the client (see Section 6.4).
New IANA Registry "Counter Signature Parameters" (see Section 9.1).

Version -02 to -03

Revised structure and phrasing for improved readability and better alignment with draft-ietf-core-object-security.
Added discussion on wrap-Around of Partial IVs (see Section 2.2).
Separate sections for the COSE Object (Section 3) and the OSCORE Header Compression (Section 4).
The countersignature is now appended to the encrypted payload of the OSCORE message, rather than included in the OSCORE Option (see Section 4).
Extended scope of Section 5, now titled " Message Binding, Sequence Numbers, Freshness and Replay Protection".
Clarifications about Non-confirmable messages in Section 5.1 "Synchronization of Sender Sequence Numbers".
Clarifications about error handling in Section 6 "Message Processing".
Compacted list of responsibilities of the Group Manager in Section 7.
Revised and extended security considerations in Section 8.
Added IANA considerations for the OSCORE Flag Bits Registry in Section 9.
Revised Appendix D, now giving a short high-level description of a new endpoint set-up.

Version -01 to -02

Terminology has been made more aligned with RFC7252 and draft-ietf-core-object-security: i) "client" and "server" replace the old "multicaster" and "listener", respectively; ii) "silent server" replaces the old "pure listener".
Section 2 has been updated to have the Group Identifier stored in the 'ID Context' parameter defined in draft-ietf-core-object-security.
Section 3 has been updated with the new format of the Additional Authenticated Data.
Major rewriting of Section 4 to better highlight the differences with the message processing in draft-ietf-core-object-security.
Added Sections 7.2 and 7.3 discussing security considerations about uniqueness of (key, nonce) and collision of group identifiers, respectively.
Minor updates to Appendix A.1 about assumptions on multicast communication topology and group size.
Updated Appendix C on format of group identifiers, with practical implications of possible collisions of group identifiers.
Updated Appendix D.2, adding a pointer to draft-palombini-ace-key-groupcomm about retrieval of nodes' public keys through the Group Manager.
Minor updates to Appendix E.3 about Challenge-Response synchronization of sequence numbers based on the Echo Option from draft-ietf-core-echo-request-tag.

Version -00 to -01

Section 1.1 has been updated with the definition of group as "security group".
Section 2 has been updated with:
- Clarifications on establishment/derivation of Security Contexts.
- A table summarizing the the additional context elements compared to OSCORE.
Section 3 has been updated with:
- Examples of request and response messages.
- Use of CounterSignature0 rather than CounterSignature.
- Additional Authenticated Data including also the signature algorithm, while not including the Group Identifier any longer.
Added Section 6, listing the responsibilities of the Group Manager.
Added Appendix A (former section), including assumptions and security objectives.
Appendix B has been updated with more details on the use cases.
Added Appendix C, providing an example of Group Identifier format.
Appendix D has been updated to be aligned with draft-palombini-ace-key-groupcomm.

Acknowledgments Jiye Park contributed as a co-author of initial versions of this document. The authors sincerely thank , , , , , , , , , , , , , , , , , and for their feedback and comments. The work on this document has been partly supported by the Sweden's Innovation Agency VINNOVA and the Celtic-Next projects CRITISEC and CYPRESS; the H2020 projects SIFIS-Home (Grant agreement 952652) and ARCADIAN-IoT (Grant agreement 101020259); the SSF project SEC4Factory under the grant RIT17-0032; and the EIT-Digital High Impact Initiative ACTIVE.