8 Roles for PN-query

24.2593GPPPersonal Network Management (PNM)Release 17Stage 3TS

8.1 Introduction

This clause specifies the PN-query procedure.

Annex A.3 provides examples of signalling flows for PN-query.

8.2 PN UE

In order for the PN UE to initiate the PN-configuration procedure for querying an XML document, an element within an XML document or an attribute of an element within an XML document, the PN UE shall know the data structure and constraints defined by the PNM XML schema in annex B. The PN UE shall also know what HTTP URI to use based on the naming conventions for constructing the HTTP URIs described in annex C.

The PN UE initiates the PN-query procedure by sending a HTTP GET request message with:

– Request-URI field indicating to the PNM application the desired location of an XML document, an element within an XML document or an attribute of an element within an XML document which is queried as follows:

– if an XML document is queried, the Request-URI is constructed with a document URI pointing to the XML document;

– if an element within an XML document is queried, the document selector of the Request-URI is constructed with a document URI pointing to the XML document containing the element to be queried and the node selector of the Request-URI with a node URI identifying the element to be queried;

– if an attribute of an element within an XML document is queried, the document selector of the Request-URI is constructed with a document URI pointing to the XML document containing the element to be queried and the node selector of the Request-URI with a node URI identifying the attribute to be queried.

– Host field indicating the Internet host and port number of the PNM application;

– User-Agent field containing information about the user agent originating the request and the static string (e.g. 3gpp-gba) to indicate to the NAF that the UE supports 3GPP-bootstrapping based authentication;

– Referer field indicating the address (URI) of the resource from which the URI for the PNM application is obtained;

– Authorization field containing the credentials obtained by means of executing the bootstrapping procedure with the BSF as described in 3GPP TS 33.220 [8].

8.3 PNM application

In order for the PNM application to support the PN-configuration procedure for querying an XML document, an element within an XML document or an attribute of an element within an XML document, the PNM application shall know the data structure and constraints imposed by the PNM XML schema in annex B. The PNM application shall also be configured to be able to handle the HTTP URIs described in annex C.

Upon receiving a HTTP GET request message, the PNM application verifies the Authorization header by using the bootstrapping transaction identifier B-TID and the key material Ks_NAF obtained from the BSF (as described in 3GPP TS 33.220 [8]).

If the verification succeeds, the PNM application shall perform the requested action and generate a response in accordance with IETF RFC 4825 [6] with an XML body containing either the XML document, or the element within an XML document or the attribute of an element within an XML document as queried by the PN UE.