---
url: https://docs.ogmabox.com/de/app/environment.md
description: >-
  Verwalte Ogmas Umgebungsvariablen für Replay, Automate, Workflows und den
  Testkontext.
---

# Umgebung {#environment}

Umgebungsvariablen speichern wiederverwendbare Werte, auf die du in Anfragen in Replay, Automate und Workflows verweisen kannst.

## Variablen erstellen und bearbeiten {#creating-and-editing-variables}

1. Öffne **Umgebung** in der linken Navigation.
2. Klicke auf **Neu**.
3. Gib einen Namen ein, der mit einem Buchstaben oder Unterstrich beginnt, gefolgt von Buchstaben, Zahlen, Unterstrichen oder Bindestrichen (maximal 64 Zeichen).
4. Gib den Wert ein.
5. 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.
6. Klicke auf **Speichern**.

Klicke zum Bearbeiten einer bestehenden Variablen auf ihre Zeile und aktualisiere Namen oder Wert.

## Variablen in Anfragen verwenden {#using-variables-in-requests}

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 {#variable-scope}

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 {#transforms-and-dynamic-values}

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 {#ai-assistant-access}

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 {#common-uses}

| 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` |

## Verwandte Seiten {#related-pages}

* [Replay](./replay.md)
* [Automate](./automate.md)
* [Workflows](./workflows.md)