Anwenden von Zugriffskennzeichnungen zur Verwaltung des Benutzerzugriffs auf Datenflüsse mithilfe der -API

Real-Time CDP Sie können die von der attributbasierten Zugriffssteuerung) in ​ bereitgestellten Funktionen verwenden, um Beschriftungen auf Ihre Quelldatenflüsse anzuwenden. Mit dieser Funktion können Sie sicherstellen, dass nur eine Untergruppe von Benutzern in Ihrer Organisation Zugriff auf bestimmte Quellen und Datenflüsse erhält.

Wenn Sie einem bestimmten Datenfluss eine Zugriffsbeschriftung hinzufügen, können nur Benutzer, die Zugriff auf eine Rolle haben, der diese Beschriftung zugewiesen ist, diesen Datenfluss anzeigen und bearbeiten. Wenn ein Quelldatenfluss nicht mit Beschriftungen gekennzeichnet ist, ist er für alle Benutzer sichtbar, die zu Ihrer Organisation gehören. Wenn Sie beispielsweise die Kennzeichnung C12 auf einen Datenfluss anwenden, können Benutzende, denen eine Rolle zugewiesen wurde, die nicht über die Kennzeichnung C12 verfügt, den Datenfluss nicht mit der Kennzeichnung C12 anzeigen und bearbeiten.

Lesen Sie dieses Handbuch, um Informationen zum Anwenden von Zugriffsbeschriftungen auf Ihre Quellen-Datenflüsse mithilfe der Flow Service API zu erhalten.

Erste Schritte

Bevor Sie mit Zugriffssteuerungsbeschriftungen arbeiten, stellen Sie sicher, dass Sie sich zunächst mit den Funktionen der attributbasierten Zugriffssteuerung vertraut machen. Weitere Informationen finden Sie in der folgenden Dokumentation:

Anwenden von Zugriffskennzeichnungen auf Quellen-Datenflüsse

Um einem Datenfluss eine Kennzeichnung hinzuzufügen, stellen Sie eine PATCH-Anfrage an den /flows-Endpunkt und geben Sie die ID des Datenflusses an, den Sie aktualisieren möchten.

API-Format

PATCH /flows/{FLOW_ID}

Anfrage

Die folgende Anfrage fügt die C12-Kennzeichnung zum Datenfluss mit der ID hinzu: 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"]
    }
]'

Antwort

Bei einer erfolgreichen Antwort werden Ihre Fluss-ID und ein aktualisiertes eTag zurückgegeben. Sie können die Aktualisierung überprüfen, indem Sie eine GET-Anfrage an die Flow Service-API stellen und dabei Ihre Fluss-ID angeben.

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

Nachdem Sie Zugriffsbeschriftungen für Ihren Datenfluss erfolgreich konfiguriert haben, können Benutzer, die keinen Zugriff auf diese Beschriftung haben, den Datenfluss nicht mehr abrufen. Wenn beispielsweise eine Benutzerin oder ein Benutzer, die bzw. der nicht über die C12-Kennzeichnung verfügt, eine GET-Anfrage zum Abrufen des Datenflusses mit der ID 84224def-1e2a-4d95-9ea2-132d697ed2aa stellt, erhält sie bzw. er die folgende Antwort:

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

Ebenso können Benutzende ohne Zugriff auf die C12-Kennzeichnung keine PATCH- oder DELETE-Anfragen für den aktualisierten Datenfluss stellen und erhalten die folgende Antwort:

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

Nächste Schritte

Sie wissen jetzt, wie Sie Zugriffsbeschriftungen auf Ihre Quelldatenflüsse anwenden. Sie können jetzt sicherstellen, dass nur eine bestimmte Benutzergruppe in Ihrer Organisation auf bestimmte Datenflüsse für Quellen zugreifen kann. Weitere Informationen finden Sie in der folgenden Dokumentation: