Umgebung
Umgebungsvariablen speichern wiederverwendbare Werte, auf die du in Anfragen in Replay, Automate und Workflows verweisen kannst.
Variablen erstellen und bearbeiten
- Öffne Umgebung in der linken Navigation.
- Klicke auf Neu.
- Gib einen Namen ein, der mit einem Buchstaben oder Unterstrich beginnt, gefolgt von Buchstaben, Zahlen, Unterstrichen oder Bindestrichen (maximal 64 Zeichen).
- Gib den Wert ein.
- Aktiviere Geheim, wenn der Wert vertraulich ist (API-Schlüssel, Tokens, Passwörter). Geheime Werte werden in der Oberfläche maskiert und aus dem KI-Kontext ausgeschlossen.
- Klicke auf Speichern.
Klicke zum Bearbeiten einer bestehenden Variablen auf ihre Zeile und aktualisiere Namen oder Wert.
Variablen in Anfragen verwenden
Verweise mit dem Präfix env. auf eine Umgebungsvariable:
{{env.VARIABLE_NAME}}Beispiele:
- Host-Feld:
{{env.TARGET_HOST}}(speichere einen Hostnamen, keine vollständige URL). - Autorisierungsheader:
Bearer {{env.AUTH_TOKEN}}. - Anfrage-Body:
{"tenant": "{{env.TENANT_ID}}"}; aktiviere Body-Templating in Replay, wenn du Ersetzungen innerhalb des Bodys möchtest.
Ogma löst gültige Umgebungsplatzhalter beim Senden auf. Eine fehlende Variable führt zu einem Fehler, statt unbemerkt einen nicht aufgelösten Wert zu senden. Sendevorgänge in den Modi Rohdaten (Raw) und Hex in Replay erhalten die exakten Bytes und ersetzen keine Platzhalter.
Gültigkeitsbereich der Variablen
Wähle Global für Werte, die Projekte dieses Ogma-Arbeitsbereichs gemeinsam nutzen, oder Projekt für Werte des aktiven Projekts. Projektwerte überschreiben globale Werte mit demselben Namen. Replay unterstützt auch Überschreibungen durch Sammlung und Sitzung; die Priorität lautet Sitzung, Sammlung, Projekt, dann global.
Transformationen und dynamische Werte
Hänge Transformationen mit einem Pipe-Zeichen an, beispielsweise {{env.AUTH_TOKEN|base64_encode}} oder {{env.SEARCH|url_encode}}. Die Kette wird von links nach rechts angewendet. Prüfe die Ausgabe mit einer Testanfrage: Unbekannte Transformationsnamen werden übersprungen und nicht als Fehler gemeldet.
Integrierte Werte benötigen keine gespeicherte Variable:
| Platzhalter | Wert |
|---|---|
{{$timestamp}} | Aktuelle Unix-Zeit in Millisekunden. |
{{$timestamp_s}} | Aktuelle Unix-Zeit in Sekunden. |
{{$uuid}} | Eine neue UUID. |
{{$random(16)}} | 16 zufällige Bytes in hexadezimaler Darstellung. |
{{$date(%Y-%m-%d)}} | Aktuelles UTC-Datum nach einem Datumsformatmuster. |
Gespeicherte Werte werden nicht rekursiv aufgelöst. Enthält ein Wert einen weiteren Platzhalter, bleibt dieser verschachtelte Text wörtlich erhalten.
Zugriff des KI-Assistenten
Der KI-Assistent kann Namen und Werte nicht geheimer Variablen lesen, um Kontext zu erhalten, wenn du eine Anfrage analysieren oder einen Testplan entwerfen lässt. Geheime Variablen sind niemals im KI-Kontext enthalten.
Häufige Verwendungen
| Variable | Beispielwert |
|---|---|
BASE_URL | https://api.example.com |
AUTH_TOKEN | eyJhbGci... (als geheim markieren) |
TARGET_HOST | app.example.com |
API_KEY | sk-... (als geheim markieren) |
USER_ID | 12345 |