---
url: https://docs.ogmabox.com/de/app/match-replace.md
description: >-
  Ändere aufgezeichneten HTTP- und WebSocket-Verkehr automatisch mit Ogmas
  Regeln unter Suchen & Ersetzen.
---

# Suchen & Ersetzen {#match-replace}

Suchen & Ersetzen (Match & Replace) ändert Datenverkehr automatisch beim Durchlaufen des Proxys, ohne ihn anzuhalten oder für jede Anfrage einen manuellen Eingriff zu erfordern.

## Wie Regeln funktionieren {#how-rules-work}

Jede Regel definiert, wonach gesucht wird und was damit geschehen soll. Entspricht eine Anfrage oder Antwort den Bedingungen, wendet die Regel ihre Transformation sofort an.

Regeln werden in der Listenreihenfolge angewendet. Zielen zwei Regeln auf denselben Header, wird zuerst die erste passende Regel angewendet; nachfolgende Regeln sehen das Ergebnis dieser Änderung.

## Regelfelder {#rule-fields}

| Feld | Beschreibung |
| --- | --- |
| Name | Bezeichnung der Regel. Verwende einen aussagekräftigen Namen für ihren Zweck. |
| Richtung | Ob die Regel für Anfragen, Antworten oder beides gilt |
| Operation | Auszuführende Transformation (siehe Operationstabelle unten) |
| Suchmodus | Wörtlich, Regex oder Vollständig, je nach Operation |
| Suchwert | Die zu suchende Zeichenfolge oder das Muster |
| Ersatzwert | Der einzusetzende Wert |
| Aktiviert | Schalter zum Aktivieren oder Deaktivieren ohne Löschen der Regel |
| Filter | Optionale Bedingungen für Methode, Host, Pfad und HTTPQL, die den Geltungsbereich begrenzen |

### Operationen {#operations}

| Operation | Wirkung |
| --- | --- |
| Header hinzufügen | Fügt einen neuen Header mit festem Namen und Wert hinzu |
| Header entfernen | Löscht einen Header anhand seines Namens |
| Header ersetzen | Ersetzt den Wert eines bestehenden Headers |
| Body ersetzen | Ersetzt einen Teil des Bodys anhand des Suchwerts |
| Pfad / Query / Query-Parameter | Ändert den Anfragepfad oder Query-Werte |
| Anfrage- / Antwortzeile | Ändert die ausgewählte Komponente der HTTP-Startzeile |
| Statuscode | Ändert einen Antwortstatus |
| Rohe Nachricht | Transformiert HTTP-Startzeile, Header und Body gemeinsam |
| WebSocket-Payload | Ersetzt passenden Inhalt von Client-/Servernachrichten |
| Workflow | Führt einen aktivierten Workflow vom Typ Konvertierung für den ausgewählten Inhalt aus |

## Abgleichmodi {#match-modes}

**Wörtlich** gleicht die exakte Zeichenfolge ab. Nutze dies für feste Tokens, Headernamen oder bestimmte Werte.

**Regex** gleicht mit einem regulären Ausdruck ab. Nutze dies bei veränderlichen Zielen – etwa einem Token, der sich mit jeder Sitzung ändert, oder um eine Gruppe zu erfassen und im Ersatzwert wiederzuverwenden.

Verwende in Regex-Ersetzungen die Erfassungsgruppen `$1`, `$2` usw., um im Ersatzwert auf gefundene Teile zu verweisen.

**Vollständig** übergibt den gesamten ausgewählten Inhalt an die Transformation, statt nach einer Teilzeichenfolge zu suchen. Manche Operationen, etwa das Hinzufügen/Entfernen eines benannten Headers, verwenden stattdessen einen wörtlichen Namen und bieten nicht alle Modi an.

## Einen vollständigen Antwort-Body transformieren {#transforming-a-complete-response-body}

