Internet-Draft | 5G NFType in X.509 Certificates | November 2022 |
Housley, et al. | Expires 11 May 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 11 May 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. There are 49 NF Types defined for 3GPP Release 17; they are 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 to support role-based access control decisions by providing a list of NF Types associated with the certificate subject. The NFTypes certificate extension can be used by operators of 5G systems or later.¶
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.¶
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 certificate 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) 34 }¶
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 at least one NFType.¶
The NFTypes MUST NOT contain the same NFType more than once.¶
Each NFType MUST contain only an ASCII string; however, the string MUST NOT include control characters (values 0 through 31), the space character (value 32), or the delete character (value 127).¶
Each NFType MUST contain at least one ASCII character and MUST NOT contain more than 32 ASCII characters.¶
The NFType uses the IA5String type to permit inclusion of the 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(106) } 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) 34 } -- 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.¶
Some of the ASCII strings that specify the NF Types are standard. See Appendix A for values defined in 3GPP. Additionally, an operator MAY assign its own NF Types for use in their own network. Since the NF Type is used for role-based access control decisions, an operator-assigned NF Type MUST NOT overlap with a value already defined in the commonly defined set. Use of the same ASCII string by two different operators for different roles could lead to confusion or incorrect access control decisions. The mechanism for an operator to determine whether an ASCII string associated with a NF Type is unique across operators is outside the scope of this document.¶
The certificate extension supports many different forms of role-based access control to support the diversity of activities that NFs are trusted to perform in the overall system. Different levels of confidence that the NFTypes were properly assigned might be needed to contribute to the overall security of the 5G system. For example, more confidence might be needed to make access control decisions related to a scarce resource than implementation of filtering policies. As a result, different operators might have different trust models for 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 3, 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 4, 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, Michael Li, Tim Hollebeek, Roman Danyliw, and Bernie Volz for their review, comments, and assistance.¶
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"¶
The example certificate conformes to certificate profile in Table 6.1.3c.3-1 of [TS33.310]. In addition, the NFTypes certificate is included with only one NFType, and it is "AMF". The SubjectAltName certificate extension contains a fully qualified domain names (FQDN) and a uniformResourceIdentifier, which carries the NF Instance ID as specified in Clause 5.3.2 of [TS29.571].¶
-----BEGIN CERTIFICATE----- MIIC0DCCAlagAwIBAgIUbZoY923zOE0+ZIkjG4ehhCGoVXYwCgYIKoZIzj0EAwMw FTETMBEGA1UECgwKRXhhbXBsZSBDQTAeFw0yMjEwMTkxNjMyMzZaFw0yMzEwMTkx NjMyMzZaMDkxCzAJBgNVBAYTAlVTMSowKAYDVQQKEyE1Z2MubW5jNDAwLm1jYzMx MS4zZ3BwbmV0d29yay5vcmcwdjAQBgcqhkjOPQIBBgUrgQQAIgNiAATJ6IFHI683 q/JJjsJUfEiRFqGQ6uKDGJ0oqDP6wEhRAuvyEyz5pgRmz/7Mze1+s1qcnPU9mo1v rIW9rjKhb/Hm8H9TPvnMQwCRCtKvCD90MkWvc/G8qyCBpCms3zNOJOijggFBMIIB PTATBggrBgEFBQcBIgQHMAUWA0FNRjAXBgNVHSAEEDAOMAwGCmCGSAFlAwIBMDAw DgYDVR0PAQH/BAQDAgeAMBMGA1UdJQQMMAoGCCsGAQUFBwMBMB0GA1UdDgQWBBRM Z5KgwYlYn885mKID55ZcEznIBzAfBgNVHSMEGDAWgBSIf6IE6QtqjXR2+p/xCtRh 4PqzNTAxBgNVHR8EKjAoMCagJKAihiBodHRwOi8vZXhhbXBsZS5jb20vZXhhbXBs ZWNhLmNybDB1BgNVHREBAf8EazBpgjhhbWYxLmNsdXN0ZXIxLm5ldDIuYW1mLjVn Yy5tbmM0MDAubWNjMzExLjNncHBuZXR3b3JrLm9yZ4YtdXJuOnV1aWQ6ZjgxZDRm YWUtN2RlYy0xMWQwLWE3NjUtMDBhMGM5MWU2YmY2MAoGCCqGSM49BAMDA2gAMGUC MQDCBp4Fb/1/ffZGEVDWdx1XeFjg1KEmfnBGkNC+GHtan1gbnBnDIfD1MD0ctWWf /zQCMDUmAAk2gM3QohfVsfhGQBm1N2hRz34oHSfhIH+EJFW1rSIG/93r27j09x5C SG8e0g== -----END CERTIFICATE-----¶
The following shows the example certificate. The values on the left are the ASN.1 tag (in hexadecimal) and the length (in decimal).¶
30 720: SEQUENCE { 30 598: SEQUENCE { A0 3: [0] { 02 1: INTEGER 2 : } 02 20: INTEGER : 6D 9A 18 F7 6D F3 38 4D 3E 64 89 23 1B 87 A1 84 : 21 A8 55 76 30 10: SEQUENCE { 06 8: OBJECT IDENTIFIER ecdsaWithSHA384 (1 2 840 10045 4 3 3) : } 30 21: SEQUENCE { 31 19: SET { 30 17: SEQUENCE { 06 3: OBJECT IDENTIFIER organizationName (2 5 4 10) 0C 10: UTF8String 'Example CA' : } : } : } 30 30: SEQUENCE { 17 13: UTCTime 19/10/2022 16:32:36 GMT 17 13: UTCTime 19/10/2023 16:32:36 GMT : } 30 57: SEQUENCE { 31 11: SET { 30 9: SEQUENCE { 06 3: OBJECT IDENTIFIER countryName (2 5 4 6) 13 2: PrintableString 'US' : } : } 31 42: SET { 30 40: SEQUENCE { 06 3: OBJECT IDENTIFIER organizationName (2 5 4 10) 13 33: PrintableString '5gc.mnc400.mcc311.3gppnetwork.org' : } : } : } 30 118: SEQUENCE { 30 16: SEQUENCE { 06 7: OBJECT IDENTIFIER ecPublicKey (1 2 840 10045 2 1) 06 5: OBJECT IDENTIFIER secp384r1 (1 3 132 0 34) : } 03 98: BIT STRING : 04 C9 E8 81 47 23 AF 37 AB F2 49 8E C2 54 7C 48 : 91 16 A1 90 EA E2 83 18 9D 28 A8 33 FA C0 48 51 : 02 EB F2 13 2C F9 A6 04 66 CF FE CC CD ED 7E B3 : 5A 9C 9C F5 3D 9A 8D 6F AC 85 BD AE 32 A1 6F F1 : E6 F0 7F 53 3E F9 CC 43 00 91 0A D2 AF 08 3F 74 : 32 45 AF 73 F1 BC AB 20 81 A4 29 AC DF 33 4E 24 : E8 : } A3 321: [3] { 30 317: SEQUENCE { 30 19: SEQUENCE { 06 8: OBJECT IDENTIFIER nfTypes (1 3 6 1 5 5 7 1 34) 04 7: OCTET STRING, encapsulates { 30 5: SEQUENCE { 16 3: IA5String 'AMF' : } : } : } 30 23: SEQUENCE { 06 3: OBJECT IDENTIFIER certificatePolicies (2 5 29 32) 04 16: OCTET STRING, encapsulates { 30 14: SEQUENCE { 30 12: SEQUENCE { 06 10: OBJECT IDENTIFIER '2 16 840 1 101 3 2 1 48 48' : } : } : } : } 30 14: SEQUENCE { 06 3: OBJECT IDENTIFIER keyUsage (2 5 29 15) 01 1: BOOLEAN TRUE 04 4: OCTET STRING, encapsulates { 03 2: BIT STRING 7 unused bits : '1'B (bit 0) : } : } 30 19: SEQUENCE { 06 3: OBJECT IDENTIFIER extKeyUsage (2 5 29 37) 04 12: OCTET STRING, encapsulates { 30 10: SEQUENCE { 06 8: OBJECT IDENTIFIER serverAuth (1 3 6 1 5 5 7 3 1) : } : } : } 30 29: SEQUENCE { 06 3: OBJECT IDENTIFIER subjectKeyIdentifier (2 5 29 14) 04 22: OCTET STRING, encapsulates { 04 20: OCTET STRING : 4C 67 92 A0 C1 89 58 9F CF 39 98 A2 03 E7 96 5C : 13 39 C8 07 : } : } 30 31: SEQUENCE { 06 3: OBJECT IDENTIFIER authorityKeyIdentifier (2 5 29 35) 04 24: OCTET STRING, encapsulates { 30 22: SEQUENCE { 80 20: [0] : 88 7F A2 04 E9 0B 6A 8D 74 76 FA 9F F1 0A D4 61 : E0 FA B3 35 : } : } : } 30 49: SEQUENCE { 06 3: OBJECT IDENTIFIER cRLDistributionPoints (2 5 29 31) 04 42: OCTET STRING, encapsulates { 30 40: SEQUENCE { 30 38: SEQUENCE { A0 36: [0] { A0 34: [0] { 86 32: [6] 'http://example.com/exampleca.crl' : } : } : } : } : } : } 30 117: SEQUENCE { 06 3: OBJECT IDENTIFIER subjectAltName (2 5 29 17) 01 1: BOOLEAN TRUE 04 107: OCTET STRING, encapsulates { 30 105: SEQUENCE { 82 56: [2] : 'amf1.cluster1.net2.amf.5gc.mnc400.mcc311.3gppnet' : 'work.org' 86 45: [6] : 'urn:uuid:f81d4fae-7dec-11d0-a765-00a0c91e6bf6' : } : } : } : } : } : } 30 10: SEQUENCE { 06 8: OBJECT IDENTIFIER ecdsaWithSHA384 (1 2 840 10045 4 3 3) : } 03 104: BIT STRING, encapsulates { 30 101: SEQUENCE { 02 49: INTEGER : 00 C2 06 9E 05 6F FD 7F 7D F6 46 11 50 D6 77 1D : 57 78 58 E0 D4 A1 26 7E 70 46 90 D0 BE 18 7B 5A : 9F 58 1B 9C 19 C3 21 F0 F5 30 3D 1C B5 65 9F FF : 34 02 48: INTEGER : 35 26 00 09 36 80 CD D0 A2 17 D5 B1 F8 46 40 19 : B5 37 68 51 CF 7E 28 1D 27 E1 20 7F 84 24 55 B5 : AD 22 06 FF DD EB DB B8 F4 F7 1E 42 48 6F 1E D2 : } : } : }¶