rfc9597v1.txt | rfc9597.txt | |||
---|---|---|---|---|
skipping to change at line 121 ¶ | skipping to change at line 121 ¶ | |||
The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", | The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", | |||
"SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and | "SHOULD", "SHOULD NOT", "RECOMMENDED", "NOT RECOMMENDED", "MAY", and | |||
"OPTIONAL" in this document are to be interpreted as described in | "OPTIONAL" in this document are to be interpreted as described in | |||
BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all | BCP 14 [RFC2119] [RFC8174] when, and only when, they appear in all | |||
capitals, as shown here. | capitals, as shown here. | |||
2. Representation | 2. Representation | |||
This document defines the following COSE header parameter: | This document defines the following COSE header parameter: | |||
+========+=======+=======+=============+===========================+ | +========+=======+=======+==============+===============+===========+ | |||
| Name | Label | Value | Value | Description | | | Name | Label | Value | Value | Description | Reference | | |||
| | | Type | Registry | | | | | | Type | Registry | | | | |||
+========+=======+=======+=============+===========================+ | +========+=======+=======+==============+===============+===========+ | |||
| CWT | 15 | map | [IANA.COSE] | Location for CWT Claims | | | CWT | 15 | map | map keys in | Location | Section 2 | | |||
| Claims | | | | in COSE Header Parameters | | | Claims | | | [CWT.Claims] | for CWT | of RFC | | |||
+--------+-------+-------+-------------+---------------------------+ | | | | | | Claims in | 9597 | | |||
| | | | | COSE Header | | | ||||
| | | | | Parameters | | | ||||
+--------+-------+-------+--------------+---------------+-----------+ | ||||
Table 1 | Table 1 | |||
The following is a non-normative description for the value type of | The following is a non-normative description for the value type of | |||
the CWT claim header parameter using CDDL [RFC8610]. | the CWT claim header parameter using CDDL [RFC8610]. | |||
CWT-Claims = { | CWT-Claims = { | |||
* Claim-Label => any | * Claim-Label => any | |||
} | } | |||
Claim-Label = int / text | Claim-Label = int / text | |||
skipping to change at line 173 ¶ | skipping to change at line 176 ¶ | |||
4. Security Considerations | 4. Security Considerations | |||
Implementers should also review the security considerations for CWT, | Implementers should also review the security considerations for CWT, | |||
which are documented in Section 8 of [RFC8392]. | which are documented in Section 8 of [RFC8392]. | |||
As described in [RFC9052], if the COSE payload is transported | As described in [RFC9052], if the COSE payload is transported | |||
separately ("detached content"), then it is the responsibility of the | separately ("detached content"), then it is the responsibility of the | |||
application to ensure that it will be transported without changes. | application to ensure that it will be transported without changes. | |||
The reason for applications to verify that CWT claims present in both | The reason for applications to verify that CWT claims present in both | |||
the payload and the header of a CWT are identical, unless it defines | the payload and the header of a CWT are identical, unless they define | |||
other specific processing rules for these claims, is to eliminate | other specific processing rules for these claims, is to eliminate | |||
potential confusion that might arise by having different values for | potential confusion that might arise by having different values for | |||
the same claim, which could result in inconsistent processing of such | the same claim, which could result in inconsistent processing of such | |||
claims. | claims. | |||
Processing information in claims prior to validating that their | Processing information in claims prior to validating that their | |||
integrity is cryptographically secure can pose security risks. This | integrity is cryptographically secure can pose security risks. This | |||
is true whether the claims are in the payload or a header parameter. | is true whether the claims are in the payload or a header parameter. | |||
Implementers must ensure that any tentative decisions made based on | Implementers must ensure that any tentative decisions made based on | |||
previously unverified information are confirmed once the | previously unverified information are confirmed once the | |||
cryptographic processing has been completed. This includes any | cryptographic processing has been completed. This includes any | |||
information that was used to derive the intended interpretation of | information that was used to derive the intended interpretation of | |||
the CWT claims parameter. | the CWT claims parameter. | |||
5. IANA Considerations | 5. IANA Considerations | |||
IANA has registered the new COSE header parameter "CWT Claims" | IANA has registered the new COSE header parameter "CWT Claims" | |||
defined in Table 1 in the "COSE Header Parameters" registry | defined in Table 1 in the "COSE Header Parameters" registry | |||
[IANA.COSE]. | [COSE.HeaderParameters]. | |||
6. References | 6. References | |||
6.1. Normative References | 6.1. Normative References | |||
[IANA.COSE] | [COSE.HeaderParameters] | |||
IANA, "COSE Header Parameters", | IANA, "COSE Header Parameters", | |||
<https://www.iana.org/assignments/cose/>. | <https://www.iana.org/assignments/cose/>. | |||
[CWT.Claims] | ||||
IANA, "CBOR Web Token (CWT) Claims", | ||||
<https://www.iana.org/assignments/cwt/>. | ||||
[RFC2119] Bradner, S., "Key words for use in RFCs to Indicate | [RFC2119] Bradner, S., "Key words for use in RFCs to Indicate | |||
Requirement Levels", BCP 14, RFC 2119, | Requirement Levels", BCP 14, RFC 2119, | |||
DOI 10.17487/RFC2119, March 1997, | DOI 10.17487/RFC2119, March 1997, | |||
<https://www.rfc-editor.org/info/rfc2119>. | <https://www.rfc-editor.org/info/rfc2119>. | |||
[RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC | [RFC8174] Leiba, B., "Ambiguity of Uppercase vs Lowercase in RFC | |||
2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, | 2119 Key Words", BCP 14, RFC 8174, DOI 10.17487/RFC8174, | |||
May 2017, <https://www.rfc-editor.org/info/rfc8174>. | May 2017, <https://www.rfc-editor.org/info/rfc8174>. | |||
[RFC8392] Jones, M., Wahlstroem, E., Erdtman, S., and H. Tschofenig, | [RFC8392] Jones, M., Wahlstroem, E., Erdtman, S., and H. Tschofenig, | |||
"CBOR Web Token (CWT)", RFC 8392, DOI 10.17487/RFC8392, | "CBOR Web Token (CWT)", RFC 8392, DOI 10.17487/RFC8392, | |||
May 2018, <https://www.rfc-editor.org/info/rfc8392>. | May 2018, <https://www.rfc-editor.org/info/rfc8392>. | |||
[RFC9596] Jones, M. and O. Steele, "CBOR Object Signing and | [RFC9596] Jones, M.B. and O. Steele, "CBOR Object Signing and | |||
Encryption (COSE) "typ" (type) Header Parameter", | Encryption (COSE) "typ" (type) Header Parameter", | |||
RFC 9596, DOI 10.17487/RFC9596, June 2024, | RFC 9596, DOI 10.17487/RFC9596, June 2024, | |||
<https://www.rfc-editor.org/info/rfc9596>. | <https://www.rfc-editor.org/info/rfc9596>. | |||
6.2. Informative References | 6.2. Informative References | |||
[RFC7519] Jones, M., Bradley, J., and N. Sakimura, "JSON Web Token | [RFC7519] Jones, M., Bradley, J., and N. Sakimura, "JSON Web Token | |||
(JWT)", RFC 7519, DOI 10.17487/RFC7519, May 2015, | (JWT)", RFC 7519, DOI 10.17487/RFC7519, May 2015, | |||
<https://www.rfc-editor.org/info/rfc7519>. | <https://www.rfc-editor.org/info/rfc7519>. | |||
End of changes. 7 change blocks. | ||||
12 lines changed or deleted | 19 lines changed or added | |||
This html diff was produced by rfcdiff 1.48. |