Internet Assigned Numbers Authority CBOR Object Signing and Encryption (COSE) Created 2017-01-11 Last Updated 2022-12-14 Available Formats [IMG] XML [IMG] HTML [IMG] Plain text Registries included below * COSE Header Parameters * COSE Header Algorithm Parameters * COSE Algorithms * COSE Key Common Parameters * COSE Key Type Parameters * COSE Key Types * COSE Elliptic Curves COSE Header Parameters Expert(s) Francesca Palombini, Matt Miller, Justin Richer, Carsten Bormann Reference [RFC9052] Available Formats [IMG] CSV Range Registration Procedures Integer values in the range -1 to -65536 delegated to the COSE Header Algorithm Parameters registry Integer values between 1 and 255 Standards Action With Expert Review Integer values from 256 to 65535 Specification Required Integer values greater than 65535 Expert Review Strings of length 1 Standards Action With Expert Review Strings of length 2 Specification Required Strings of length greater than 2 Expert Review Name Label Value Type Value Registry Description Reference Reserved for Private Use less than [RFC9052] -65536 delegated to the COSE -65536 to Header Algorithm -1 Parameters registry Reserved 0 [RFC9052] alg 1 int / tstr COSE Algorithms Cryptographic algorithm to use [RFC9052] registry crit 2 [+ label] COSE Header Parameters Critical headers to be understood [RFC9052] registry [COAP Content-Formats] content type 3 tstr / uint or [Media Types] Content type of the payload [RFC9052] registry kid 4 bstr Key identifier [RFC9052] IV 5 bstr Full Initialization Vector [RFC9052] Partial IV 6 bstr Partial Initialization Vector [RFC9052] counter signature 7 COSE_Signature / [+ CBOR-encoded signature structure [RFC8152] COSE_Signature ] (Deprecated by [RFC9338]) Unassigned 8 Counter signature with implied CounterSignature0 9 bstr signer and headers (Deprecated by [RFC8152] [RFC9338]) kid context 10 bstr Identifies the context for the key [RFC8613, Section 5.1] identifier Countersignature version 11 COSE_Countersignature / [+ V2 countersignature attribute [RFC9338] 2 COSE_Countersignature] Countersignature0 version 12 COSE_Countersignature0 V2 Abbreviated Countersignature [RFC9338] 2 Unassigned 13-31 x5bag 32 COSE_X509 An unordered bag of X.509 [RFC-ietf-cose-x509-09] certificates x5chain 33 COSE_X509 An ordered chain of X.509 [RFC-ietf-cose-x509-09] certificates x5t 34 COSE_CertHash Hash of an X.509 certificate [RFC-ietf-cose-x509-09] x5u 35 uri URI pointing to an X.509 [RFC-ietf-cose-x509-09] certificate Unassigned 36-255 CUPHNonce 256 bstr Challenge Nonce [FIDO Device Onboard Specification] CUPHOwnerPubKey 257 array Public Key [FIDO Device Onboard Specification] COSE Header Algorithm Parameters Registration Procedure(s) Expert Review Expert(s) Göran Selander, Derek Atkins, Sean Turner Reference [RFC9053] Available Formats [IMG] CSV Name Algorithm Label Type Description Reference Unassigned -65536 to -30 x5chain-sender ECDH-SS+HKDF-256, ECDH-SS+HKDF-512, ECDH-SS+A128KW, -29 COSE_X509 static key X.509 [RFC-ietf-cose-x509-09] ECDH-SS+A192KW, ECDH-SS+A256KW certificate chain x5u-sender ECDH-SS+HKDF-256, ECDH-SS+HKDF-512, ECDH-SS+A128KW, -28 uri URI for the sender's [RFC-ietf-cose-x509-09] ECDH-SS+A192KW, ECDH-SS+A256KW X.509 certificate ECDH-SS+HKDF-256, ECDH-SS+HKDF-512, ECDH-SS+A128KW, Thumbprint for the x5t-sender ECDH-SS+A192KW, ECDH-SS+A256KW -27 COSE_CertHash sender's X.509 [RFC-ietf-cose-x509-09] certificate direct+HKDF-SHA-256, direct+HKDF-SHA-512, direct+HKDF-AES-128, direct+HKDF-AES-256, PartyV other ECDH-ES+HKDF-256, ECDH-ES+HKDF-512, ECDH-SS+HKDF-256, -26 bstr Party V other provided [RFC9053] ECDH-SS+HKDF-512, ECDH-ES+A128KW, ECDH-ES+A192KW, information ECDH-ES+A256KW, ECDH-SS+A128KW, ECDH-SS+A192KW, ECDH-SS+A256KW direct+HKDF-SHA-256, direct+HKDF-SHA-512, direct+HKDF-AES-128, direct+HKDF-AES-256, PartyV nonce ECDH-ES+HKDF-256, ECDH-ES+HKDF-512, ECDH-SS+HKDF-256, -25 bstr / int Party V provided nonce [RFC9053] ECDH-SS+HKDF-512, ECDH-ES+A128KW, ECDH-ES+A192KW, ECDH-ES+A256KW, ECDH-SS+A128KW, ECDH-SS+A192KW, ECDH-SS+A256KW direct+HKDF-SHA-256, direct+HKDF-SHA-512, direct+HKDF-AES-128, direct+HKDF-AES-256, PartyV identity ECDH-ES+HKDF-256, ECDH-ES+HKDF-512, ECDH-SS+HKDF-256, -24 bstr Party V identity [RFC9053] ECDH-SS+HKDF-512, ECDH-ES+A128KW, ECDH-ES+A192KW, information ECDH-ES+A256KW, ECDH-SS+A128KW, ECDH-SS+A192KW, ECDH-SS+A256KW direct+HKDF-SHA-256, direct+HKDF-SHA-512, direct+HKDF-AES-128, direct+HKDF-AES-256, PartyU other ECDH-ES+HKDF-256, ECDH-ES+HKDF-512, ECDH-SS+HKDF-256, -23 bstr Party U other provided [RFC9053] ECDH-SS+HKDF-512, ECDH-ES+A128KW, ECDH-ES+A192KW, information ECDH-ES+A256KW, ECDH-SS+A128KW, ECDH-SS+A192KW, ECDH-SS+A256KW direct+HKDF-SHA-256, direct+HKDF-SHA-512, direct+HKDF-AES-128, direct+HKDF-AES-256, PartyU nonce ECDH-ES+HKDF-256, ECDH-ES+HKDF-512, ECDH-SS+HKDF-256, -22 bstr / int Party U provided nonce [RFC9053] ECDH-SS+HKDF-512, ECDH-ES+A128KW, ECDH-ES+A192KW, ECDH-ES+A256KW, ECDH-SS+A128KW, ECDH-SS+A192KW, ECDH-SS+A256KW direct+HKDF-SHA-256, direct+HKDF-SHA-512, direct+HKDF-AES-128, direct+HKDF-AES-256, PartyU identity ECDH-ES+HKDF-256, ECDH-ES+HKDF-512, ECDH-SS+HKDF-256, -21 bstr Party U identity [RFC9053] ECDH-SS+HKDF-512, ECDH-ES+A128KW, ECDH-ES+A192KW, information ECDH-ES+A256KW, ECDH-SS+A128KW, ECDH-SS+A192KW, ECDH-SS+A256KW direct+HKDF-SHA-256, direct+HKDF-SHA-512, direct+HKDF-AES-128, direct+HKDF-AES-256, salt ECDH-ES+HKDF-256, ECDH-ES+HKDF-512, ECDH-SS+HKDF-256, -20 bstr Random salt [RFC9053] ECDH-SS+HKDF-512, ECDH-ES+A128KW, ECDH-ES+A192KW, ECDH-ES+A256KW, ECDH-SS+A128KW, ECDH-SS+A192KW, ECDH-SS+A256KW Unassigned -19 to -4 ECDH-SS+HKDF-256, ECDH-SS+HKDF-512, ECDH-SS+A128KW, Static public key static key id ECDH-SS+A192KW, ECDH-SS+A256KW -3 bstr identifier for the [RFC9053] sender static key ECDH-SS+HKDF-256, ECDH-SS+HKDF-512, ECDH-SS+A128KW, -2 COSE_Key Static public key for [RFC9053] ECDH-SS+A192KW, ECDH-SS+A256KW the sender ephemeral key ECDH-ES+HKDF-256, ECDH-ES+HKDF-512, ECDH-ES+A128KW, -1 COSE_Key Ephemeral public key [RFC9053] ECDH-ES+A192KW, ECDH-ES+A256KW for the sender COSE Algorithms Expert(s) Göran Selander, Derek Atkins, Sean Turner Reference [RFC9053][RFC9054] Available Formats [IMG] CSV Range Registration Procedures Integer values from -65536 to -257 Specification Required Integer values between -256 and 255 Standards Action With Expert Review Integer values from 256 to 65535 Specification Required Integer values greater than 65535 Expert Review Strings of length 1 Standards Action With Expert Review Strings of length 2 Specification Required Strings of length greater than 2 Expert Review Name Value Description Capabilities Change Controller Reference Recommended Reserved for Private Use less than [RFC9053] No -65536 Unassigned -65536 RS1 -65535 RSASSA-PKCS1-v1_5 using SHA-1 [kty] IESG [RFC8812][RFC9053] Deprecated Unassigned -65534 to -261 WalnutDSA -260 WalnutDSA signature [kty] [RFC9021][RFC9053] No RS512 -259 RSASSA-PKCS1-v1_5 using SHA-512 [kty] IESG [RFC8812][RFC9053] No RS384 -258 RSASSA-PKCS1-v1_5 using SHA-384 [kty] IESG [RFC8812][RFC9053] No RS256 -257 RSASSA-PKCS1-v1_5 using SHA-256 [kty] IESG [RFC8812][RFC9053] No Unassigned -256 to -48 ES256K -47 ECDSA using secp256k1 curve and [kty] IESG [RFC8812][RFC9053] No SHA-256 HSS-LMS -46 HSS/LMS hash-based digital signature [kty] [RFC8778][RFC9053] Yes SHAKE256 -45 SHAKE-256 512-bit Hash Value [kty] [RFC9054][RFC9053] Yes SHA-512 -44 SHA-2 512-bit Hash [kty] [RFC9054][RFC9053] Yes SHA-384 -43 SHA-2 384-bit Hash [kty] [RFC9054][RFC9053] Yes RSAES-OAEP w/ SHA-512 -42 RSAES-OAEP w/ SHA-512 [kty] [RFC8230][RFC9053] Yes RSAES-OAEP w/ SHA-256 -41 RSAES-OAEP w/ SHA-256 [kty] [RFC8230][RFC9053] Yes RSAES-OAEP w/ RFC 8017 default -40 RSAES-OAEP w/ SHA-1 [kty] [RFC8230][RFC9053] Yes parameters PS512 -39 RSASSA-PSS w/ SHA-512 [kty] [RFC8230][RFC9053] Yes PS384 -38 RSASSA-PSS w/ SHA-384 [kty] [RFC8230][RFC9053] Yes PS256 -37 RSASSA-PSS w/ SHA-256 [kty] [RFC8230][RFC9053] Yes ES512 -36 ECDSA w/ SHA-512 [kty] [RFC9053] Yes ES384 -35 ECDSA w/ SHA-384 [kty] [RFC9053] Yes ECDH-SS + A256KW -34 ECDH SS w/ Concat KDF and AES Key [kty] [RFC9053] Yes Wrap w/ 256-bit key ECDH-SS + A192KW -33 ECDH SS w/ Concat KDF and AES Key [kty] [RFC9053] Yes Wrap w/ 192-bit key ECDH-SS + A128KW -32 ECDH SS w/ Concat KDF and AES Key [kty] [RFC9053] Yes Wrap w/ 128-bit key ECDH-ES + A256KW -31 ECDH ES w/ Concat KDF and AES Key [kty] [RFC9053] Yes Wrap w/ 256-bit key ECDH-ES + A192KW -30 ECDH ES w/ Concat KDF and AES Key [kty] [RFC9053] Yes Wrap w/ 192-bit key ECDH-ES + A128KW -29 ECDH ES w/ Concat KDF and AES Key [kty] [RFC9053] Yes Wrap w/ 128-bit key ECDH-SS + HKDF-512 -28 ECDH SS w/ HKDF - generate key [kty] [RFC9053] Yes directly ECDH-SS + HKDF-256 -27 ECDH SS w/ HKDF - generate key [kty] [RFC9053] Yes directly ECDH-ES + HKDF-512 -26 ECDH ES w/ HKDF - generate key [kty] [RFC9053] Yes directly ECDH-ES + HKDF-256 -25 ECDH ES w/ HKDF - generate key [kty] [RFC9053] Yes directly Unassigned -24 to -19 SHAKE128 -18 SHAKE-128 256-bit Hash Value [kty] [RFC9054][RFC9053] Yes SHA-512/256 -17 SHA-2 512-bit Hash truncated to [kty] [RFC9054][RFC9053] Yes 256-bits SHA-256 -16 SHA-2 256-bit Hash [kty] [RFC9054][RFC9053] Yes SHA-256/64 -15 SHA-2 256-bit Hash truncated to [kty] [RFC9054][RFC9053] Filter Only 64-bits SHA-1 -14 SHA-1 Hash [kty] [RFC9054][RFC9053] Filter Only direct+HKDF-AES-256 -13 Shared secret w/ AES-MAC 256-bit key [kty] [RFC9053] Yes direct+HKDF-AES-128 -12 Shared secret w/ AES-MAC 128-bit key [kty] [RFC9053] Yes direct+HKDF-SHA-512 -11 Shared secret w/ HKDF and SHA-512 [kty] [RFC9053] Yes direct+HKDF-SHA-256 -10 Shared secret w/ HKDF and SHA-256 [kty] [RFC9053] Yes Unassigned -9 EdDSA -8 EdDSA [kty] [RFC9053] Yes ES256 -7 ECDSA w/ SHA-256 [kty] [RFC9053] Yes direct -6 Direct use of CEK [kty] [RFC9053] Yes A256KW -5 AES Key Wrap w/ 256-bit key [kty] [RFC9053] Yes A192KW -4 AES Key Wrap w/ 192-bit key [kty] [RFC9053] Yes A128KW -3 AES Key Wrap w/ 128-bit key [kty] [RFC9053] Yes Unassigned -2 to -1 Reserved 0 [RFC9053] No A128GCM 1 AES-GCM mode w/ 128-bit key, 128-bit [kty] [RFC9053] Yes tag A192GCM 2 AES-GCM mode w/ 192-bit key, 128-bit [kty] [RFC9053] Yes tag A256GCM 3 AES-GCM mode w/ 256-bit key, 128-bit [kty] [RFC9053] Yes tag HMAC 256/64 4 HMAC w/ SHA-256 truncated to 64 bits [kty] [RFC9053] Yes HMAC 256/256 5 HMAC w/ SHA-256 [kty] [RFC9053] Yes HMAC 384/384 6 HMAC w/ SHA-384 [kty] [RFC9053] Yes HMAC 512/512 7 HMAC w/ SHA-512 [kty] [RFC9053] Yes Unassigned 8-9 AES-CCM-16-64-128 10 AES-CCM mode 128-bit key, 64-bit [kty] [RFC9053] Yes tag, 13-byte nonce AES-CCM-16-64-256 11 AES-CCM mode 256-bit key, 64-bit [kty] [RFC9053] Yes tag, 13-byte nonce AES-CCM-64-64-128 12 AES-CCM mode 128-bit key, 64-bit [kty] [RFC9053] Yes tag, 7-byte nonce AES-CCM-64-64-256 13 AES-CCM mode 256-bit key, 64-bit [kty] [RFC9053] Yes tag, 7-byte nonce AES-MAC 128/64 14 AES-MAC 128-bit key, 64-bit tag [kty] [RFC9053] Yes AES-MAC 256/64 15 AES-MAC 256-bit key, 64-bit tag [kty] [RFC9053] Yes Unassigned 16-23 ChaCha20/Poly1305 24 ChaCha20/Poly1305 w/ 256-bit key, [kty] [RFC9053] Yes 128-bit tag AES-MAC 128/128 25 AES-MAC 128-bit key, 128-bit tag [kty] [RFC9053] Yes AES-MAC 256/128 26 AES-MAC 256-bit key, 128-bit tag [kty] [RFC9053] Yes Unassigned 27-29 AES-CCM-16-128-128 30 AES-CCM mode 128-bit key, 128-bit [kty] [RFC9053] Yes tag, 13-byte nonce AES-CCM-16-128-256 31 AES-CCM mode 256-bit key, 128-bit [kty] [RFC9053] Yes tag, 13-byte nonce AES-CCM-64-128-128 32 AES-CCM mode 128-bit key, 128-bit [kty] [RFC9053] Yes tag, 7-byte nonce AES-CCM-64-128-256 33 AES-CCM mode 256-bit key, 128-bit [kty] [RFC9053] Yes tag, 7-byte nonce IV-GENERATION 34 For doing IV generation for [RFC9053] No symmetric algorithms. COSE Key Common Parameters Expert(s) Francesca Palombini, Matt Miller, Justin Richer, Carsten Bormann Reference [RFC9052] Available Formats [IMG] CSV Range Registration Procedures Integer values in the range -65536 to -1 used for key parameters specific to a single algorithm delegated to the COSE Key Type Parameters registry Integer values between 0 and 255 Standards Action With Expert Review Integer values from 256 to 65535 Specification Required Integer values greater than 65535 Expert Review Strings of length 1 Standards Action With Expert Review Strings of length 2 Specification Required Strings of length greater than 2 Expert Review Name Label CBOR Type Value Registry Description Reference Reserved for Private Use less than -65536 [RFC9052] used for key parameters specific to a single algorithm delegated to the COSE Key Type -65536 to -1 [RFC9052] Parameters registry Reserved 0 [RFC9052] kty 1 tstr / int COSE Key Types Identification of the key type [RFC9052] kid 2 bstr Key identification value - match to [RFC9052] kid in message alg 3 tstr / int COSE Algorithms Key usage restriction to this [RFC9052] algorithm key_ops 4 [+ (tstr/int)] Restrict set of permissible [RFC9052] operations Base IV 5 bstr Base IV to be XORed with Partial IVs [RFC9052] COSE Key Type Parameters Registration Procedure(s) Expert Review Expert(s) Göran Selander, Derek Atkins, Sean Turner Reference [RFC9053] Available Formats [IMG] CSV Key Type Name Label CBOR Type Description Reference 1 crv -1 int / tstr EC identifier -- Taken from the "COSE Elliptic Curves" registry [RFC9053] 1 x -2 bstr Public Key [RFC9053] 1 d -4 bstr Private key [RFC9053] 2 crv -1 int / tstr EC identifier -- Taken from the "COSE Elliptic Curves" registry [RFC9053] 2 x -2 bstr x-coordinate [RFC9053] 2 y -3 bstr / bool y-coordinate [RFC9053] 2 d -4 bstr Private key [RFC9053] 3 n -1 bstr the RSA modulus n [RFC8230] 3 e -2 bstr the RSA public exponent e [RFC8230] 3 d -3 bstr the RSA private exponent d [RFC8230] 3 p -4 bstr the prime factor p of n [RFC8230] 3 q -5 bstr the prime factor q of n [RFC8230] 3 dP -6 bstr dP is d mod (p - 1) [RFC8230] 3 dQ -7 bstr dQ is d mod (q - 1) [RFC8230] 3 qInv -8 bstr qInv is the CRT coefficient q^(-1) mod p [RFC8230] 3 other -9 array other prime infos, an array [RFC8230] 3 r_i -10 bstr a prime factor r_i of n, where i >= 3 [RFC8230] 3 d_i -11 bstr d_i = d mod (r_i - 1) [RFC8230] 3 t_i -12 bstr the CRT coefficient t_i = (r_1 * r_2 * ... * r_(i-1))^(-1) mod r_i [RFC8230] 4 k -1 bstr Key Value [RFC9053] 5 pub -1 bstr Public key for HSS/LMS hash-based digital signature [RFC8778] 6 N -1 uint Group and Matrix (NxN) size [RFC9021] 6 q -2 uint Finite field F_q [RFC9021] 6 t-values -3 array (of uint) List of T-values, entries in F_q [RFC9021] 6 matrix 1 -4 array (of array of uint) NxN Matrix of entries in F_q in column-major form [RFC9021] 6 permutation 1 -5 array (of uint) Permutation associated with matrix 1 [RFC9021] 6 matrix 2 -6 array (of array of uint) NxN Matrix of entries in F_q in column-major form [RFC9021] COSE Key Types Registration Procedure(s) Expert Review Expert(s) Göran Selander, Derek Atkins, Sean Turner Reference [RFC9053] Available Formats [IMG] CSV Name Value Description Capabilities Reference Reserved 0 This value is reserved [RFC9053] OKP 1 Octet Key Pair [kty(1), crv] [RFC9053] EC2 2 Elliptic Curve Keys w/ x- and y-coordinate pair [kty(2), crv] [RFC9053] RSA 3 RSA Key [kty(3)] [RFC8230][RFC9053] Symmetric 4 Symmetric Keys [kty(4)] [RFC9053] HSS-LMS 5 Public key for HSS/LMS hash-based digital signature [kty(5), hash algorithm] [RFC8778][RFC9053] WalnutDSA 6 WalnutDSA public key [kty(6)] [RFC9021][RFC9053] COSE Elliptic Curves Expert(s) Göran Selander, Derek Atkins, Sean Turner Reference [RFC9053] Available Formats [IMG] CSV Range Registration Procedures Integer values -65536 to -257 Specification Required Integer values -256 to 255 Standards Action With Expert Review Integer values 256 to 65535 Specification Required Integer values greater than 65535 Expert Review Name Value Key Type Description Change Controller Reference Recommended Reserved for Private Use Integer values less than -65536 [RFC9053] No Unassigned -65536 to -1 Reserved 0 [RFC9053] No P-256 1 EC2 NIST P-256 also known as secp256r1 [RFC9053] Yes P-384 2 EC2 NIST P-384 also known as secp384r1 [RFC9053] Yes P-521 3 EC2 NIST P-521 also known as secp521r1 [RFC9053] Yes X25519 4 OKP X25519 for use w/ ECDH only [RFC9053] Yes X448 5 OKP X448 for use w/ ECDH only [RFC9053] Yes Ed25519 6 OKP Ed25519 for use w/ EdDSA only [RFC9053] Yes Ed448 7 OKP Ed448 for use w/ EdDSA only [RFC9053] Yes secp256k1 8 EC2 SECG secp256k1 curve IESG [RFC8812] No Licensing Terms