Maskierung personenidentifizierbarer Informationen in Proxy- und Sharedflow-Bundles verwalten

Sie lesen gerade die Dokumentation zu Apigee Edge.
Zur Dokumentation zu Apigee X. info

Maskierung von personenbezogenen Daten in Proxy- und Sharedflow-Bundles verwalten

Im Rahmen des Synchronisierungsprozesses werden Ihre API-Proxy-Bundles von der API Hub Connector-Integration in API Hub hochgeladen. Diese Bundles können in den Richtlinienkonfigurationen vertrauliche Daten oder personenidentifizierbare Informationen (PII) enthalten. Mit dieser Funktion können Sie identifizierte personenbezogene Daten maskieren, bevor die Bundles in API Hub hochgeladen werden.

Maskierungsansatz

Die Maskierung personenbezogener Daten wird mithilfe von XPath-Ausdrücken angewendet, um bestimmte Elemente in Richtlinienkonfigurationen in den im XML-Format vorliegenden Proxy- und Sharedflow-Bundles zu maskieren. Andere allgemeine XML-Elemente im Bundle werden nicht maskiert. Diese Funktion ist in zwei Teile unterteilt:

Standardmasken

Apigee Edge enthält eine vordefinierte, integrierte Liste von XPath-Ausdrücken, die automatisch auf häufige Felder mit personenbezogenen Daten angewendet werden. Diese Masken werden während des Uploads automatisch angewendet.

Liste der Standardmasken :

Benutzerdefinierte Masken verwalten

Mit einer speziellen API können Sie eine benutzerdefinierte Liste von XPath-Ausdrücken einreichen, um bestimmte Felder zu maskieren, die Sie als personenbezogene Daten identifizieren. So können Sie Ihre individuellen Anforderungen an den Datenschutz erfüllen.

Sie können die benutzerdefinierten Masken für personenbezogene Daten Ihrer Organisation mit dem /v1/organizations/<var>ORG_NAME/uapim/proxymasks Edge Management API-Endpunkt verwalten. Sie benötigen die Rolle orgadmin, um diese Vorgänge auszuführen.

Die API arbeitet mit einer einzelnen Liste von XPaths namens proxymasks für eine bestimmte Organisation.

Alle Anfragen und erfolgreichen Antworten zum Erstellen, Ersetzen, Abrufen, Anhängen oder Löschen von Elementen aus der XPath-Liste verwenden das folgende JSON-Schema:

{
  "xpaths": [
    "//Path/To/Element"
  ]
}

1. Benutzerdefinierte XPath-Liste erstellen oder ersetzen (PUT)

Mit der Methode PUT können Sie entweder eine neue benutzerdefinierte Liste erstellen oder den Inhalt einer vorhandenen Liste vollständig ersetzen. Alle vorhandenen XPaths werden überschrieben.

curl -X PUT https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "xpaths": [
      "//StatisticsCollector/Statistics/Statistic[@name='caller']",
      "//AssignMessage/AssignVariable[Name='password']/Value"
    ]
  }'

Nach Abschluss der Aktualisierung wird eine Antwort vom Typ „201 Created“ oder „200 OK“ mit der folgenden Meldung angezeigt: Success response (201 Created or 200 OK)

{
  "xpaths": [
    "//StatisticsCollector/Statistics/Statistic[@name='caller']",
    "//AssignMessage/AssignVariable[Name='password']/Value"
  ]
}

2. Benutzerdefinierte XPath-Liste abrufen (GET)

Verwenden Sie die Methode GET, um die aktuelle Liste der benutzerdefinierten XPath-Ausdrücke abzurufen.

curl -X GET https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks \
  -H "Authorization: Bearer OAUTH_TOKEN"

Nach Abschluss des Abrufs wird eine Antwort vom Typ „200 OK“ mit der folgenden Meldung angezeigt:Success response (200 OK):

{
  "xpaths": [
    "//StatisticsCollector/Statistics/Statistic[@name='caller']",
    "//AssignMessage/AssignVariable[Name='password']/Value"
  ]
}

3. XPaths an die Liste anhängen (POST append)

Mit der Methode POST können Sie der vorhandenen Liste einen oder mehrere XPath-Ausdrücke hinzufügen, ohne den aktuellen Inhalt zu überschreiben.

curl -X POST https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks/append \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "xpaths": [
      "//New/Appended/XPath"
    ]
  }'

Nach Abschluss des Anhängens wird eine Antwort vom Typ „200 OK“ mit der folgenden Meldung angezeigt: Success response (200 OK):

{
  "xpaths": [
    "//StatisticsCollector/Statistics/Statistic[@name='caller']",
    "//AssignMessage/AssignVariable[Name='password']/Value",
    "//New/Appended/XPath"
  ]
}

4. Bestimmte XPaths aus der Liste löschen (POST deleteItems)

Mit der Methode POST können Sie bestimmte XPath-Ausdrücke aus der vorhandenen Liste entfernen. Die Anfrage muss die genauen XPath-Strings enthalten, die entfernt werden sollen.

curl -X POST https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks/deleteItems \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "xpaths": [
      "//New/Appended/XPath"
    ]
  }'

Nach Abschluss des Löschvorgangs wird eine Antwort vom Typ „200 OK“ mit der folgenden Meldung angezeigt: Success response (200 OK):

{
  "xpaths": [
    "//StatisticsCollector/Statistics/Statistic[@name='caller']",
    "//AssignMessage/AssignVariable[Name='password']/Value"
  ]
}

5. Gesamte benutzerdefinierte XPath-Liste löschen (DELETE)

Mit der Methode DELETE können Sie die benutzerdefinierte XPath-Liste vollständig entfernen. Dadurch werden nur die benutzerdefinierten Masken entfernt. Die Standardmasken werden weiterhin angewendet.

curl -X DELETE https://api.enterprise.apigee.com/v1/organizations/ORG_NAME/uapim/proxymasks \
  -H "Authorization: Bearer OAUTH_TOKEN"

Nach Abschluss des Löschvorgangs wird eine Antwort vom Typ „204 No Content“ mit der folgenden Meldung angezeigt: Success response (204 No Content):

HTTP/1.1 204 No Content

Maskierte Bundles aktualisieren

Wenn Sie Ihre benutzerdefinierte Konfiguration für die Maskierung personenbezogener Daten ändern, müssen API-Proxy-Bundles, die zuvor mit einer älteren Maskierungskonfiguration hochgeladen wurden, mit den neuesten Masken neu verarbeitet werden. Wenn Sie die Bundles mit den neuesten Maskierungseinstellungen aktualisieren möchten, reichen Sie bitte ein Supportticket ein, um die erforderliche Neuverarbeitung zu starten.