Ein Cookie in einer Log-Zeile ist dein Login: Hermes schließt die letzten zwei Redaction-Lücken


Es gibt eine Angewohnheit, die sich hinterher sehr schlecht auditieren lässt: den Agenten fragen, warum ein Endpoint 401 zurückgibt. Du pastest ein ganzes curl in den Chat — inklusive einer rohen Cookie-Kopfzeile oder einer x-api-key. Es funktioniert, das Problem ist gelöst, und du vergisst es.

Tage später debuggst du etwas anderes, liest gateway.log, einen Request-Dump oder deinen eigenen session-Export, und dieser cookie liegt dort im Klartext. Ein Anhang an einem Ticket, ein geteiltes Laufwerk, ein Archiv, das an eine Kollegin geht — einmal reicht. Ein cookie braucht dein Passwort nicht. Er ist der Login.

Hermes hatte von Anfang an Redaction, mit security.redact_secrets standardmäßig an. Aber zwei Formen fehlten, und beide teilen eine Eigenschaft: Keine von beiden sieht wie ein Schlüssel aus.

Zuerst cookies. Die alten Regeln achteten auf Authorization-Header mit einem Scheme-Wort, auf Vendor-Prefix-Schlüssel (sk- und Verwandte) und auf Zuweisungen wie password=. Cookie: und Set-Cookie: standen nicht auf der Liste — sie ähneln keinem Schlüssel, und ihre Werte tragen kein Präfix. Eine komplette Zeile Cookie: a=1; sid=SECRET landete also direkt in Logs, Request-Dumps und der Ausgabe von Terminal-Tools.

Dann Proxy-URLs. Dein proxy kann wie http://user:pass@host:port aussehen. Eine proxy-Adresse beim Start auszugeben ist normal, und das alte Verhalten maskierte das Passwort, ließ aber den Username-Slot intakt — syntaktisch ist das nur ein Username.

In der Praxis setzt niemand dort einen Username hin. Viele Tools (Infisical Agent Vault zum Beispiel) legen einen Bearer-token in die userinfo-Position des Usernames und lassen den Passwort-Slot als Platzhalter. Echte Logs enthielten am Ende Zeilen wie:

Proxy detected: http://AGENTTOKEN0a1b2c3d4e5f:***@127.0.0.1:37343

Passwort maskiert. Token unangetastet.

Wie cookies jetzt behandelt werden

Die neue Regel: Wenn es wie ein cookie-Header aussieht, wird der ganze Wert zu ***, und der Header-Name bleibt.

Die abgedeckten Formen sind zahlreicher, als sie klingen, weil alle in echten Logs auftauchen:

  • rohe Header-Zeilen: Cookie: a=1; sid=SECRET
  • curl--H-Argumente, einfach, doppelt und ohne Anführungszeichen
  • HTTP-Dump-Zeilen, wie man sie nach curl -i sieht
  • JSON-Request-Dumps — escape-aware behandelt, damit die Maskierung das JSON nicht kaputt macht
  • ein Header, der mitten in einer Zeile einer Log-Message auftaucht
  • Zuweisungsformen: cookie=, *_COOKIE=, SESSION_COOKIE=

Ein Detail, das man würdigen sollte: Ein name=value-Paar muss vorhanden sein, bevor der Text als cookie behandelt wird. Der Satz „der cookie: er war abgelaufen“ bleibt also unangetastet, ebenso der URL-Parameter ?cookie= und cookie ==-Vergleiche im Code.

Derselbe Fix fügte eine Reihe einwertiger, scheme-loser Secret-Header hinzu: x-api-key, x-goog-api-key, api-key, apikey, x-api-token, x-auth-token, x-access-token. Diese leckten aus einem stumpfen Grund — kein Bearer, kein sk--Präfix, nichts im Wert selbst, woran man sie erkennen könnte.

Er reparierte außerdem ein echtes Leck: Eine Zwischenversion der Regex stoppte am ersten Leerzeichen, sodass Cookie: a=1; sid=SECRET nur a=1; maskierte und sid=SECRET im Klartext ließ. Jetzt wird der ganze name=value; name=value-Lauf maskiert.

Werte, die bereits Redaction-Marker sind (zum Beispiel x-api-key: *** see docs), bleiben unverändert, was die Funktion idempotent macht — zweimal laufen lassen verhunzt nie ein Log.

Proxy-URLs: Scheme, Host, Port, sonst nichts

Proxies nehmen einen anderen Weg. Statt Teile eines Werts zu maskieren, wird die Adresse schlicht nicht vollständig ausgegeben: Log-Zeilen tragen http://127.0.0.1:41305 und nichts weiter. Die vollständige URL erreicht den HTTP-Client weiterhin unverändert.

Die Änderung landet an jeder Call-Site, die einen proxy ausgab: Telegrams Request-Builder, Discords connect, die Matrix-Initialisierung, der eigenständige Telegram-Sender und beide SOCKS-Warnungen zu fehlendem aiohttp_socks. Sie teilen sich jetzt safe_url_for_log, den Helper, den Slack schon nutzte.

