DocumentazioneAdobe PassAutenticazione Adobe Pass

Come effettuare una richiesta di accesso a dati personali howto-make-privacy-request

Last update: Fri Nov 07 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
NOTE
Il contenuto di questa pagina viene fornito solo a scopo informativo. L’utilizzo di questa API richiede una licenza corrente da Adobe. Non è consentito alcun uso non autorizzato.

Identificatori e namespace identifier-namespace

Quando si invia una richiesta di accesso o di eliminazione dei dati personali, l’applicazione del cliente deve includere i seguenti identificatori:

  • mvpdID - Identificatore univoco di MVPD.
  • userID - Identifica in modo univoco l'utente dell'app di un programmatore, ma ha origine da MVPD. Consulta Informazioni sugli ID utente nella Panoramica dei programmatori.
  • IMSOrgID - L'ID organizzazione del servizio Adobe Experience Cloud Identity Management, che identifica in modo univoco il cliente in Adobe Experience Cloud

Verifica l’esempio seguente:

"userIDs": [{
     "namespace":"http://www.adobe.com/primetimeAuthentication/Dish",  -----> "Dish" is the id of the MVPD
     "type":"unregistered",
     "value":"1234-5678-8765-4321" ----> "1234-5678-8765-4321" is the userId associated with the MVPD account
}]
IMPORTANT
Per poter generare richieste di accesso a dati personali per l’autenticazione Adobe Pass, gli utenti devono essere autenticati. In caso contrario, i programmatori devono trovare altri mezzi per estrarre l’ID utente di MVPD.

Tipi di richieste req-type

L’autenticazione di Adobe Pass supporta le richieste di accesso ed eliminazione.

Accesso access-req

Per una richiesta di accesso:

Verrà fornito un file JSON contenente un riepilogo del numero totale di richieste di autenticazione e autorizzazione create per l’interessato.
tutti questi eventi vengono filtrati per Cliente.

Esempio di richiesta

Devi caricare un JSON con gli identificatori di autenticazione di Adobe Pass per i quali stai inviando la richiesta di accesso ai dati. Per visualizzare l’aspetto di un JSON ben formato, consulta questo esempio:

{
    "companyContexts": [{
            "namespace": "imsOrgID",
            "value": "1234567890@AdobeOrg"
        }
    ],
    "users": [{
            "key": "John Dow",
            "action": ["access"],
            "userIDs": [{
                "namespace":"http://www.adobe.com/primetimeAuthentication/Dish",
                "type":"unregistered",
                "value":"1234-5678-8765-4321"
             }]

        }
    ],

    "include":["primetimeAuthentication"],
    "regulation" : "ccpa"
}

Esempio di risposta

{
    "jobId": "d9a6b417-f619-4420-82a3-09f61fa8eff3",
    "requestId": "15765127177927284RX-739",
    "userKey": "John Dow",
    "action": "access",
    "status": "complete",
    "submittedBy": "564f7c9a-e0c8-4e74-99b8-20317ae1e235@techacct.adobe.com",
    "createdDate": "12/16/2019 04:11 PM GMT",
    "lastModifiedDate": "12/16/2019 04:15 PM GMT",
    "userIds": [
        {
            "namespace": "http://www.adobe.com/primetimeAuthentication/Dish",
            "value": "1234-5678-8765-4321",
            "type": "unregistered",
            "isDeletedClientSide": false
        }
    ],
    "productResponses": [
        {
            "product": "Adobe Pass Authentication",
            "retryCount": 0,
            "processedDate": "12/16/2019 04:15 PM GMT",
            "productStatusResponse": {
                "status": "complete",
                "results": {
                    "userContexts": [
                        {
                            "namespace": "http://www.adobe.com/primetimeAuthentication/Dish",
                            "namespaceId": 0,
                            "value": "1234-5678-8765-4321",
                            "type": "unregistered"
                        }
                    ],
                    "receiptData": {
                        "createdAt": "2019-12-16T16:15:23.4Z",
                        "message": "Data summary",
                        "numberOfAuthenticationSessions": "6",
                        "numberOfAuthorizationDecisions": "11"
                    }
                },
                "message": "Success"
            }
        }
    ],
    "downloadUrl": "https://va7gdprdevblob.blob.core.windows.net/va7gdprdevblobpublic/usa/4161962b9e8ef0027453d7cc02ecd93d/d9a6b417-f619-4420-82a3-09f61fa8eff3/d9a6b417-f619-4420-82a3-09f61fa8eff3.zip",
    "regulation": "ccpa"
}

Elimina delete-req

Devi caricare un JSON con gli identificatori di autenticazione di Adobe Pass per i quali stai inviando la richiesta di eliminazione dei dati. Per visualizzare l’aspetto di un JSON ben formato, consulta questo esempio:

