Skip to content

Commit 3b72d16

Browse files
info.description update
info.description: updated the "Authorization and authentication" section according to: #90
1 parent 0b0b2f3 commit 3b72d16

File tree

1 file changed

+12
-20
lines changed

1 file changed

+12
-20
lines changed

code/API_definitions/Call_Forwarding_Signal.yaml

+12-20
Original file line numberDiff line numberDiff line change
@@ -72,31 +72,23 @@ info:
7272
- **call-forwardings**: Which is the status of the call forwarding for a
7373
specific phone number?
7474
# 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+
\
8080
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.\
9285
\
9386
It is important to remark that in cases where personal user data is
9487
processed by the API, and users can exercise their rights through mechanisms
9588
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.
10092
# Identifying the phone number from the access token
10193
This specification defines the "phoneNumber" field as optional in API
10294
requests because using a 3-legged access token the phone number can be

0 commit comments

Comments
 (0)