Toegangslabels toepassen om gebruikerstoegang tot brongegevens te beheren met behulp van de API

U kunt de functies gebruiken die door ​ op attributen-gebaseerde toegangscontrole ​ in Real-Time CDP worden verstrekt om etiketten op uw brongegevens toe te passen. Met deze eigenschap, kunt u ervoor zorgen dat slechts een ondergroep van gebruikers in uw organisatie toegang tot specifieke brongegevens krijgt.

Wanneer u een toegangslabel aan een bepaalde gegevensstroom toevoegt, slechts kunnen de gebruikers die toegang tot een rol hebben die dat etiket wordt toegewezen dat dataflow bekijken en uitgeven. Als een gegevensstroom van bronnen niet met om het even welke etiketten wordt gemerkt, is het zichtbaar aan alle gebruikers die tot uw organisatie behoren. Als u bijvoorbeeld het label C12 toepast op een gegevensstroom, kunnen gebruikers die zijn toegewezen aan een rol die niet het label C12 heeft, de gegevensstroom niet weergeven en bewerken met het label C12.

Lees deze gids voor informatie over hoe te om toegangslabels op uw brongegevens toe te passen gebruikend Flow Service API ​.

Aan de slag

Alvorens met de etiketten van de toegangscontrole te werken, zorg ervoor dat u zich eerst met de mogelijkheden van op attribuut-gebaseerde toegangsbeheer vertrouwt. Raadpleeg de volgende documentatie voor meer informatie:

Toegangslabels toepassen op gegevensstromen van bronnen

Als u een label aan een gegevensstroom wilt toevoegen, vraagt u PATCH het /flows -eindpunt aan en geeft u de id van de gegevensstroom op die u wilt bijwerken.

API formaat

PATCH /flows/{FLOW_ID}

Verzoek

Met de volgende aanvraag wordt het label C12 aan de gegevensstroom met de id: 84224def-1e2a-4d95-9ea2-132d697ed2aa toegevoegd.

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"]
    }
]'

Reactie

Een geslaagde reactie retourneert uw flow-id en een bijgewerkt label. U kunt de update verifiëren door een GET-aanvraag in te dienen bij de Flow Service API en tegelijk uw flow-id op te geven.

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

Zodra u met succes toegangsetiketten aan uw gegevensstroom hebt gevormd, zal om het even welke gebruiker die geen toegang tot dat etiket heeft niet meer de dataflow kunnen terugwinnen. Als een gebruiker die niet is voorzien van het label C12, bijvoorbeeld een GET-aanvraag indient om de gegevensstroom met de id op te halen: 84224def-1e2a-4d95-9ea2-132d697ed2aa , ontvangt hij of zij het volgende antwoord:

{
    "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."
}

Op dezelfde manier kunnen gebruikers zonder toegang tot het label C12 geen PATCH- of DELETE-aanvragen indienen tegen de bijgewerkte gegevensstroom en krijgen ze de volgende reactie:

{
    "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."
}

Volgende stappen

U weet nu hoe u toegangslabels op de gegevensstromen van uw bronnen kunt toepassen. U kunt er nu voor zorgen dat alleen een specifieke groep gebruikers in uw organisatie toegang heeft tot bepaalde gegevensstromen van bronnen. Lees de volgende documentatie voor meer informatie: