Content for TS 29.573 Word version: 18.5.0
4 General Description
4.1 Introduction
4.2 N32 Interface
4.3 Protocol Stack
5 N32 Procedures
5.1 Introduction
5.2 N32 Handshake Procedures (N32-c)
5.3 Message Forwarding Procedure on N32 (N32-f)
5.4 Nsepp_Telescopic_FQDN_Mapping Service
5.5 Support of Roaming Intermediaries
6 API Definitions
6.1 N32 Handshake API
6.2 JOSE Protected Message Forwarding API on N32
6.3 Nsepp_Telescopic_FQDN_Mapping API
4 General Description p. 11
4.1 Introduction p. 11
4.2 N32 Interface p. 11
4.3 Protocol Stack p. 12
4.3.1 General p. 12
4.3.2 HTTP/2 Protocol p. 13
4.3.2.1 General p. 13
4.3.2.2 HTTP standard headers p. 13
4.3.2.3 HTTP custom headers p. 14
4.3.2.4 HTTP/2 connection management p. 14
4.3.3 Transport Protocol p. 14
4.3.4 Serialization Protocol p. 15
5 N32 Procedures p. 15
5.1 Introduction p. 15
5.2 N32 Handshake Procedures (N32-c) p. 15
5.2.1 General p. 15
5.2.2 Security Capability Negotiation Procedure p. 15
5.2.3 Parameter Exchange Procedure p. 18
5.2.3.1 General p. 18
5.2.3.2 Parameter Exchange Procedure for Cipher Suite Negotiation p. 18
5.2.3.3 Parameter Exchange Procedure for Protection Policy Exchange p. 19
5.2.3.4 Parameter Exchange Procedure for Security Information list Exchange |R16| p. 21
5.2.4 N32-f Context Termination Procedure p. 22
5.2.5 N32-f Error Reporting Procedure p. 23
5.3 Message Forwarding Procedure on N32 (N32-f) p. 24
5.3.1 Introduction p. 24
5.3.2 Use of Application Layer Security p. 24
5.3.2.1 General p. 24
5.3.2.2 Protection Policy Lookup p. 25
5.3.2.3 Message Reformatting p. 26
5.3.2.4 Message Forwarding to Peer SEPP p. 28
5.3.2.5 JOSE Protected Forwarding Options |R18| p. 29
5.3.3 Message Forwarding to Peer SEPP when TLS is used p. 29
5.3.4 Void
5.4 Nsepp_Telescopic_FQDN_Mapping Service |R16| p. 30
5.4.1 General p. 30
5.4.2 Foreign FQDN to Telescopic FQDN Mapping Procedure p. 30
5.4.3 Telescopic FQDN to Foreign FQDN Mapping Procedure p. 30
5.5 Support of Roaming Intermediaries |R18| p. 31
5.5.1 General p. 31
5.5.2 N32-c connection establishment via Roaming Intermediaries p. 31
5.5.2.1 N32-c connection establishment using HTTP CONNECT p. 31
5.5.2.2 Error messages originated by Roaming Intermediaries over the N32-c interface p. 31
5.5.3 N32-f messages forwarding or origination via Roaming Intermediaries p. 32
5.5.3.1 Error messages originated by (or related to) Roaming Intermediaries over the N32-f interface p. 32
5.5.3.1.1 General p. 32
5.5.3.2 N32-f related error determined upon receipt of an N32-f request p. 34
5.5.3.2.1 Error message originated by Roaming Intermediary via N32-f p. 34
5.5.3.2.2 Error message originated by pSEPP on N32-f (and optionally N32-c) p. 35
5.5.3.3 N32-f related error determined upon receipt of an N32-f response p. 36
5.5.3.3.1 Error message originated by Roaming Intermediary via N32-f p. 36
5.5.3.3.2 Error message formatting by the Roaming Intermediary p. 37
5.5.3.4 Applicative (i.e. SBI related) error determined upon receipt of an N32-f request p. 38
6 API Definitions p. 39
6.1 N32 Handshake API p. 39
6.1.1 API URI p. 39
6.1.2 Usage of HTTP p. 39
6.1.2.1 General p. 39
6.1.2.2 HTTP standard headers p. 40
6.1.2.2.1 General p. 40
6.1.2.2.2 Content type p. 40
6.1.2.3 HTTP custom headers p. 40
6.1.2.3.1 General p. 40
6.1.3 Resources p. 40
6.1.3.1 Overview p. 40
6.1.4 Custom Operations without Associated Resources p. 40
6.1.4.1 Overview p. 40
6.1.4.2 Operation: Security Capability Negotiation p. 40
6.1.4.2.1 Description p. 40
6.1.4.2.2 Operation Definition p. 41
6.1.4.3 Operation: Parameter Exchange p. 41
6.1.4.3.1 Description p. 41
6.1.4.3.2 Operation Definition p. 42
6.1.4.4 Operation: N32-f Context Terminate p. 42
6.1.4.4.1 Description p. 42
6.1.4.4.2 Operation Definition p. 43
6.1.4.5 Operation: N32-f Error Reporting p. 43
6.1.4.5.1 Description p. 43
6.1.4.5.2 Operation Definition p. 43
6.1.5 Data Model p. 44
6.1.5.1 General p. 44
6.1.5.2 Structured data types p. 44
6.1.5.2.1 Introduction p. 44
6.1.5.2.2 Type: SecNegotiateReqData p. 45
6.1.5.2.3 Type: SecNegotiateRspData p. 46
6.1.5.2.4 Type: SecParamExchReqData p. 47
6.1.5.2.5 Type: SecParamExchRspData p. 48
6.1.5.2.6 Type: ProtectionPolicy p. 49
6.1.5.2.7 Type: ApiIeMapping p. 49
6.1.5.2.8 Type: IeInfo p. 50
6.1.5.2.9 Type: ApiSignature p. 51
6.1.5.2.10 Type: N32fContextInfo p. 51
6.1.5.2.11 Type: N32fErrorInfo p. 52
6.1.5.2.12 Type: FailedModificationInfo p. 53
6.1.5.2.13 Type: N32fErrorDetail p. 53
6.1.5.2.14 Type: CallbackName p. 53
6.1.5.2.15 Type: IpxProviderSecInfo |R16| p. 53
6.1.5.2.16 Type: IntendedN32Purpose |R17| p. 54
6.1.5.3 Simple data types and enumerations p. 54
6.1.5.3.1 Introduction p. 54
6.1.5.3.2 Simple data types p. 54
6.1.5.3.3 Enumeration: SecurityCapability p. 54
6.1.5.3.4 Enumeration: HttpMethod p. 54
6.1.5.3.5 Enumeration: IeType p. 55
6.1.5.3.6 Enumeration: IeLocation p. 55
6.1.5.3.7 Enumeration: N32fErrorType p. 56
6.1.5.3.8 Enumeration: FailureReason p. 56
6.1.5.3.9 Enumeration: N32Purpose |R17| p. 57
6.1.5.4 Binary data p. 57
6.1.6 Error Handling p. 57
6.1.7 Feature Negotiation |R17| p. 58
6.1.8 HTTP redirection |R18| p. 59
6.2 JOSE Protected Message Forwarding API on N32 p. 59
6.2.1 API URI p. 59
6.2.2 Usage of HTTP p. 59
6.2.2.1 General p. 59
6.2.2.2 HTTP standard headers p. 60
6.2.2.3 HTTP custom headers p. 60
6.2.2.3.1 General p. 60
6.2.3 Resources p. 60
6.2.3.1 Overview p. 60
6.2.4 Custom Operations without associated resources p. 60
6.2.4.1 Overview p. 60
6.2.4.2 Operation: JOSE Protected Forwarding p. 61
6.2.4.2.1 Description p. 61
6.2.4.2.2 Operation Definition p. 61
6.2.4.3 Operation: JOSE Protected Forwarding Options |R16| p. 63
6.2.4.3.1 Description p. 63
6.2.4.3.2 Operation Definition p. 63
6.2.5 Data Model p. 64
6.2.5.1 General p. 64
6.2.5.2 Structured data types p. 65
6.2.5.2.1 Introduction p. 65
6.2.5.2.2 Type: N32fReformattedReqMsg p. 65
6.2.5.2.3 Type: N32fReformattedRspMsg p. 66
6.2.5.2.4 Type: DataToIntegrityProtectAndCipherBlock p. 66
6.2.5.2.5 Type: DataToIntegrityProtectBlock p. 67
6.2.5.2.6 Type: RequestLine p. 67
6.2.5.2.7 Type: HttpHeader p. 68
6.2.5.2.8 Type: HttpPayload p. 69
6.2.5.2.9 Type: MetaData p. 70
6.2.5.2.10 Type: Modifications p. 71
6.2.5.2.11 Type: FlatJweJson p. 72
6.2.5.2.12 Type: FlatJwsJson p. 73
6.2.5.2.13 Type: IndexToEncryptedValue p. 73
6.2.5.2.14 Type: EncodedHttpHeaderValue p. 73
6.2.5.2.15 Type: ProblemDetailsMsgForwarding |R18| p. 73
6.2.5.2.16 Type: AdditionInfoMsgForwarding |R18| p. 74
6.2.5.3 Simple data types and enumerations p. 74
6.2.6 Error Handling p. 74
6.3 Nsepp_Telescopic_FQDN_Mapping API |R16| p. 75
6.3.1 API URI p. 75
6.3.2 Usage of HTTP p. 76
6.3.2.1 General p. 76
6.3.2.2 HTTP standard headers p. 76
6.3.2.2.1 General p. 76
6.3.2.2.2 Content type p. 76
6.3.2.3 HTTP custom headers p. 76
6.3.2.3.1 General p. 76
6.3.3 Resources p. 76
6.3.3.1 Overview p. 76
6.3.3.2 Resource: Mapping p. 77
6.3.4 Data Model p. 78
6.3.4.1 General p. 78
6.3.4.2 Structured data types p. 78
6.3.4.3 Simple data types and enumerations p. 79
6.3.4.3.1 Introduction p. 79
6.3.4.3.2 Simple data types p. 79
6.3.5 Error Handling p. 79
6.3.6 Feature Negotiation p. 80
6.3.7 Security p. 80
6.3.7.1 General p. 80
