Internet-Draft | 5G NFType in X.509 Certificates | September 2022 |
Housley, et al. | Expires 30 March 2023 | [Page] |
This document specifies the certificate extension for including Network Function Types (NFTypes) for the 5G System in X.509v3 public key certificates as profiled in RFC 5280.¶
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 30 March 2023.¶
Copyright (c) 2022 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.¶
The 3rd Generation Partnership Project (3GPP) has specified several Network Functions (NFs) as part of the service-based architecture within the 5G System. The 49 NF types that are defined for 3GPP Release 17 listed in Table 6.1.6.3.3-1 of [TS29.510], and each NF type is identified by a short ASCII string.¶
Operators of 5G systems make use of an internal PKI to identify interface instances in the NFs in a 5G system. X.509v3 public key certificates [RFC5280] are used, and the primary function of a certificate is to bind a public key to the identity of an entity that holds the corresponding private key, known as the certificate subject. The certificate subject and the subjectAltName certificate extension can be used to support identity-based access control decisions.¶
This document specifies the NFTypes certificate extension, which provides a list of NF Types associated with the certificate subject. The NFTypes certificate extension can be used to support role-based access control decisions. The NFTypes certificate extension can be used by operators of 5G systems or later.¶
The certificate extension supports many different forms of role-based access control as the various types of NF are trusted to perform their activities in the overall system. An activity might include the implementation of filtering policies. Another activity might provide an access controlled resource. These example illustrate differing levels of confidence that are needed in the proper assignment of the NFType in the overall security of the 5G system.¶
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.¶
The Network Domain Security (NDS) Authentication Framework (AF) for 3GPP Release 17 [TS33.310] provides several patterns for certificate subject names. For example, the certificate subject name for an NF instance follows one of these patterns:¶
(c=<country>), o=<Organization Name>, cn=<Some distinguishing name> cn=<hostname>, (ou=<servers>), dc=<domain>, dc=<domain>¶
When either pattern is used, the cn= portion is a DirectoryString; however, Section 4.1.2.6 of [RFC5280], limits the character set to either PrintableString or UTF8String. Note that the PrintableString has a much more limited set of characters that can be represented.¶
When the first pattern is used, the o= portion of the name contains the home domain as specified in [TS23.003] to identify the public land mobile network, and it takes the following form:¶
5gc.mnc<MNC>.mcc<MCC>.3gppnetwork.org¶
where MNC designates the Mobile Network Code, and MCC designates the Mobile Country Code.¶
The certificates are expected to include the SubjectAltName certificate extension that contains a fully qualified domain name (FQDN), where the FQDN designates the NF as defined in [TS23.003]. For example, the SubjectAltName certificate extension for an NF instance implementing the AMF might include these FQDNs:¶
amf1.cluster1.net2.amf.5gc.mnc012.mcc345.3gppnetwork.org amf1.callback.cluster1.net2.amf.5gc.mnc012.mcc345.3gppnetwork.org¶
The certificates for entities that can act as TLS clients or servers are also expected to include a uniformResourceIdentifier in the SubjectAltName certificate extension that contains the NF Instance ID as specified in Clause 5.3.2 of [TS29.571]. For example, the SubjectAltName certificate extension for an NF Instance ID might be:¶
urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6¶
Following these patterns facilitates the use of the certificate subject and the subjectAltName certificate extension to support identity-based access control decisions.¶
When the second pattern is used, the dc= portion of the name contains a single domain component. For example, hostname.example.net would appear in the certificate subject as:¶
cn=hostname, dc=example, dc=net¶
This section specifies the NFTypes certificate extension, which provides a list of NF Types associated with the certificate subject.¶
The NFTypes certificate extension MAY be included in public key certificates [RFC5280]. The NFTypes extension MUST be identified by the following object identifier:¶
id-pe-nftypes OBJECT IDENTIFIER ::= { iso(1) identified-organization(3) dod(6) internet(1) security(5) mechanisms(5) pkix(7) id-pe(1) TBD1 }¶
This extension MUST NOT be marked critical.¶
The NFTypes extension MUST have the following syntax:¶
NFTypes ::= SEQUENCE SIZE (1..MAX) OF NFType NFType ::= IA5String (SIZE (1..32))¶
The NFTypes MUST contain only the ASCII strings.¶
The NFTypes MUST contain at least one NFType.¶
The NFTypes MUST NOT contain the same NFType more than once.¶
Each NFType MUST contain at least one ASCII character, and each NFType MUST NOT contain more than 32 ASCII characters.¶
The NFType is of type IA5String to permit inclusion of the character underscore character ('_'), which is not part of the PrintableString character set.¶
This section provides an ASN.1 module [X.680] for the NFTypes certificate extension, and it follows the conventions established in [RFC5912] and [RFC6268].¶
<CODE BEGINS> NFTypeCertExtn { iso(1) identified-organization(3) dod(6) internet(1) security(5) mechanisms(5) pkix(7) id-mod(0) id-mod-nftype(TBD2) } DEFINITIONS IMPLICIT TAGS ::= BEGIN IMPORTS EXTENSION FROM PKIX-CommonTypes-2009 -- RFC 5912 { iso(1) identified-organization(3) dod(6) internet(1) security(5) mechanisms(5) pkix(7) id-mod(0) id-mod-pkixCommon-02(57) } ; -- NFTypes Certificate Extension ext-NFType EXTENSION ::= { SYNTAX NFTypes IDENTIFIED BY id-pe-nftype } -- NFTypes Certificate Extension OID id-pe-nftype OBJECT IDENTIFIER ::= { iso(1) identified-organization(3) dod(6) internet(1) security(5) mechanisms(5) pkix(7) id-pe(1) TBD1 } -- NFTypes Certificate Extension Syntax NFTypes ::= SEQUENCE SIZE (1..MAX) OF NFType NFType ::= IA5String (SIZE (1..32)) END <CODE ENDS>¶
The Security Considerations of [RFC5280] are applicable to this document.¶
The ASCII strings that specify the NF Types are not standard; an operator MAY build its own NF Type. Since the NF Type is used for role-based access control decisions, the operator that specifies their own ASCII string for an NF Type MUST ensure that the new NF Type does not match an existing one.¶
The NFType can be used for various purposes. For example, access to a particular resource might only be provided to a subset of NFTypes. In another example, the NFTypes might be an input to a filtering decision. These different uses of the NFType values have different requirements on the level of trust in the NFType values carried in the certificate extension. Granting access to a resource based on the NFType in the certificate extension requires a great deal of confidence that the NFType is set properly. On the other hand, filtering decisions primarily address misconfiguration, and they require less confidence. As a result, different trust models might apply to the NFTypes certificate extension.¶
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 NFType certificate extension can help an observer determine which systems are of most interest based on the plaintext certificate transmission.¶
For the NFType certificate extension in Section 4, IANA is requested to assign an object identifier (OID) for the certificate extension. The OID for the certificate extension should be allocated in the "SMI Security for PKIX Certificate Extension" registry (1.3.6.1.5.5.7.1).¶
For the ASN.1 Module in Section 5, IANA is requested to assign an object identifier (OID) for the module identifier. The OID for the module should be allocated in the "SMI Security for PKIX Module Identifier" registry (1.3.6.1.5.5.7.0).¶
Many thanks to Ben Smeets and Michael Li for their review and comments.¶
Each NFType is identified by an ASCII string. Table 6.1.6.3.3-1 of [TS29.510] defines the ASCII strings for the NF Types specified in 3GPP documents, which are listed below in alphabetical order. This list is not exhaustive.¶
"5G_DDNMF" "ICSCF" "SCEF" "5G_EIR" "IMS_AS" "SCP" "AANF" "LMF" "SCSAS" "ADRF" "MB-SMF" "SCSCF" "AF" "MB-UPF" "SEPP" "AMF" "MFAF" "SMF" "AUSF" "MME" "SMSF" "BSF" "N3IWF" "SOR_AF" "CBCF" "NEF" "SPAF" "CEF" "NRF" "TSCTSF" "CHF" "NSACF" "UCMF" "DCCF" "NSSAAF" "UDM" "DRA" "NSSF" "UDR" "EASDF" "NSWOF" "UDSF" "GBA_BSF" "NWDAF" "UPF" "GMLC" "PCF" "HSS" "PCSCF"¶