RequestTailor Vorschau (22.11.2026): Requests als Dateien in Git, ohne Konto, offline – auf dem Mac, im Browser und in der Pipeline. Was drin ist → +43 664 1964199Kontakt →

Umgebungen und Variablen

Werte, die sich zwischen Systemen unterscheiden, stehen in Umgebungen. Werte, die geheim bleiben müssen, kommen nie in den Collection-Ordner: Die Datei nennt nur den Namen, der Wert liegt im Schlüsselbund des Betriebssystems oder kommt aus deinem Secret-Manager.

Edition
Free
Ebenen
Global, Collection, Umgebung, Ordner, Request, Laufzeit
Dateien
environments/<Name>.yml
Secrets
Schlüsselbund (Mac), verschlüsselt im Browser (Web)
Tresore
1Password, HashiCorp Vault, AWS, Azure, Google

Woher eine Variable kommt

Variablen schreibst du als {{name}}. Sie werden in Ebenen aufgelöst; eine spätere Ebene gewinnt:

  1. Global
  2. Collection (opencollection.yml)
  3. Umgebung (environments/<Name>.yml)
  4. Ordner (folder.yml)
  5. Request
  6. Laufzeit (etwa --var auf der Kommandozeile oder Werte, die Skripte setzen)

Die Rangfolge ist dieselbe wie bei Bruno. Fährst du mit der Maus über eine Variable in der URL, zeigt RequestTailor ihren Wert und die Ebene, aus der er kommt.

Tooltip über der Variable baseUrl in der URL mit dem Text baseUrl, environment Local und dem Wert http://127.0.0.1:47811
Woher ein Wert kommt: Name, Ebene und Wert direkt an der URL.

Auch der JSON-Bericht von rt send nennt zu jeder Variable ihre Herkunft und listet Platzhalter ohne Wert unter unresolved.

Umgebungen anlegen und wechseln

Oben rechts wählst du die aktive Umgebung; ein Punkt davor zeigt ihren Zustand. Environments daneben öffnet die Verwaltung.

Dialog Environments mit den Umgebungen Local (active) und PRD, Variablen baseUrl und token, token als Secret mit stored securely und Reveal, darunter External secrets und Client certificates
Der Dialog Environments: Variablen, Secret-Haken, externe Secrets und Client-Zertifikate.
  1. Links die Umgebungen; New environment legt eine an.
  2. Rename, Duplicate und Delete für die gewählte Umgebung.
  3. Je Variable: Enabled, Name, Value und der Haken Secret. Ein Secret zeigt stored securely; Reveal zeigt den Wert kurz an.
  4. External secrets wählt einen Secret-Manager.
  5. Client certificates für Server, die gegenseitiges TLS verlangen.
  1. Oben rechts Environments öffnen und New environment wählen.
  2. Mit Add variable die Variablen anlegen, etwa baseUrl.
  3. Für ein Passwort oder Token eine Variable anlegen und den Haken Secret setzen; den Wert einmal eintragen.
  4. Save klicken. In die Datei schreibt RequestTailor nur den Namen; der Wert geht in den Schlüsselbund.

Secret-Variablen

Eine Secret-Variable steht in der Umgebungsdatei ohne Wert:

name: Staging
variables:
  - name: baseUrl
    value: https://api.staging.example.com
  - secret: true
    name: apiToken

Den Wert speichert die Mac-App im Schlüsselbund des Betriebssystems, die Web-App verschlüsselt im Speicher des Browsers. Er kommt erst beim Senden dazu, und Berichte zeigen ihn als ***. OAuth-2.0-Tokens liegen genauso. Wer die Collection klont, bekommt die Namen, aber keine Werte, und trägt seine eigenen ein.

Secrets aus einem Secret-Manager

Eine Umgebung kann Secrets aus einem Secret-Manager lesen, über dessen eigene Kommandozeile und mit deiner bestehenden Anmeldung. In der Datei steht nur der Verweis:

name: Staging
externalSecrets:
  type: one-password
  variables:
    - name: apiToken
      secretReference: op://Staging/api/token
typeKommandozeile
one-passwordop
hashicorp-vault-server, hashicorp-vault-cloudvault
aws-secrets-manageraws
azure-key-vaultaz
gcp-secrets-managergcloud

Die Werte bleiben nur im Speicher und sind in jedem Bericht maskiert. Die Kommandozeile läuft ohne Shell und mit 60 Sekunden Zeitlimit; fehlt sie oder die Anmeldung, sagt RequestTailor, was zu installieren oder welcher Anmeldebefehl auszuführen ist. Die Web-App kann diese Programme nicht starten; dort liest sie der Begleitdienst rt agent --allow-secrets (Begleitdienst rt agent). Die Felder je Anbieter stehen in Kommandozeile rt.

Client-Zertifikate

Client-Zertifikate (PEM oder PKCS#12) richtest du je Collection oder je Umgebung ein; Pfade sind relativ zum Collection-Ordner. Die Passphrase gehört in eine Secret-Variable, etwa {{certPassphrase}}, damit sie nicht in der Datei steht. Mac-App und rt verwenden die Zertifikate; Browser legen Webseiten keine Client-Zertifikate vor, deshalb meldet die Web-App einen klaren TLS-Fehler.

Siehe auch

Fundstellen auf dieser Seite

Die hochgestellten Ziffern im Text verweisen hierher. Antippen zeigt die Fundstelle direkt an der Textstelle, alle Fundstellen der Website stehen gesammelt auf einer Seite.

  1. 1

    Variablen in sechs Ebenen mit Herkunft ↑Produkt · Repo des Kerns von RequestTailor, crates/rt-core (vars::Scope), website/docs/environments · geprüft am 22.11.2026

  2. 2

    Secrets im Schlüsselbund und aus externen Tresoren ↑Produkt · Repo des Kerns von RequestTailor, CLAUDE.md (Produktprinzip 3), crates/rt-cli/README.md (externe Secrets), website/docs/environments · geprüft am 22.11.2026

Häufige Fragen

Kurz beantwortet.

Stehen Passwörter in den YAML-Dateien?
Nein. Eine Secret-Variable steht ohne Wert in der Datei. Der Wert liegt im Schlüsselbund des Betriebssystems (Mac-App) oder verschlüsselt im Browser (Web-App) oder kommt aus einem Secret-Manager.
Welche Secret-Manager unterstützt RequestTailor?
1Password, HashiCorp Vault (Server und Cloud), AWS Secrets Manager, Azure Key Vault und Google Secret Manager, jeweils über die Kommandozeile des Anbieters mit deiner Anmeldung.
In welcher Reihenfolge gelten Variablen?
Global, Collection, Umgebung, Ordner, Request, Laufzeit; eine spätere Ebene gewinnt. Das entspricht der Rangfolge von Bruno.

Deine Frage ist nicht dabei? Sprich mich an: +43 664 1964199 office@clouddna.at Schreib mir

Kontakt

Requests im Repo statt im Konto? Sprich mit uns.

Free ist kostenlos und bleibt es. Für eine Vorabversion, für Enterprise, für das OData-Plugin an eurem SAP-System oder für einen Wunsch an Pro und Team: Schreib mir. Ich antworte innerhalb eines Werktags, persönlich.

Martin KochGeschäftsführer, CloudDNAIch lese jede Anfrage selbst und antworte persönlich.