From 5b441942cfaa55794584f884399324bfaedf26f9 Mon Sep 17 00:00:00 2001
From: Jorge Garcia Hospital
<129095857+jgarciahospital@users.noreply.github.com>
Date: Wed, 17 Jul 2024 17:00:36 +0200
Subject: [PATCH 01/11] Create API_Proposal_Consent_URL_API.md
---
.../API proposals/API_Proposal_Consent_URL_API.md | 12 ++++++++++++
1 file changed, 12 insertions(+)
create mode 100644 documentation/API proposals/API_Proposal_Consent_URL_API.md
diff --git a/documentation/API proposals/API_Proposal_Consent_URL_API.md b/documentation/API proposals/API_Proposal_Consent_URL_API.md
new file mode 100644
index 0000000..19cb160
--- /dev/null
+++ b/documentation/API proposals/API_Proposal_Consent_URL_API.md
@@ -0,0 +1,12 @@
+| **Field** | Description |
+| ---- | ----- |
+| API family name | Consent URL API (TBC)|
+| API family owner | Telefonica |
+| API summary | Current consent management is based on:
- **Frontend flow (Authcode)**: Since the authorization code grant involves the interaction with application front-end, consent can be captured directly from the user through the application browser. Taking advantage of the frontend flow, consent can directly be captured through an interactive dialogue with the End-User,
- **Backend flow (CIBA)**: Out-of-band consent capture is employed in backend flows as part of asynchronous CIBA flow, where operator gets in charge of reaching the End-User and capturing the consent if needed, based on the channels that each operator supports (e.g. push notification with fallback to SMS, etc...).
Developers are therefore mandated to capture the consent in the frontend flow, or delegate the moment of capture in the operator, which may or may not be able to reach the customer in a succesful way.
With the proposed API, the developer will be able to request for a consent capture process when they find it's more suitable, by specifying the scope(s) and purpose that they require to access data from a specific end-user.
The API takes advantage of the developer's knowledge of the customers, based on the use case that they manage, to trigger the consent capture process in the moment and channel that best fit with each customer, while ensuring that the privacy management and ownership remains in the operator. The process can be included in onboarding processes, where developer can gather the consent in advance getting ready by the moment the API(s) need to be called.|
+| Technical viability | The API creates a consent capture URL, provided by the operator and following same or similar interactive dialogue as in frontend flow, that allows the developer to provide a consent capture process to the end-user, based on the requested API scope and purpose that the developer is later going to use.
**Inputs Explained:**
- **User identifier**: Phone number of the end-user, which identifies the line whose consent is required to access the specific service.
- **Scope**: List of API PIScope(s) and a specific purpose, following the format defined by [CAMARA-API-access-and-user-consent.md](https://github.com/camaraproject/IdentityAndConsentManagement/blob/main/documentation/CAMARA-API-access-and-user-consent.md)
**Output:**
- **Consent URL**: URL containing the content capture procedure of the telco, including its own subscriber authentication. |
+| Commercial viability | **Current use cases validating the service:**
1. **Consent capture during end-user onboarding**: The developer, when registering the user in a digital or phisical procedure, can take advantange of the presence of the end-user during the process to pre-capture the consent for the set of APIs that the user is later going to require.
2. **Consent capture in application notification**: Developers can push a notification in their app so that customers can access directly to the consent capture process in this easy-to-access place.
3. **Consent capture campaigns**: Applications can create campaigns by email or other channels to capture the consent for substantial chunks of their user base. |
+| YAML code available? | NO
To be provided |
+| Validated in lab/productive environments? | YES |
+| Validated with real customers? | YES |
+| Validated with operators? | NO
|
+| Supporters in API Backlog Working Group | Telefonica |
From 93ca49939e9f742c631911163d4b9416e9efa7a7 Mon Sep 17 00:00:00 2001
From: Jorge Garcia Hospital
<129095857+jgarciahospital@users.noreply.github.com>
Date: Thu, 18 Jul 2024 12:07:40 +0200
Subject: [PATCH 02/11] Correcting typos.
Co-authored-by: Axel Nennker
---
documentation/API proposals/API_Proposal_Consent_URL_API.md | 2 +-
1 file changed, 1 insertion(+), 1 deletion(-)
diff --git a/documentation/API proposals/API_Proposal_Consent_URL_API.md b/documentation/API proposals/API_Proposal_Consent_URL_API.md
index 19cb160..13ae24a 100644
--- a/documentation/API proposals/API_Proposal_Consent_URL_API.md
+++ b/documentation/API proposals/API_Proposal_Consent_URL_API.md
@@ -4,7 +4,7 @@
| API family owner | Telefonica |
| API summary | Current consent management is based on:
- **Frontend flow (Authcode)**: Since the authorization code grant involves the interaction with application front-end, consent can be captured directly from the user through the application browser. Taking advantage of the frontend flow, consent can directly be captured through an interactive dialogue with the End-User,
- **Backend flow (CIBA)**: Out-of-band consent capture is employed in backend flows as part of asynchronous CIBA flow, where operator gets in charge of reaching the End-User and capturing the consent if needed, based on the channels that each operator supports (e.g. push notification with fallback to SMS, etc...).
Developers are therefore mandated to capture the consent in the frontend flow, or delegate the moment of capture in the operator, which may or may not be able to reach the customer in a succesful way.
With the proposed API, the developer will be able to request for a consent capture process when they find it's more suitable, by specifying the scope(s) and purpose that they require to access data from a specific end-user.
The API takes advantage of the developer's knowledge of the customers, based on the use case that they manage, to trigger the consent capture process in the moment and channel that best fit with each customer, while ensuring that the privacy management and ownership remains in the operator. The process can be included in onboarding processes, where developer can gather the consent in advance getting ready by the moment the API(s) need to be called.|
| Technical viability | The API creates a consent capture URL, provided by the operator and following same or similar interactive dialogue as in frontend flow, that allows the developer to provide a consent capture process to the end-user, based on the requested API scope and purpose that the developer is later going to use.
**Inputs Explained:**
- **User identifier**: Phone number of the end-user, which identifies the line whose consent is required to access the specific service.
- **Scope**: List of API PIScope(s) and a specific purpose, following the format defined by [CAMARA-API-access-and-user-consent.md](https://github.com/camaraproject/IdentityAndConsentManagement/blob/main/documentation/CAMARA-API-access-and-user-consent.md)
**Output:**
- **Consent URL**: URL containing the content capture procedure of the telco, including its own subscriber authentication. |
-| Commercial viability | **Current use cases validating the service:**
1. **Consent capture during end-user onboarding**: The developer, when registering the user in a digital or phisical procedure, can take advantange of the presence of the end-user during the process to pre-capture the consent for the set of APIs that the user is later going to require.
2. **Consent capture in application notification**: Developers can push a notification in their app so that customers can access directly to the consent capture process in this easy-to-access place.
3. **Consent capture campaigns**: Applications can create campaigns by email or other channels to capture the consent for substantial chunks of their user base. |
+| Commercial viability | **Current use cases validating the service:**
1. **Consent capture during end-user onboarding**: The developer, when registering the user in a digital or physical procedure, can take advantage of the presence of the end-user during the process to pre-capture the consent for the set of APIs that the user is later going to require.
2. **Consent capture in application notification**: Developers can push a notification in their app so that customers can access directly to the consent capture process in this easy-to-access place.
3. **Consent capture campaigns**: Applications can create campaigns by email or other channels to capture the consent for substantial chunks of their user base. |
| YAML code available? | NO
To be provided |
| Validated in lab/productive environments? | YES |
| Validated with real customers? | YES |
From 31cd6506c18aeee55247c29f55b9e98fa720fb10 Mon Sep 17 00:00:00 2001
From: Jorge Garcia Hospital
<129095857+jgarciahospital@users.noreply.github.com>
Date: Tue, 23 Jul 2024 10:56:30 +0200
Subject: [PATCH 03/11] Add files via upload
---
.../Out_of_Band Consent Capture URL.pptx | Bin 0 -> 5578237 bytes
1 file changed, 0 insertions(+), 0 deletions(-)
create mode 100644 documentation/SupportingDocuments/Out_of_Band Consent Capture URL.pptx
diff --git a/documentation/SupportingDocuments/Out_of_Band Consent Capture URL.pptx b/documentation/SupportingDocuments/Out_of_Band Consent Capture URL.pptx
new file mode 100644
index 0000000000000000000000000000000000000000..83a3e62490bf017b082ecbe6808789741a4716bb
GIT binary patch
literal 5578237
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