Internet-Draft | EKU for JOSE | March 2023 |
Reddy, et al. | Expires 11 September 2023 | [Page] |
RFC 5280 specifies several extended key purpose identifiers (KeyPurposeIds) for X.509 certificates. This document defines JSON Web Signature (JWS), JSON Web Encryption (JWE), CBOR Object Web Signature (CWS) and CBOR Object Web Encryption (CWE) KeyPurposeIds inclusion in the Extended Key Usage (EKU) extension of X.509 public key certificates. An application processing JWS, JWE, CWS or CWE may require that the EKU extension be present and that a JWS, JWE, CWS or CWE KeyPurposeId be indicated in order for the certificate to be acceptable to validate the JWS or CWS signature or to encrypt a key in JWE or CWE.¶
This Internet-Draft is submitted in full conformance with the provisions of BCP 78 and BCP 79.¶
Internet-Drafts are working documents of the Internet Engineering Task Force (IETF). Note that other groups may also distribute working documents as Internet-Drafts. The list of current Internet-Drafts is at https://datatracker.ietf.org/drafts/current/.¶
Internet-Drafts are draft documents valid for a maximum of six months and may be updated, replaced, or obsoleted by other documents at any time. It is inappropriate to use Internet-Drafts as reference material or to cite them other than as "work in progress."¶
This Internet-Draft will expire on 11 September 2023.¶
Copyright (c) 2023 IETF Trust and the persons identified as the document authors. All rights reserved.¶
This document is subject to BCP 78 and the IETF Trust's Legal Provisions Relating to IETF Documents (https://trustee.ietf.org/license-info) in effect on the date of publication of this document. Please review these documents carefully, as they describe your rights and restrictions with respect to this document. Code Components extracted from this document must include Revised BSD License text as described in Section 4.e of the Trust Legal Provisions and are provided without warranty as described in the Revised BSD License.¶
[RFC5280] specifies several extended key purpose identifiers (KeyPurposeIds) for X.509 certificates. In addition, the IANA repository "SMI Security for PKIX Extended Key Purpose" [RFC7299] includes a number of KeyPurposeIds. While usage of the anyExtendedKeyUsage KeyPurposeId is bad practice - especially but not only for for publicly trusted certificates (multi-purpose or single-purpose) - there are no extended key purpose identifiers explicitly assigned for JSON Web Signature (JWS) [RFC7515] JSON Web Encryption (JWE) [RFC7516] or their CBOR Object Signing and Encryption (COSE) [RFC9052] counterparts defined here as CBOR Object Web Signature (CWS) and CBOR Object Web Encryption (CWE). JSON Web Signature (JWS) (resp. CBOR Object Web Signature (CWS)) represents content secured with digital signatures or Message Authentication Codes (MACs) using JSON-based [RFC7159] data structures (resp. [RFC9052]). The JWS and CWS cryptographic mechanisms provide integrity protection for an arbitrary sequence of octets. JSON Web Encryption (JWE) (resp. CBOR Object Web Encryption (CWE)) represents encrypted content using JSON-based data structures. The JWE and CWE cryptographic mechanisms encrypt and provide integrity protection for an arbitrary sequence of octets. The cryptographic algorithms and identifiers to be used with the JSON Web Signature (JWS) and JSON Web Encryption (JWE) (resp. CWS, CWE) are defined in [RFC7518] (resp. [RFC9052]).¶
Network Functions (NFs) as part of the service-based architecture within the 5G System [TS23.501]. The Operators of 5G systems make use of an internal PKI to generate X.509 PKI certificates for the NFs in a 5G system. The certificates are used for the following purposes:¶
If the purpose of the issued certificates is not restricted, i.e., the type of operations for which a public key contained in the certificate can be used are not specified, those certificates could be used for another purpose than intended, violating the CA policies, and increasing the risk of cross-protocol attacks. Failure to ensure proper segregation of duties means that a NF who generates the public/private keys and applies for a certificate to the operator CA, could obtain a certificate which can be misused for tasks that this NF is not entitled to perform. For example, a NF service consumer could impersonate NF service producers using its certificate. Another example, if the purpose of the certificate is for the NF service consumer is to use it as a client certificate, the NF with this client certificate and corresponding private key must not be allowed to sign the CCA. When a NF service producer receives the signed CCA from the NF service consumer, the NF would accept the token even if CCA is signed with a certificate not issued for this purpose.¶
The KeyPurposeId id-kp-serverAuth (Section 4.2.1.12 of [RFC5280]) can be used to identify that the certificate is for a server (e.g., NF service producer), and the KeyPurposeId id-kp-clientAuth (Section 4.2.1.12 of [RFC5280]) can be used to identify that the certificate is for a client (e.g., NF service consumer). However, there is no KeyPurposeIds to identify whether the certificate can be used to generate JWS, JWE, CWS or CWE.¶
Vendor-defined KeyPurposeIds that are used in a PKI governed by the vendor or a group of vendors pose no interoperability concern. Appropriating, or misappropriating as the case may be, KeyPurposeIds for use outside of their originally intended vendor or group of vendors controlled environment can introduce problems, the impact of which is difficult to determine. Therefore, it is not favorable to use vendor-defined KeyPurposeIds for JWS, JWE, CWS and CWE in deployments that are not governed by the vendor.¶
This document defines extended key purpose identifiers for JWS, JWE, CWS and CWE.¶
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 [RFC2119][RFC8174] when, and only when, they appear in all capitals, as shown here.¶
CBOR Object Web Signature (CWS): Signing Object of a CBOR Object Signing and Encryption (COSE) defined in [RFC9052] Section 4.¶
CBOR Object Web Encryption (CWE): Encryption Object of a CBOR Object Signing and Encryption (COSE) defined in [RFC9052] Section 4.¶
This specification defines the KeyPurposeIds id-kp-jws, id-kp-jwe, id-kp-cws and id-kp-cwe. As described in [RFC5280], "[i]f the [Extended Key Usage] extension is present, then the certificate MUST only be used for one of the purposes indicated." [RFC5280] also notes that "[i]f multiple [key] purposes are indicated the application need not recognize all purposes indicated, as long as the intended purpose is present."¶
Applications processing JWS, JWE, CWS or CWE MAY require that the EKU extension be present and that the id-kp-jws or id-kp-jwe be indicated in order for the certificate to be acceptable to validate the JWS or CWS Signature or to encrypt the Content Encryption Key (CEK) in JWE or CWE.¶
[RFC5280] specifies the EKU X.509 certificate extension for use on end entity certificates. The extension indicates one or more purposes for which the certified public key is valid. The EKU extension can be used in conjunction with the key usage extension, which indicates the set of basic cryptographic operations for which the certified key may be used. The EKU extension syntax is repeated here for convenience:¶
ExtKeyUsageSyntax ::= SEQUENCE SIZE (1..MAX) OF KeyPurposeId KeyPurposeId ::= OBJECT IDENTIFIER¶
As described in [RFC5280], the EKU extension may, at the option of the certificate issuer, be either critical or non-critical. This specification defines the KeyPurposeIds id-kp-jws, id-kp-jwe, id-kp-cws and id-kp-cwe. Inclusion of KeyPurposeId id-kp-jws or id-kp-cws in a certificate indicates that the public key encoded in the certificate has been certified to be used for validating the JWS or CWS signature. Inclusion of KeyPurposeId id-kp-jwe or id-kp-cwe in a certificate indicates that the public key encoded in the certificate has been certified to be used for encrypting the CEK in JWE (for example, encrypt the CEK with the recipient's public key using the RSAES-OAEP algorithm to produce the JWE (resp. CWE) Encrypted Key).¶
id-kp OBJECT IDENTIFIER ::= { iso(1) identified-organization(3) dod(6) internet(1) security(5) mechanisms(5) pkix(7) kp(3) } id-kp-jws OBJECT IDENTIFIER ::= { id-kp TBD1 } id-kp-jwe OBJECT IDENTIFIER ::= { id-kp TBD2 } id-kp-cws OBJECT IDENTIFIER ::= { id-kp TBD3 } id-kp-cwe OBJECT IDENTIFIER ::= { id-kp TBD4 }¶
The procedures and practices employed by a certification authority MUST ensure that the correct values for the EKU extension are inserted in each certificate that is issued. Unless certificates are governed by a vendor-specific PKI, certificates that indicate usage for JWS, JWE, CWS or CWE MAY include the id-kp-jws, id-kp-jwe, id-kp-cws or id-kp-cwe KeyPurposeId. The inclusion of the id-kp-jws, id-kp-jwe, id-kp-cws or id-kp-cwe KeyPurposeIds does not preclude the inclusion of other KeyPurposeIds.¶
The Security Considerations of [RFC5280] are applicable to this document. This extended key purpose does not introduce new security risks but instead reduces existing security risks by providing means to identify if the certificate is generated to process JWS or CWS signature or toencrypt the CEK in JWE or CWE.¶
To reduce the risk of specific cross-protocol attacks, the relying party or the relying party software may additionally prohibit use of specific combinations of KeyPurposeIds. The procedure of using Excluded KeyPurposeId and Permitted KeyPurposeId by an relying party to permit or prohibit combinations of KeyPurposeIds is defined in Section 4 of [RFC9336]. Examples of Excluded KeyPurposeId include the presence of the anyExtendedKeyUsage KeyPurposeId or the complete absence of the EKU extension in a certificate. Examples of Permitted KeyPurposeId include the presence of JWS, JWE, CWS or CWE KeyPurposeId.¶
In some security protocols, such as TLS 1.2 [RFC5246], certificates are exchanged in the clear. In other security protocols, such as TLS 1.3 [RFC8446], the certificates are encrypted. The inclusion of EKU extension can help an observer determine the purpose of the certificate. In addition, If the certificate is issued by a public certification authority, the inclusion of EKU extension can help an attacker to monitor the Certificate Transparency logs [RFC9162] to identify the purpose of the certificate.¶
IANA is requested to register the following OIDs in the "SMI Security for PKIX Extended Key Purpose" registry (1.3.6.1.5.5.7.3). This OID is defined in Section 4.¶
IANA is also requested to register the following ASN.1[X.680] module OID in the "SMI Security for PKIX Module Identifier" registry (1.3.6.1.5.5.7.0). This OID is defined in Appendix A.¶
The following individuals have contributed to this document:¶
German Peinado Nokia Email: german.peinado@nokia.com¶
TODO¶
The following module adheres to ASN.1 specifications [X.680] and [X.690].¶
<CODE BEGINS> JOSE-EKU { iso(1) identified-organization(3) dod(6) internet(1) security(5) mechanisms(5) pkix(7) id-mod(0) id-mod-jose-eku(TBD4) } DEFINITIONS IMPLICIT TAGS ::= BEGIN -- OID Arc id-kp OBJECT IDENTIFIER ::= { iso(1) identified-organization(3) dod(6) internet(1) security(5) mechanisms(5) pkix(7) kp(3) } -- Extended Key Usage Values id-kp-jws OBJECT IDENTIFIER ::= { id-kp TBD1 } id-kp-jwe OBJECT IDENTIFIER ::= { id-kp TBD2 } id-kp-cws OBJECT IDENTIFIER ::= { id-kp TBD3 } id-kp-cwe OBJECT IDENTIFIER ::= { id-kp TBD4 } END <CODE ENDS>¶