Es gibt auch einen subtileren Einstiegspunkt: Eine malformed proxy-URL kommt in Transport-Exceptions zurück. Denk an InvalidURL: bob:p%C3%A4ss@... oder Invalid port: '<pw>'. Diese Strings werden neu gequotet und gesplittet, Substring-Maskierung kann also nicht jede Form abdecken. Jetzt reduzieren Log und Chat-Antwort auf <ExceptionType> via <scheme://host:port or placeholder> ohne Traceback, wann immer eine proxy-URL etwas enthält, das die log-sichere Darstellung verwerfen würde. Ohne konfigurierten proxy — oder mit einer URL, die ganz gezeigt werden kann — bleibt der volle Fehlertext erhalten.

Was abgedeckt ist, und wo die Kanten liegen

Zuerst die gute Nachricht:

  • security.redact_secrets ist standardmäßig true und gilt für Tool-Output (Terminal-Echo inklusive) und Logs.
  • Das Lesen von .env-artigen Dateien maskiert credential-förmige Zuweisungen mit einem nicht wiederverwendbaren Marker «redacted-secret» über read_file, search_files und ein Terminal-cat/grep — selbst wenn der Wert nach nichts aussieht.
  • Gewöhnlicher Quellcode und Projekt-Config behalten nur Vendor-Prefix-Muster, Fixtures wie MAX_TOKENS: 100 werden also nie verhunzt.

Die Kanten zählen, denn falsches Vertrauen ist schlimmer als keines:

  • Redaction passiert, wenn Hermes ausgibt oder aufzeichnet, nicht rückwirkend. Bereits auf der Platte liegende Log-Dateien werden nicht umgeschrieben.
  • Erkannt werden Formen. Ein eigener Credential in einem Header außerhalb der Liste, ohne Vendor-Prefix und nicht in name=value-Form, kann weiter durchrutschen.
  • Dateien, die Drittprogramme schreiben, Output, den du woanders hin teest, Snippets, die du in ein anderes Tool pastest — alles außerhalb der Reichweite von Hermes.
  • security.redact_secrets: false schaltet es weiterhin ab. Außer du entwickelst den Redactor selbst, gibt es keinen Grund dafür.

Zwei Checks, die du heute laufen lassen kannst

  1. Schau dir die proxy-Zeilen in gateway.log an. Nach diesen Fixes solltest du scheme://host:port ohne user:pass@ sehen.
  2. Durchsuche deine letzten session-Exporte oder Request-Dumps nach Cookie:. Steht dort noch ein langer Wert, ist die Maschine älter als beide Fixes.
grep -n "Proxy detected" ~/.hermes/logs/gateway.log
grep -rn "Cookie:" ~/.hermes/logs/ | head

Wenn du einen echten Credential findest, behandle ihn als geleakt: Diese session widerrufen, diesen Schlüssel rotieren. Ein Upgrade räumt keine Werte auf, die schon geschrieben sind.

Wann du das nutzen kannst

Beide PRs sind auf main: #151119 (cookies und Secret-Header) gemergt am 8. November, #150958 (Proxy-URLs) am 9. November. v0.23.0 ging am 6. November raus, diese Änderungen sind also nicht in v0.23.0; sie kommen mit dem nächsten stabilen Release.

Update (10.11.2026): Diese Änderungen sind mit v0.23.1 (9. November) erschienen – ein hermes update genügt. Die Aussage „nicht in v0.23.0“ oben stimmt weiterhin; v0.23.1 schließt die Lücke.

Um die Exposition heute ohne Codeänderung zu reduzieren: Hör auf, komplette curls mit Cookie: zu pasten (nutze stattdessen eine Env-Var oder ein cookie jar), und hör auf, tokens in die userinfo einer proxy-URL zu legen — das ist der Slot, der am wahrscheinlichsten in einem Log landet.

Zwei begleitende Texte zum selben Thema: die unsichtbaren Zeichen in Hermes’ Approval-Prompts handelt von einer vergifteten Anzeige, hier geht es um ein zu ehrliches Protokoll; und die Redaction-Lanes für API-Keys und Cron-Output deckt Schlüssel-Formen und ausgehende Oberflächen ab.

Die Kurzfassung

Ein cookie loggt dich ohne Passwort ein, und er wurde früher wortwörtlich in Logs und Request-Dumps geschrieben; der Username-Slot einer proxy-URL ist der Ort, an den Tools tokens legen, und maskiert wurde nur das Passwort. Jetzt werden cookies ganz maskiert (zusammen mit sieben Secret-Header-Namen), und proxy-URLs geben nur Scheme, Host und Port aus — malformed proxy-Exceptions eingeschlossen. Beide Änderungen sind main-only, aber es lohnt sich, jetzt durch die alten Logs zu gehen, denn diese Dateien räumen sich nicht selbst auf.