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 →

Begleitdienst rt agent

Die Web-App führt den Kern von RequestTailor im Browser aus – also gelten die Regeln des Browsers: kein Request an Server ohne CORS-Header, keine verbotenen Header, keine Client-Zertifikate, kein gRPC. Der Begleitdienst rt agent läuft auf deinem Rechner und sendet solche Requests für die Web-App, mit demselben nativen Transport wie rt send. Er hört nur auf 127.0.0.1, prüft jede Anfrage und koppelt sich per Einmalcode.

Start
rt agent im Terminal
Adresse
127.0.0.1:47812 (Standard)
Kopplung
Einmalcode, 10 Minuten gültig
Tokens
nur im Speicher; Neustart widerruft alle

Wofür es den Begleitdienst gibt

Die Mac-App und rt senden nativ und kennen diese Grenzen nicht. Nur die Web-App braucht den Begleitdienst, und nur für:

  • Requests, die der Browser blockiert – meist ein Server ohne CORS-Header oder ein Header, den der Browser nicht erlaubt. Die Web-App fragt dann „The browser blocked this request. Send it through the RequestTailor companion?“ und bietet Send through companion an.
  • Sitzungen: gRPC, WebSocket und Server-Sent Events laufen in der Web-App immer über den Begleitdienst (siehe gRPC, WebSocket, SSE und GraphQL).
  • Git-Netzwerk: Pull und Push der Web-App gehen über den Begleitdienst.
  • Externe Secrets aus 1Password, HashiCorp Vault, AWS Secrets Manager, Azure Key Vault und Google Secret Manager, wenn du es erlaubst (unten).

Client-Zertifikate gibt es nur nativ, also in der Mac-App und in rt; Browser und Begleitdienst lehnen sie mit einem klaren TLS-Fehler ab.

Starten und koppeln

  1. rt installieren (siehe Download) und im Terminal rt agent starten.
  2. Der Begleitdienst zeigt einen Kopplungscode und für jede erlaubte Herkunft einen Kopplungslink, etwa Pairing code: 7KQ2-M9XD (single use, valid for 10 minutes).
  3. Den Link im Browser öffnen oder den Code eintippen, wo die Web-App danach fragt (Pairing code).
  4. Die Web-App tauscht den Code gegen ein Token und nutzt den Begleitdienst ab jetzt, wenn du ihn wählst. Beenden mit Ctrl+C; ein Neustart widerruft jede Kopplung.
OptionBedeutung
--port PORTAuf 127.0.0.1:PORT hören (Standard 47812, dort sucht die Web-App)
--allow-origin ORIGINEine Herkunft der Web-App (scheme://host[:port]), die koppeln und senden darf; mehrfach möglich. Ersetzt die Standardliste (der lokale Entwicklungsserver der Web-App auf Port 5173)
--allow-secretsAuch externe Secrets für die Web-App lesen. Standard: aus

Externe Secrets in der Web-App

Der Browser kann op, vault und ähnliche Programme nicht starten. Mit rt agent --allow-secrets schickt eine gekoppelte Web-App die Verweise der externen Secrets einer Umgebung an den Begleitdienst, und der liest sie mit den Kommandozeilen der Anbieter – mit deinen bestehenden Anmeldungen, ohne Shell, mit 60 Sekunden Zeitgrenze. Die Web-App hält die Werte nur für die Sitzung im Speicher, nur zum Senden; in Reports sind sie maskiert, gespeichert werden sie nie, auch nicht im Begleitdienst.

Sicherheitsmodell

Der Begleitdienst ist ein lokaler Server, der Requests mit dem Netzzugang deines Rechners sendet, auch an interne Hosts. Deshalb gelten diese Regeln, jede mit Tests im Repo des Kerns:

  1. Nur Loopback. Er bindet 127.0.0.1, nie 0.0.0.0; andere Rechner erreichen ihn nicht.
  2. Host-Prüfung gegen DNS-Rebinding: Jede Anfrage braucht Host: 127.0.0.1:<port> oder localhost:<port>, sonst 403.
  3. Erlaubte Herkünfte (CORS): Eine Anfrage mit fremdem Origin bekommt 403 ohne CORS-Header, nie *.
  4. Kopplung: Der Code hat 40 Zufallsbits, gilt einmal und 10 Minuten; nach 5 Fehlversuchen wird er ersetzt. Das Token hat 256 Bit und ist an die Herkunft gebunden.
  5. Tokens nur im Speicher, im Vergleich mit konstanter Laufzeit; nichts wird auf die Festplatte geschrieben.
  6. Secrets nur auf Wunsch, mit --allow-secrets, ohne Zwischenspeicher, mit Cache-Control: no-store.
  7. Nichts sonst: fünf Endpunkte, kein Dateizugriff, keine Konfiguration über HTTP; Requests an sich selbst lehnt er ab.
  8. Protokoll: eine Zeile je Request mit Methode und Host, nie Pfade, Header oder Bodies; bei Secrets nur Anbieter, Anzahl und Herkunft.

Wovor er nicht schützt: Andere Programme, die unter deinem Benutzer laufen, erreichen 127.0.0.1 auch – koppeln können sie aber nur mit dem Code aus deinem Terminal. Eine kompromittierte Seite auf einer erlaubten Herkunft kann deren Token nutzen wie die Web-App selbst; erlaube nur Herkünfte, denen du vertraust.

Typische Probleme

Meldung oder LageWas hilft
„The companion did not accept this code. Use the newest code `rt agent` printed.“Jeder benutzte, abgelaufene oder ersetzte Code wird durch einen neuen im Terminal ersetzt. Den neuesten eintippen.
Die Web-App findet den Begleitdienst nichtLäuft rt agent? Bei eigenem Port muss die Web-App denselben kennen; Standard ist 47812.
Kopplung von einer gehosteten Web-App scheitertDeren Herkunft mit --allow-origin https://… erlauben; die Standardliste enthält nur den lokalen Entwicklungsserver.
Externe Secrets werden nicht gelesenrt agent mit --allow-secrets neu starten und neu koppeln; die Kommandozeile des Anbieters muss installiert und angemeldet sein.

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

    Begleitdienst rt agent für die Web-App ↑Produkt · Repo des Kerns von RequestTailor, crates/rt-cli/src/agent, crates/rt-cli/README.md (Sicherheitsmodell) · 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.

Brauche ich den Begleitdienst in der Mac-App?
Nein. Die Mac-App und rt senden nativ. Den Begleitdienst braucht nur die Web-App, für Requests, die der Browser blockiert, für Sitzungen wie gRPC und WebSocket, für Git-Netzwerk und für externe Secrets.
Kann jemand im Netz meinen Begleitdienst benutzen?
Nein. rt agent hört nur auf 127.0.0.1, prüft Host und Herkunft jeder Anfrage und sendet nur für eine Web-App, die sich mit dem Einmalcode aus deinem Terminal gekoppelt hat.
Speichert der Begleitdienst meine Requests oder Secrets?
Nein. Er protokolliert je Request nur Methode und Host, nie Pfade, Header oder Bodies. Tokens liegen nur im Speicher, Secret-Werte werden nicht zwischengespeichert.

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.