8.6.5 UE Identifier API

23.5583GPPArchitecture for enabling Edge ApplicationsRelease 18TS

8.6.5.1 General

EES exposes UE Identifier API to the EAS in order to provide an identifier uniquely identifying a UE. This API is used by an EAS to obtain the identifier of the UE if the EAS does not have it. This identifier, called UE ID, is used by the EAS to invoke capability APIs specific to UEs over EDGE-3. The UE ID is specific to the given EAS and it is represented as a GPSI assigned by the 3GPP Core Network.

8.6.5.2 Procedure

Figure 8.6.5.2-1 illustrates the interactions between the EES and the EAS.

Pre-conditions:

1. The EAS is authorized to discover and to use UE Identifier API provided by the EES.

Figure 8.6.5.2-1: UE Identifier API

1. The EAS invokes UE Identifier API exposed by the EES.

2. The EES uses the received user information in the step 1 (e.g. IP address) and obtains the UE identifier by interacting with NEF as specified in clause 4.15.10 of 3GPP TS 23.502 [3].

3. The EES provides the obtained UE identifier as UE ID to the EAS.

Editor’s note: [SA3] Whether and how user’s consent is obtained to share the UE identifier with a particular EAS is SA3’s responsibility.

4. The EAS uses the UE ID received in step 3 to invoke capability exposure API(s) provided by the EES over EDGE-3.

8.6.5.3 Information flows

8.6.5.3.1 General

The following information flows are specified for UE Identifier API:

– UE Identifier request and response.

8.6.5.3.2 UE Identifier API request

Table 8.6.5.3.2-1: UE Identifier API request

Information element

Status

Description

User information

M

Information about the User or UE available in the EAS, e.g. IP address.

EAS ID

M

Identifier of the EAS providing the application services.

EAS Provider ID

O

Identifier of the ASP that provides the EAS.

Security Credentials

M

Security credentials of the EAS.

Editor’s Note: [SA3] Whether the EAS ID and the EAS Provider ID are part of the security credential is SA3’s responsibility.

8.6.5.3.3 UE Identifier API response

Table 8.6.5.3.3-2: UE Identifier API response

Information element

Status

Description

Successful response

O

Indicates that the UE identifier request was successful.

> UE ID

M

Identifier uniquely identifying the UE.

Failure response

O

Indicates that the UE identifier request failed.

> Cause

O

Indicates the cause of UE identifier request failure

8.6.5.4 APIs

8.6.5.4.1 General

Table 8.6.5.4.1-1 illustrates the APIs for UE Identifier.

Table 8.6.5.4.1-1: Eees_UE_Identifier API

API Name

API Operations

Operation

Semantics

Consumer(s)

Eees_UEIdentifier

Get

Request/Response

EAS

8.6.5.4.2 Eees_UEIdentifier_Get operation

API operation name: Eees_UEIdentifier_Get

Description: The consumer requests identifier of a UE.

Inputs: See clause 8.6.5.3.2.

Outputs: See clause 8.6.5.3.3.

See clause 8.6.5.2 for details of usage of this operation.