@@ -72,31 +72,23 @@ info:
72
72
- **call-forwardings**: Which is the status of the call forwarding for a
73
73
specific phone number?
74
74
# Authorization and authentication
75
- CAMARA guidelines defines a set of authorization flows which can grant API
76
- clients access to the API functionality, as outlined in the document
77
- [CAMARA-API-access-and-user-consent.md] (https:\
78
- //github.com/camaraproject/IdentityAndConsentManagement/blob/main/ \
79
- documentation/CAMARA-API-access-and-user-consent.md).
75
+ The "Camara Security and Interoperability Profile" provides details on how
76
+ a client requests an access token. Please refer to Identify and Consent
77
+ Management (https://github.com/camaraproject/IdentityAndConsentManagement/)
78
+ for the released version of the Profile. \
79
+ \
80
80
Which specific authorization flows are to be used will be determined during
81
- onboarding process, happening between the API Client and the
82
- Telco Operator exposing the API, taking into account the declared purpose
83
- for accessing the API, while also being subject to the prevailing legal
84
- framework dictated by local legislation.\
85
- Specifically, for the CFS API, the CIBA flow should be adopted. The CIBA
86
- flow is described here:[CIBA Flow](https://github.com/camaraproject/\
87
- IdentityAndConsentManagement/blob/main/documentation/\
88
- CAMARA-Security-Interoperability.md\
89
- #client-initiated-backchannel-authentication-flow). The "login_hint" must be
90
- the user's phone number valorised as the parameter PhoneNumber, if used. If
91
- a mismatch is detected, a 403 error is returned (`INVALID_TOKEN_CONTEXT`).
81
+ onboarding process, happening between the API Client and the Telco Operator
82
+ exposing the API, taking into account the declared purpose for accessing the
83
+ API, while also being subject to the prevailing legal framework dictated by
84
+ local legislation.\
92
85
\
93
86
It is important to remark that in cases where personal user data is
94
87
processed by the API, and users can exercise their rights through mechanisms
95
88
such as opt-in and/or opt-out, the use of 3-legged access tokens becomes
96
- mandatory.
97
- This measure ensures that the API remains in strict compliance with user
98
- privacy preferences and regulatory obligations,
99
- upholding the principles of transparency and user-centric data control.
89
+ mandatory. This measure ensures that the API remains in strict compliance
90
+ with user privacy preferences and regulatory obligations, upholding the
91
+ principles of transparency and user-centric data control.
100
92
# Identifying the phone number from the access token
101
93
This specification defines the "phoneNumber" field as optional in API
102
94
requests because using a 3-legged access token the phone number can be
0 commit comments