B Supported Headers
The following tables list the headers supported by NRF.
Supported 3GPP Custom Headers
Table B-1 Supported 3GPP Custom Headers
| Custom Header Name | Description |
|---|---|
3gpp-Sbi-Message-Priority |
This header is used to specify the HTTP/2 message priority for 3GPP service-based interfaces. NRF supports this header for ingress requests, egress requests, forwarding scenarios, and roaming scenarios. NRF validates the priority value and applies configured priority mapping rules before forwarding or responding to requests. |
3gpp-Sbi-Callback |
This header is used to identify a particular type of callback, for example, notification. NRF uses this header while routing NFStatusNotify requests through SCP and Egress Gateway. |
3gpp-Sbi-Target-apiRoot |
This header contains the apiRoot of the target URI in a message request sent during indirect communication scenarios such as forwarding, roaming, and SCP routing procedures. NRF uses this header while routing egress requests through SCP, SLF, forwarding, and roaming flows. |
3gpp-Sbi-Discovery-target-nf-set-id |
This header identifies the target NF Set that the NRF should use as a filter during NF discovery. It limits the discovery result to NF instances that belong to the specified NF Set, enabling scoped and topology-aware selection. |
3gpp-Sbi-Client-Credentials |
This header is used by a consumer NF to send a Client Credential Assertion (CCA) to NRF during Access Token service operation. NRF validates JWT claims, X.509 certificate chains, NF instance identity, audience, and token expiry before issuing OAuth2 access tokens. |
3gpp-Sbi-Correlation-Info |
This header may contain correlation information, for example UE identity, SUPI, or GPSI, that may be used by operators for network management, troubleshooting, performance analysis, and subscriber tracing. NRF uses this header in enhanced error logging, NFDiscover procedures, and troubleshooting flows. |
NRF also supports the HTTP standard headers. For more information, see 3GPP TS 29.500, Table 5.2.2.2-1.
Standard Headers Supported by NRF
Table B-2 Standard Headers Supported by NRF
| Header Name | Description |
|---|---|
| Mandatory to Support HTTP Request Standard Headers | |
Accept |
This header specifies acceptable response media types.If NRF receives this header in a request, it forwards it as is and does not perform any action on it. |
Accept-Encoding |
This header indicates the type of response content encoding, for example, GZIP, is acceptable in the response. If the received data is in GZIP format, NRF decompresses it if required and then compresses it to GZIP before forwarding it. |
Content-Length |
This header provides the anticipated size, as a decimal number of octets, for potential content. |
Content-Type |
This header indicates the media type of the associated representation. |
User-Agent |
This header identifies the NF type of the HTTP/2 client. |
Cache-Control |
This header is used in some HTTP/2 requests to provide the HTTP cache-control directives that the client can accept from the server. If NRF receives this header in a request, it forwards it as is and does not perform any action on it. |
If-Modified-Since |
This header is used in a conditional GET request to re-validate the server. This is used in conjunction with the LastModified server response header to retrieve content if the content has been modified from the cached version. If NRF receives this header in a request, it forwards it as is and does not perform any action on it. |
If-None-Match |
This header is used in a conditional GET request. This is used in conjunction with the ETag server response header to retrieve content if the tag value of the resource on the server differs from the tag value in the If-None-Match header.
If NRF receives this header in a request, it forwards it as is and does not perform any action on it. |
If-Match |
This header is used in a conditional POST, PUT, DELETE, or PATCH request. This is used in conjunction with the ETag server response header to update or remove content if the tag value of the resource on the server matches the tag value in the If-Match header.
If NRF receives this header in a request, it forwards it as is and does not perform any action on it. |
Via |
This header is inserted by HTTP proxies.NRF adds its own information in this header while forwarding. |
Authorization |
This header is used if OAuth 2.0 based access authorization with "Client Credentials" grant type is used as specified in subclause 13.4.1 of 3GPP TS 33.501 [17], clause 7 of IETF RFC 6749 [22] and IETF RFC 6750 [23]. |
| Mandatory to Support HTTP Response Standard Headers | |
Content-Length |
This header provides the anticipated size, as a decimal number of octets, for a potential content. |
Content-Type |
This header indicates the media type of the associated representation. |
Retry-After |
This header indicates the waiting period for the user agent before making a follow-up request. |
Content-Encoding |
This header indicates to the HTTP/2 client the content encodings, for example, gzip, applied to the resource representation beyond those inherent in the media type. |
Location |
This header is used in some responses to refer to a specific resource pertaining to the response.It is updated by NRF to an absolute URI if the location header in the response has a relative URI. |
Cache-Control |
This header is used in some responses, such as NRF responses to queries, to provide HTTP response cache control directives. The cache directives "no-cache", "no-store", "maxage", and "must-revalidate" values are supported.
It is not supported by NRF and is forwarded as it is. |
Age |
This header is inserted by HTTP proxies when returning a cached response. This header conveys the sender's estimate of the amount of time since the response was generated or successfully validated at the origin server.It is not supported by NRF. |
Last-Modified |
This header is sent to allow for conditional GET with the IfModified-Since header.
If NRF receives this header in a response, it forwards it as is and does not perform any action on it. |
ETag |
This header is sent to allow for a conditional GET with the If-None-Match header or a conditional POST, PUT, PATCH, or DELETE with the If-Match header.
If NRF receives this header in a response, it forwards it as is and does not perform any action on it. |
Via |
This header is inserted by HTTP proxies. |
Allow |
This header is used to indicate methods supported by the target resource. If NRF receives this header in a response, it forwards it as is and does not perform any action on it. |
WWW-Authenticate |
This header is included when a producer NF rejects a request with a "401 Unauthorized" status code, for example, when a request is sent without an OAuth 2.0 access token or with an invalid OAuth 2.0 access token. |