Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add user stories #118

Merged
merged 18 commits into from
Jul 25, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
18 commits
Select commit Hold shift + click to select a range
50107e1
Add user stories
bigludo7 Jul 5, 2024
1ac7c9e
Update documentation/API_documentation/NumberVerificationdevice_phone…
bigludo7 Jul 8, 2024
0f18860
Update NumberVerification_verify_User_Story following Jorge comments
bigludo7 Jul 15, 2024
43c4446
Update NumberVerificationdevice_phone_number_User_Story following Jor…
bigludo7 Jul 15, 2024
037cecd
Fix small typo
bigludo7 Jul 15, 2024
260e4b9
Update documentation/API_documentation/NumberVerification_verify_User…
bigludo7 Jul 22, 2024
f8ff928
Update documentation/API_documentation/NumberVerification_verify_User…
bigludo7 Jul 22, 2024
66eeae4
Update documentation/API_documentation/NumberVerificationdevice_phone…
bigludo7 Jul 22, 2024
d6f7921
Update documentation/API_documentation/NumberVerificationdevice_phone…
bigludo7 Jul 22, 2024
d2eae61
Update documentation/API_documentation/NumberVerificationdevice_phone…
bigludo7 Jul 22, 2024
916710e
Update documentation/API_documentation/NumberVerificationdevice_phone…
bigludo7 Jul 22, 2024
a6ecc12
Add Communication service Provider in Actors
bigludo7 Jul 22, 2024
0ddfc05
Communication service Provider in Actors
bigludo7 Jul 22, 2024
105860f
changed line to device
bigludo7 Jul 22, 2024
36db56a
Changed line to device
bigludo7 Jul 22, 2024
a12d92e
Update NumberVerification_verify_User_Story.md
bigludo7 Jul 24, 2024
ecade42
Update NumberVerificationdevice_phone_number_User_Story.md
bigludo7 Jul 24, 2024
4ddbc75
Update NumberVerification_verify_User_Story.md
bigludo7 Jul 24, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,12 @@
# Number Verification Verify API User Story

| **Item** | **Details** |
| ---- | ------- |
| ***Summary*** | As an enterprise application developer, I want to verify the phone number associated with the phone from which the call was made, so I can get a proof of possession of the phone number. |

| ***Roles, Actors and Scope*** | **Roles:** Customer:User, Customer:BusinessManager, Customer:Administrator<br> **Actors:** Application service providers, hyperscalers, application developers, end users, Communication Service Provider (CSP). <br> **Scope:** <br> - Verifies if the specified phone number (plain text or hashed format) matches the one that the user is currently using. |
| ***Pre-conditions*** |The preconditions are listed below:<br><ol><li>The Customer:BusinessManager and Customer:Administrator have been onboarded to the CSP's API platform.</li><li>The Customer:BusinessManager has successfully subscribed to the Number Verification product from the product catalog.</li><li>The Customer:Administrator has onboarded the Customer:User to the platform.</li><li>The Customer:User performs an authorization request to CSP.</li><li> The CSP checks access & user approval then provide access token to the Customer:User </li><li> The Customer:User get the access token based on network authentication to ensure secure access of the API.|

| ***Activities/Steps*** | **Starts when:** The customer application makes a POST verify via the number verification API providing in the request the phone number provided by the user on the application. This input could be hashed or plain.<br>**Ends when:** The Number Verification Server responds to confirm whether the provided phone number matches the device from which the request was initiated or not. |
| ***Post-conditions*** | The customer application could continue offering its service to the user with the confirmation of the user phone number. |
| ***Exceptions*** | Several exceptions might occur during the Number Verification API operations<br>- Unauthorized: Not valid credentials (e.g. use of already expired access token).<br>- Invalid input: Not valid input data to invoke operation (e.g. phone number without the '+' prefix).<br>- Not able to provide: Client authentication was not performed via mobile network. Not working on mobile hotspot (tethering) neither Wifi nor VPN mobile connections |
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# Number Verification Device Phone Number API User Story

| **Item** | **Details** |
| ---- | ------- |
| ***Summary*** | As an enterprise application developer, I want to retrieve the phone number associated with the device from which the call was made, so that I can ensure that I obtain the correct phone number and avoid fraud e.g. identity theft. |

| ***Roles, Actors and Scope*** | **Roles:** Customer:User, Customer:BusinessManager, Customer:Administrator<br> **Actors:** Application service providers, hyperscalers, application developers, end users, Communication Service Provider (CSP). <br> **Scope:** <br>-Returns the phone number associated with the access token so API clients can get the phone number and verify it themselves. |
| ***Pre-conditions*** |The preconditions are listed below:<br><ol><li>The Customer:BusinessManager and Customer:Administrator have been onboarded to the CSP's API platform.</li><li>The Customer:BusinessManager has successfully subscribed to the Number Verification product from the product catalog.</li><li>The Customer:Administrator has onboarded the Customer:User to the platform.</li><li>The Customer:user performs an authorization request to CSP</li><li> The CSP checked access & user approval then provide access token to the Customer:user </li><li> The Customer:User gets the access token based on network authentication to ensure secure access of the API.|

| ***Activities/Steps*** | **Starts when:** The customer application makes a POST device phone number via the number verification API.<br>**Ends when:** The Number verification server answers providing the phone number corresponding to the one of the device from which the request was triggered. The customer application can check if this number corresponds to the one keyed by the user.|
| ***Post-conditions*** | The customer application could continue offering its service to the user with the confirmation of the user phone number. |

| ***Exceptions*** | Several exceptions might occur during the Number Verification API operations<br>- Unauthorized: Not valid credentials (e.g. use of already expired access token).<br>- Invalid input: Not valid input data to invoke operation (e.g. phone number without the '+' prefix).<br>- Not able to provide: Client authentication was not performed via mobile network. Not working on mobile hotspot (tethering) neither Wifi nor VPN mobile connections|