1. Erstelle und aktiviere einen Workflow vom Typ **Konvertierung** und validiere ihn mit Testeingaben.
2. Erstelle unter **Suchen & Ersetzen** eine Regel mit Richtung **Antwort** und Operation **Workflow (Body)**.
3. Wähle den Abgleichmodus **Vollständig** und den Workflow.
4. Grenze die Regel mit einem HTTPQL-Filter ein, beispielsweise:

```text
req.host.eq:"cdn.example.com" AND (req.path.cont:".js" OR resp.headers["Content-Type"].value.cont:"javascript")
```

Der Workflow erhält den gesamten Body; seine Ausgabe ersetzt diesen. **Workflow (Header)** transformiert einen benannten Header, während **Workflow (rohe Header)** den Headerblock transformiert. Dies sind andere Eingaben als der Antwort-Body.

HTTPQL-Filter werden im verfügbaren Anfrage-/Antwortkontext geprüft. Eine Regel für Anfragen kann sich nicht auf eine noch nicht eingetroffene Antwort stützen. Deaktiviere die Workflow-Protokollierung bei sehr vielen Ausführungen; aktiviere sie vorübergehend zur Diagnose einer Transformation.

## Regeln umordnen {#reordering-rules}

Ziehe eine Regelzeile an eine andere Listenposition. Die Reihenfolge ist wichtig, wenn Regeln überlappende Teile derselben Anfrage oder Antwort verändern.

## KI-Unterstützung {#ai-assist}

Beschreibe im Regeleditor in natürlicher Sprache, was du ändern möchtest, und klicke auf **Mit KI ausfüllen**. Ogma erzeugt die Regelfelder anhand deiner Beschreibung. Prüfe und korrigiere die erzeugten Werte vor dem Aktivieren.

Beispiele für geeignete Prompts:

* „Entferne den X-Frame-Options-Header aus allen Antworten“
* „Ersetze den Wert des Authorization-Headers durch meinen Test-Token“
* „Füge allen Anfragen einen Header namens X-Debug mit dem Wert true hinzu“

## Eine Regel testen {#testing-a-rule}

Teste eine Regel vor dem Aktivieren für Live-Datenverkehr mit einer Beispielanfrage:

1. Öffne den Regeleditor.
2. Füge eine rohe HTTP-Anfrage in den Bereich **Testbereich** ein.
3. Klicke auf **Regeln anwenden**. Der Bereich zeigt das Ergebnis und die angewendeten Regeln.
4. Prüfe, ob die Ausgabe deinen Erwartungen entspricht.
5. Aktiviere die Regel.

Der Testbereich hat außerdem ein Ziel **Antwort** mit Eingaben für Status, Header und Body. Prüfe die Liste angewendeter Regeln: Getestet werden die zutreffenden Regeln, nicht nur ein isoliertes Editorfeld.

## Suchen & Ersetzen und Abfangen im Vergleich {#match-replace-vs-intercept}

**Suchen & Ersetzen** arbeitet automatisch. Sobald eine Regel aktiviert ist, transformiert sie jede passende Anfrage oder Antwort ohne dein Zutun.

**Abfangen** hält Datenverkehr an und wartet auf eine manuelle Entscheidung. Nutze Abfangen, wenn die richtige Änderung vom Kontext abhängt, den du pro Anfrage beurteilen musst. Nutze Suchen & Ersetzen, wenn dieselbe Transformation jedes Mal ohne Prüfung gelten soll.

## Häufige Verwendungen {#common-uses}

* Ein Sitzungscookie in allen Anfragen austauschen, um ein anderes Konto zu testen.
* Einen Header hinzufügen, der einen Debug- oder Administratormodus aktiviert.
* Sicherheitsheader aus Antworten entfernen, um clientseitiges Verhalten zu beurteilen.
* Einen fest codierten Host in Weiterleitungsantworten ersetzen.
* Ein Anfragepfadpräfix umschreiben.

## Verwandte Seiten {#related-pages}

* [Abfangen](./intercept.md)
* [HTTP-Verlauf](./http-history.md)
* [Workflows](./workflows.md)