camaraproject / NumberVerification

Repository to describe, develop, document and test the Number Verification API family
Apache License 2.0
16 stars 21 forks source link

Rephrase description in yaml #101

Closed AxelNennker closed 4 months ago

AxelNennker commented 5 months ago

Problem description 1) The description confused "user" and "subscriber".

Example re 1: Network operators know to which user a network resource is assigned at a given moment Network operators know to which subscriber a network resource is assigned at a given moment

The user might be the subscriber's child or any other person using the device.

2) The term 3-legged tokenis not defined.

Expected action Rephrase the user - subscriber text.

Either define 3-legged token or rephrase. Clarify prompt=none and 3-legged token and user consent/privacy.

mhfoo commented 5 months ago

Clarify prompt=none

Based on 3.1.2.1. Authentication Request, the prompt should be consent.

prompt OPTIONAL. Space-delimited, case-sensitive list of ASCII string values that specifies whether the Authorization Server prompts the End-User for reauthentication and consent. The defined values are: none The Authorization Server MUST NOT display any authentication or consent user interface pages. An error is returned if an End-User is not already authenticated or the Client does not have pre-configured consent for the requested Claims or does not fulfill other conditions for processing the request. The error code will typically be login_required, interaction_required, or another code defined in Section 3.1.2.6. This can be used as a method to check for existing authentication and/or consent. login The Authorization Server SHOULD prompt the End-User for reauthentication. If it cannot reauthenticate the End-User, it MUST return an error, typically login_required. consent The Authorization Server SHOULD prompt the End-User for consent before returning information to the Client. If it cannot obtain consent, it MUST return an error, typically consent_required. select_account The Authorization Server SHOULD prompt the End-User to select a user account. This enables an End-User who has multiple accounts at the Authorization Server to select amongst the multiple accounts that they might have current sessions for. If it cannot obtain an account selection choice made by the End-User, it MUST return an error, typically account_selection_required.

AxelNennker commented 5 months ago

Sorry, I did not mean to clarify "prompt=none" per se but the relationship to privacy and consent