Esempio di richiesta

{
    "companyContexts": [{
            "namespace": "imsOrgID",
            "value": "1234567890@AdobeOrg"
        }
    ],
    "users": [{
            "key": "John Dow",
            "action": ["delete"],
            "userIDs": [{
                "namespace":"http://www.adobe.com/primetimeAuthentication/Dish",
                "type":"unregistered",
                "value":"1234-5678-8765-4321"
             }]

        }
    ],

    "include":["primetimeAuthentication"],
    "regulation" : "ccpa"
}

Esempio di risposta

Per una richiesta di eliminazione:

  • condividiamo solo una conferma che i dati sono stati rimossi, non un file aggregato con tutti i dati rimossi.
  • la ricevuta inclusa nella risposta contiene un riepilogo del numero totale di token di autenticazione e autorizzazione trovati per l’interessato.
{
    "jobId": "aab380d1-a0cd-4a0d-ba95-2649ee90c063",
    "requestId": "15759883098453100RX-074",
    "userKey": "John Dow",
    "action": "delete",
    "status": "complete",
    "submittedBy": "564f7c9a-e0c8-4e74-99b8-20317ae1e235@techacct.adobe.com",
    "createdDate": "12/10/2019 02:31 PM GMT",
    "lastModifiedDate": "12/10/2019 02:34 PM GMT",
    "userIds": [
        {
            "namespace": "http://www.adobe.com/primetimeAuthentication/Dish",
            "value": "1234-5678-8765-4321",
            "type": "unregistered",
            "isDeletedClientSide": false
        }
    ],
    "productResponses": [
        {
            "product": "Adobe Pass Authentication",
            "retryCount": 0,
            "processedDate": "12/10/2019 02:34 PM GMT",
            "productStatusResponse": {
                "status": "complete",
                "results": {
                    "userContexts": [
                        {
                            "namespace": "http://www.adobe.com/primetimeAuthentication/Dish",
                            "namespaceId": 0,
                            "value": "1234-5678-8765-4321",
                            "type": "unregistered"
                        }
                    ],
                    "receiptData": {
                        "createdAt": "2019-12-10T14:34:55.274Z",
                        "message": "Data summary",
                        "numberOfAuthenticationSessions": "2",
                        "numberOfAuthorizationDecisions": "3"
                    }
                },
                "message": "Success"
            }
        }
    ],
    "downloadUrl": "https://va7gdprdevblob.blob.core.windows.net/va7gdprdevblobpublic/usa/4161962b9e8ef0027453d7cc02ecd93d/aab380d1-a0cd-4a0d-ba95-2649ee90c063/aab380d1-a0cd-4a0d-ba95-2649ee90c063.zip",
    "regulation": "ccpa"
}

Come attivare una richiesta trigger-req

Ci sono 2 opzioni per i clienti per inviare richieste di privacy ad Adobe:

Utilizzando l’interfaccia utente di Privacy Service privacy-service-ui

Un tutorial completo su come accedere e utilizzare l'interfaccia utente di Privacy Service è disponibile online tramite i servizi Adobe I/O. Inoltre, i clienti possono utilizzare questo collegamento per accedere alla libreria di video e articoli sulle normative sulla privacy. Fai clic sul menu Adobe Experience Cloud e RGPD. Verranno aperti diversi video - La guida introduttiva all’interfaccia utente RGPD spiega come utilizzarla.

Nell’interfaccia utente, i clienti devono caricare il proprio IMSOrgID e un JSON contenente i dettagli delle richieste RGPD per ciascun prodotto.

Utilizzando l’API di Privacy Service privacy-service-api

Adobe Experience Platform Privacy Service fornisce un’agevolazione comune e centralizzata delle richieste di accesso/cancellazione e di rinuncia alla vendita di dati privati.

La documentazione API di Privacy Service descrive in modo approfondito come un cliente Adobe può integrarsi con le API di Adobe.

Visualizza chiamate API con Postman (un software gratuito di terze parti):

Percorsi API:

  • URL del gateway della piattaforma: https://platform.adobe.io/
  • Percorso base per questa API: /data/core/privacy/jobs
  • Esempio di percorso completo: https://platform.adobe.io/data/core/privacy/jobs/ping

Intestazioni richieste:

  • Tutte le chiamate richiedono le intestazioni Authorization, x-gw-ims-org-id e x-api-key. Per ulteriori informazioni su come ottenere questi valori, consulta l'esercitazione sull'autenticazione.
  • Tutte le richieste con un payload nel corpo della richiesta (ad esempio chiamate POST, PUT e PATCH) devono includere l'intestazione Content-Type con valore application/json.
recommendation-more-help
3f5e655c-af63-48cc-9769-2b6803cc5f4b