DataPower Gateway

Neubearbeitung - DataPower Gateway (v5 compatible)

Verwenden Sie die Richtlinie Neubearbeitung , um angegebene Felder vollständig aus dem Anforderungshauptteil, dem Antworthauptteil und den Aktivitätenprotokollen zu entfernen oder neu zu bearbeiten. Diese Richtlinie kann nützlich sein, um sensible Daten (z. B. Kreditkartendaten) aus rechtlichen, sicherheitstechnischen oder anderen Gründen zu entfernen oder zu blockieren.

Gateway-Unterstützung

Hinweis: In diesem Abschnitt wird die Richtlinienimplementierung Neubearbeitung in DataPower® Gateway (v5 compatible)beschrieben. Wenn Sie das verwenden DataPower API Gateway, lesen Sie bitte den Abschnitt „Redaction“ unter DataPowerAPI Gateway.

Informationen zu den verschiedenen Gateway-Typen finden Sie unter API Connect -Gateway-Typen.

Tabelle 1. Tabelle, aus der hervorgeht, welche Gateways diese Richtlinie unterstützen, sowie die entsprechende Richtlinienversion
Gateway Richtlinienversion
DataPower Gateway (v5 compatible) 1.0.0

In diesem Thema wird beschrieben, wie Sie die Richtlinie in der Benutzeroberfläche von Assembly konfigurieren. Einzelheiten zur Konfiguration der Richtlinie in Ihrer „ OpenAPI “-Quelle finden Sie unter „redact“ – DataPower Gateway (kompatibel mit v5 ).

Produktinfo

Eigenschaften

Die folgende Tabelle enthält die Richtlinieneigenschaften, gibt an, ob eine Eigenschaft erforderlich ist, enthält die gültigen Werte und die Standardwerte für Eingaben und gibt den jeweiligen Datentyp der Werte an.

Tabelle 2. Eigenschaften der Schwärzungsrichtlinie
Eigenschaftsbezeichnung Erforderlich Beschreibung Datentyp
Titel Nein Der Titel der Richtlinie.

Der Standardwert ist redact.

Zeichenfolge
Beschreibung Nein Eine Beschreibung der Richtlinie. Zeichenfolge
Path Ja Gibt einen XPath-Ausdruck an, der das zu entfernende oder neu zu bearbeitende Feld definiert.

Sie können einen XPath-Ausdruck erstellen, der auf JSON oder XML basiert, je nachdem, ob Ihre API-Anforderungen und -Antworten ein JSON- oder ein XML-Format verwenden. Wenn die Nutzdaten JSON sind, verwenden Sie die DataPower XML-Darstellung des JSON-Inhalts (JSONx), um den Ausdruck zu erstellen.

Hinweis: Verwenden Sie eine JSONx-Darstellung nur, um die XPath-Ausdrücke für die zu entfernenden oder zu redigenden Felder anzugeben. Ändern Sie nicht das Format von Antworthauptteilen in API Manager.

Weitere Informationen zum Erstellen von XPath-Ausdrücken auf Basis von JSON oder XML finden Sie unter „Erstellen von XPath-Ausdrücken zum Schwärzen von Feldern “.

Zeichenfolge
Aktion Ja Gibt ab, ob Sie das Feld entfernen oder neu bearbeiten möchten.
Die gültigen Werte sind im Folgenden aufgelistet:
  • remove: Entfernt das angegebene Feld vollständig.
  • redact: Bearbeitet das Feld neu (Verschlüsselung mit Sternen (*)), um die Daten zu blockieren.

Der Standardwert ist redact.

Hinweis: Wird ein numerischer Wert neu bearbeitet, wird der neu bearbeitete Wert als ****** dargestellt und der Typ in stringgeändert.
Zeichenfolge
Von Ja Gibt an, von wo aus das angegebene Feld entfernt oder neu bearbeitet werden soll.
Die gültigen Werte sind im Folgenden aufgelistet:
  • all: Entfernt das angegebene Feld aus dem Anforderungshauptteil, dem Antworthauptteil und den Aktivitätenprotokollen bzw. bearbeitet es dort neu.
  • request: Entfernt das angegebene Feld aus dem Anforderungshauptteil bzw. bearbeitet es dort neu.
  • response: Entfernt das angegebene Feld aus dem Antworthauptteil bzw. bearbeitet es dort neu.
  • logs: Entfernt das angegebene Feld aus den Aktivitätenprotokollen bzw. bearbeitet es dort neu.

Der Standardwert ist all.

Klicken Sie optional auf Add item (Element hinzufügen), um zusätzliche Werte anzugeben.

Zeichenfolge
Tipp: Sie können optional auf Element hinzufügen klicken, um XPath-Ausdrücke für zusätzliche Felder anzugeben, die Sie aus dem Anforderungshauptteil, dem Antworthauptteil und den Protokollen entfernen oder neu bearbeiten möchten.