Maskierung personenidentifizierbarer Informationen in Proxy- und Sharedflow-Bundles verwalten

Sie lesen gerade die Dokumentation zu Apigee Edge.
Apigee X-Dokumentation aufrufen. info

PII-Maskierung in Proxy- und Sharedflow-Bundles verwalten

Im Rahmen der Synchronisierung werden Ihre API-Proxy-Bundles über die API-Hub-Connector-Integration in den API-Hub hochgeladen. Diese Pakete können in Richtlinienkonfigurationen vertrauliche Daten oder personenbezogene Daten enthalten. Mit dieser Funktion können Sie erkannte Felder mit personenbezogenen Daten maskieren, bevor die Bundles in den API-Hub hochgeladen werden.

Maskierungsansatz

Die Maskierung personenbezogener Daten erfolgt mithilfe von XPath-Ausdrücken, um bestimmte Elemente in Richtlinienkonfigurationen in den XML-formatierten Proxy- und Sharedflow-Bundles zu erfassen, jedoch nicht für andere allgemeine XML-Elemente im Bundle. Diese Funktion ist in zwei Teile unterteilt:

Standardmasken

Apigee Edge enthält eine vordefinierte, integrierte Liste von XPath-Ausdrücken, die automatisch auf gängige PII-Felder ausgerichtet sind. 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 personenidentifizierbare Informationen identifizieren. So wird sichergestellt, dass Ihre individuellen Datenschutzanforderungen erfüllt werden.

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

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

Für alle Anfragen und erfolgreichen Antworten zum Erstellen, Ersetzen, Abrufen, Anhängen oder Löschen von Elementen aus der XPath-Liste wird das folgende JSON-Schema verwendet:

{
  "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 des Updates wird die Antwort „201 Created“ oder „200K“ 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 200K-Antwort mit der folgenden Meldung angezeigt:Success response (200 OK):

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

3. XPath-Ausdrücke an die Liste anhängen (POST append)

Mit der Methode POST können Sie der vorhandenen Liste ein 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 200K-Antwort 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)

Verwenden Sie die Methode POST, um bestimmte XPath-Ausdrücke aus der vorhandenen Liste zu entfernen. Der Antrag 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 200K-Antwort 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)

Verwenden Sie die Methode DELETE, um die benutzerdefinierte XPath-Liste vollständig zu entfernen. Dadurch werden nur die benutzerdefinierten Masken entfernt. 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 die Antwort „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 personenidentifizierbarer Informationen ändern, müssen API-Proxy-Sets, die zuvor mit einer älteren Maskenkonfiguration hochgeladen wurden, mit den neuesten Masken neu verarbeitet werden. Wenn Sie die Bundles mit den neuesten Maskierungseinstellungen aktualisieren möchten, reichen Sie bitte ein Support-Ticket ein, um die erforderliche Neuverarbeitung zu starten.