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.