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.1 Er hört nur auf 127.0.0.1, prüft jede Anfrage und koppelt sich per Einmalcode.
- Start
rt agentim 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
rtinstallieren (siehe Download) und im Terminalrt agentstarten.- Der Begleitdienst zeigt einen Kopplungscode und für jede erlaubte Herkunft einen Kopplungslink, etwa
Pairing code: 7KQ2-M9XD (single use, valid for 10 minutes). - Den Link im Browser öffnen oder den Code eintippen, wo die Web-App danach fragt (Pairing code).
- 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.
| Option | Bedeutung |
|---|---|
--port PORT | Auf 127.0.0.1:PORT hören (Standard 47812, dort sucht die Web-App) |
--allow-origin ORIGIN | Eine 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-secrets | Auch 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:
- Nur Loopback. Er bindet
127.0.0.1, nie0.0.0.0; andere Rechner erreichen ihn nicht. - Host-Prüfung gegen DNS-Rebinding: Jede Anfrage braucht
Host: 127.0.0.1:<port>oderlocalhost:<port>, sonst403. - Erlaubte Herkünfte (CORS): Eine Anfrage mit fremdem
Originbekommt403ohne CORS-Header, nie*. - 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.
- Tokens nur im Speicher, im Vergleich mit konstanter Laufzeit; nichts wird auf die Festplatte geschrieben.
- Secrets nur auf Wunsch, mit
--allow-secrets, ohne Zwischenspeicher, mitCache-Control: no-store. - Nichts sonst: fünf Endpunkte, kein Dateizugriff, keine Konfiguration über HTTP; Requests an sich selbst lehnt er ab.
- 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 Lage | Was 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 nicht | Läuft rt agent? Bei eigenem Port muss die Web-App denselben kennen; Standard ist 47812. |
| Kopplung von einer gehosteten Web-App scheitert | Deren Herkunft mit --allow-origin https://… erlauben; die Standardliste enthält nur den lokalen Entwicklungsserver. |
| Externe Secrets werden nicht gelesen | rt agent mit --allow-secrets neu starten und neu koppeln; die Kommandozeile des Anbieters muss installiert und angemeldet sein. |
Siehe auch
- Doku gRPC, WebSocket, SSE und GraphQL
- Doku Kommandozeile rt
- Doku Secrets und Datenschutz
- Doku Umgebungen und Variablen
- Belege rt-cli/README.md1 · rt-cli/README.md2