From 00a8b356bc9c15045e49a8c81ed45e7729873323 Mon Sep 17 00:00:00 2001 From: crissancas <124909897+crissancas@users.noreply.github.com> Date: Thu, 13 Jun 2024 10:28:37 +0200 Subject: [PATCH 1/3] Add files via upload This contribution intends to provide an overview about how to use Application Endpoint Discovery API --- .../User Stories/User_Story.md | 52 +++++++++++++++++++ 1 file changed, 52 insertions(+) create mode 100644 documentation/SupportingDocuments/API_Documentation/User Stories/User_Story.md diff --git a/documentation/SupportingDocuments/API_Documentation/User Stories/User_Story.md b/documentation/SupportingDocuments/API_Documentation/User Stories/User_Story.md new file mode 100644 index 0000000..c014554 --- /dev/null +++ b/documentation/SupportingDocuments/API_Documentation/User Stories/User_Story.md @@ -0,0 +1,52 @@ + + +# Application Endpoint Discovery API User Story +_This document is based on the [CAMARA Commonalities template for User Stories](https://github.com/camaraproject/Commonalities/blob/main/documentation/Userstory-template.md)_ +_Roles are referenced from the ITU-T Cloud Refence Architecture._ + +## Summary +"As an User, I want to connect my application to the optimal application instance running in an Edge Cloud Zone. The Application Endpoint Discovery API allows me to achieve this by providing direct access to the closest application endpoints within these zones. By using device-specific identifiers such as IP-Address, Phone-Number, or Network-Access-Identifier, I can ensure precise localization and connection to the best available endpoint. To maintain security and integrity, the API requires robust authentication and authorization processes using OpenID Connect and OAuth 2.0, with secure transmission over HTTPS and comprehensive error handling mechanisms to manage permissions and secure data transmission.". + + +## Actors, Roles, and Scope +| Actor | Role | Scope | +|-------|------|-------| +|Application Provider (AP) |API Consumer | API Requester | +|Edge Platform (EP)|Edge Cloud Provider | API Publisher | +|Edge Service Provider (ESP)|Edge Cloud Provider|API Publisher +|Operator|Communications Service Provider|API Publisher +|User Client(UC)|API Consumer|API Requester + +Note: the role of Edge Service Provider may be played by either the MNO or Cloud Service Providers (Hyperscalers). + +| Item | Description | Support Qualifier | +|----|----|----| +|Summary|The Application Endpoint Discovery API extends the capabilities of the Simple Edge Discovery API by locating the nearest Edge Cloud Zone and directly linking to application endpoints within those zones. This API enables immediate connection to the most optimal service endpoint, optimizing the application's interaction with edge computing resources. By providing the actual endpoints, developers can instantly integrate these into their applications, improving user experience by minimizing latency and enhancing service responsiveness.| M | +|Pre-conditions|The AP has a resource usage agreement with the Operator| M | +|Begins when|The user client request access to the application| M | +|Step 1|The User invokes the Application Endpoint Discovery API to request an endpoint of the closest Edge Cloud Zone for this user (using MSISDN, IP-Address, or Network-Access-Identifier)| M | +|Step 2|The Application Endpoint Discovery API returns an endpoint of the closest application instance for this user.| M| +|Step 3|The User stablish the connectivity with the application instance| M| +|Ends when|The user successfully connects to the instance| M | + + + + +## Flow +```mermaid +sequenceDiagram + participant UC + participant Auth Server + participant ESP + participant Operator + + UC->>Auth Server: Token Request + Auth Server-->>UC: + Note over Auth Server,UC: OpenID Connect Authenticationn + UC->>ESP: GET request `/apps-endpoints?filter=closest` + Note right of UC: -
- Phone-Number
- AppId + ESP-->>Operator: + Operator-->>ESP : User Location + ESP-->>UC: 200 OK: + +``` From ac8d09cd12855af2b94ebedc935a170afc5631b8 Mon Sep 17 00:00:00 2001 From: Jhon Javier Loza Lluco <150795747+javierlozallu@users.noreply.github.com> Date: Thu, 13 Jun 2024 10:58:38 +0200 Subject: [PATCH 2/3] Rename User_Story.md to Application Endpoint Discovery User Story.md --- ...User_Story.md => Application Endpoint Discovery User Story.md} | 0 1 file changed, 0 insertions(+), 0 deletions(-) rename documentation/SupportingDocuments/API_Documentation/User Stories/{User_Story.md => Application Endpoint Discovery User Story.md} (100%) diff --git a/documentation/SupportingDocuments/API_Documentation/User Stories/User_Story.md b/documentation/SupportingDocuments/API_Documentation/User Stories/Application Endpoint Discovery User Story.md similarity index 100% rename from documentation/SupportingDocuments/API_Documentation/User Stories/User_Story.md rename to documentation/SupportingDocuments/API_Documentation/User Stories/Application Endpoint Discovery User Story.md From b619b0f4b373ed676d4810ebba12e134039ebbbd Mon Sep 17 00:00:00 2001 From: Jose Manuel Conde <162570687+JoseMConde@users.noreply.github.com> Date: Wed, 16 Oct 2024 12:34:03 +0200 Subject: [PATCH 3/3] Update documentation/SupportingDocuments/API_Documentation/User Stories/Application Endpoint Discovery User Story.md Co-authored-by: Kevin Smith --- .../User Stories/Application Endpoint Discovery User Story.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/documentation/SupportingDocuments/API_Documentation/User Stories/Application Endpoint Discovery User Story.md b/documentation/SupportingDocuments/API_Documentation/User Stories/Application Endpoint Discovery User Story.md index c014554..329c1de 100644 --- a/documentation/SupportingDocuments/API_Documentation/User Stories/Application Endpoint Discovery User Story.md +++ b/documentation/SupportingDocuments/API_Documentation/User Stories/Application Endpoint Discovery User Story.md @@ -24,7 +24,7 @@ Note: the role of Edge Service Provider may be played by either the MNO or Cloud |Summary|The Application Endpoint Discovery API extends the capabilities of the Simple Edge Discovery API by locating the nearest Edge Cloud Zone and directly linking to application endpoints within those zones. This API enables immediate connection to the most optimal service endpoint, optimizing the application's interaction with edge computing resources. By providing the actual endpoints, developers can instantly integrate these into their applications, improving user experience by minimizing latency and enhancing service responsiveness.| M | |Pre-conditions|The AP has a resource usage agreement with the Operator| M | |Begins when|The user client request access to the application| M | -|Step 1|The User invokes the Application Endpoint Discovery API to request an endpoint of the closest Edge Cloud Zone for this user (using MSISDN, IP-Address, or Network-Access-Identifier)| M | +|Step 1|The User invokes the Application Endpoint Discovery API to request the endpoint of the closest Application instance to the user (user is identified using MSISDN, IP-Address, or Network-Access-Identifier). | M | |Step 2|The Application Endpoint Discovery API returns an endpoint of the closest application instance for this user.| M| |Step 3|The User stablish the connectivity with the application instance| M| |Ends when|The user successfully connects to the instance| M |