Applicare le etichette di accesso per gestire l’accesso degli utenti ai flussi di dati delle origini utilizzando l’API

Puoi utilizzare le funzionalità fornite da controllo dell'accesso basato su attributi in Real-Time CDP per applicare le etichette ai flussi di dati di origine. Con questa funzione, puoi garantire che solo un sottoinsieme di utenti dell’organizzazione abbia accesso a flussi di dati di origini specifici.

Quando aggiungi un’etichetta di accesso a un particolare flusso di dati, solo gli utenti che hanno accesso a un ruolo a cui è assegnata tale etichetta possono visualizzare e modificare tale flusso di dati. Se un flusso di dati di origine non è contrassegnato con alcuna etichetta, è visibile a tutti gli utenti appartenenti alla tua organizzazione. Ad esempio, se applichi l’etichetta C12 a un flusso di dati, gli utenti assegnati a un ruolo che non dispone dell’etichetta C12 non potranno visualizzare e modificare il flusso di dati con l’etichetta C12.

Leggi questa guida per informazioni su come applicare etichette di accesso ai flussi di dati di origine utilizzando Flow Service API.

Introduzione

Prima di utilizzare le etichette di controllo degli accessi, è necessario conoscere le funzionalità del controllo degli accessi basato su attributi. Per ulteriori informazioni, consulta la seguente documentazione:

Applica etichette di accesso ai flussi di dati di origine

Per aggiungere un'etichetta a un flusso di dati, effettua una richiesta PATCH all'endpoint /flows e fornisci l'ID del flusso di dati da aggiornare.

Formato API

PATCH /flows/{FLOW_ID}

Richiesta

La richiesta seguente aggiunge l'etichetta C12 al flusso di dati con ID: 84224def-1e2a-4d95-9ea2-132d697ed2aa.

curl -X PATCH \
  'https://platform.adobe.io/data/foundation/flowservice/flows/84224def-1e2a-4d95-9ea2-132d697ed2aa' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'Content-Type: application/json' \
  -H 'if-match: "c5002e0e-0000-0200-0000-67a3c3b70000"'
  -d '[
    {
        "op": "add",
        "path": "/labels",
        "value": ["core/C12"]
    }
]'

Risposta

In caso di esito positivo, la risposta restituisce l’ID di flusso e un tag aggiornato. È possibile verificare l'aggiornamento effettuando una richiesta GET all'API Flow Service e fornendo il proprio ID di flusso.

{
    "id": "84224def-1e2a-4d95-9ea2-132d697ed2aa",
    "etag": "\"50014cc8-0000-0200-0000-6036eb720000\""
}

Dopo aver configurato correttamente le etichette di accesso al flusso di dati, qualsiasi utente che non ha accesso a tale etichetta non sarà più in grado di recuperare il flusso di dati. Ad esempio, se un utente che non dispone del provisioning con l'etichetta C12 effettua una richiesta GET per recuperare un flusso di dati con ID: 84224def-1e2a-4d95-9ea2-132d697ed2aa, riceverà la seguente risposta:

{
    "type": "https://ns.adobe.com/aep/errors/FLOW-1439-404",
    "title": "Resource not found",
    "status": 404,
    "report": {
        "detailed-message": "The requested flows resource 84224def-1e2a-4d95-9ea2-132d697ed2aa is not found. Verify the resource ID before trying again.",
        "id": "84224def-1e2a-4d95-9ea2-132d697ed2aa",
        "request-id": "{REQUEST_ID}",
        "type": "flows"
    },
    "errorMessage": "The requested flows resource 84224def-1e2a-4d95-9ea2-132d697ed2aa is not found. Verify the resource ID before trying again.",
    "errorDetails": "The requested flows resource 84224def-1e2a-4d95-9ea2-132d697ed2aa is not found. Verify the resource ID before trying again."
}

Analogamente, gli utenti che non hanno accesso all’etichetta C12 non saranno in grado di effettuare richieste PATCH o DELETE rispetto al flusso di dati aggiornato e riceveranno la seguente risposta:

{
    "type": "https://ns.adobe.com/aep/errors/FLOW-2120-403",
    "title": "Forbidden",
    "status": 403,
    "report": {
        "detailed-message": "You do not have sufficient permissions to perform the operation. Please contact your administrator to resolve permissions and try again.",
        "request-id": "{REQUEST_ID}"
    },
    "errorMessage": "You do not have sufficient permissions to perform the operation. Please contact your administrator to resolve permissions and try again.",
    "errorDetails": "You do not have sufficient permissions to perform the operation. Please contact your administrator to resolve permissions and try again."
}

Passaggi successivi

Ora sai come applicare le etichette di accesso ai flussi di dati di origine. Ora puoi garantire che solo un gruppo specifico di utenti dell’organizzazione possa accedere a determinati flussi di dati di origini. Per ulteriori informazioni, consulta la seguente documentazione: