Wie gebe ich einem KI-Agenten einen API-Schlüssel, ohne dass er den Schlüssel sieht?
Geben Sie dem Agenten eine Referenz statt des Schlüssels, und lassen Sie einen Proxy auf demselben Rechner den echten Schlüssel auf dem Weg nach außen in die Anfrage einsetzen. Hier ist, warum Umgebungsvariablen nicht mehr ausreichen, und wie Sie das einrichten.
Geben Sie dem Agenten eine Referenz statt des Schlüssels, und lassen Sie einen kleinen Proxy auf demselben Rechner den echten Schlüssel auf dem Weg nach außen in die Anfrage einsetzen. Der Agent schreibt clavitor://OpenAI/key, wo das Geheimnis hingehört. Die API erhält den echten Schlüssel. Der Agent hält ihn nie, also kann er ihn nicht ausgeben, nicht loggen und sich auch nicht dazu überreden lassen, ihn herauszugeben.
Das ist die ganze Idee. Der Rest dieser Seite erklärt, warum das wichtig ist, und wie Sie es einrichten.
Warum „einfach in eine Umgebungsvariable" nicht mehr reicht
Vor einem Jahr war export OPENAI_API_KEY=sk-... der normale Weg, einem Skript einen Schlüssel zu übergeben. Niemand hat mit der Wimper gezuckt.
Dann hat das Skript angefangen, selbst zu denken.
Ein KI-Agent liest Dateien, führt Werkzeuge aus, schreibt Logs und spricht mit Fremden im Internet. Jedes davon ist ein Ausweg für einen Schlüssel, den er hält:
- Die Umgebung. Alles, was der Agent ausführt, erbt sie. Sie taucht in
/procauf, in Crash-Dumps, in der CI-Ausgabe. - Der Speicher. Holt man den Schlüssel zur Laufzeit, liegt er trotzdem so lange im Prozess, wie der Agent läuft.
- Das Gespräch. Eine Prompt-Injection auf einer Webseite oder in einem Issue-Kommentar bittet den Agenten, „deine Konfiguration zum Debuggen mitzuschicken". Ein hilfsbereiter Agent tut das.
Für nichts davon braucht es einen Bug im Agenten. Es braucht nur, dass der Schlüssel irgendwo liegt, wo der Agent hinkommt.
Das Muster: der Agent fragt, der Proxy signiert
Denken Sie an eine Hotelkarte. Der Gast kann sein Zimmer öffnen. Der Gast sieht niemals den Hauptschlüssel, und die Tür protokolliert jede Benutzung.
Für einen API-Schlüssel sieht das so aus:
- Der echte Schlüssel liegt verschlüsselt in einem Tresor.
- Ein Proxy läuft neben dem Agenten, auf demselben Rechner.
- Der Agent sendet seine HTTPS-Anfrage mit einer Referenz an der Stelle, wo der Schlüssel hingehört.
- Der Proxy holt den Wert aus dem Tresor, setzt ihn in die Anfrage und leitet sie weiter.
- Auf der Seite des Agenten liegt immer nur die Referenz.
Die Logs des Agenten zeigen die Referenz. Sein Kontextfenster auch. Es gibt nichts, was lecken kann.
So richten Sie es mit Clavitor ein
So haben wir es gebaut. Ein Binary, eine Umgebungsvariable, keine Änderung am Code des Agenten.
Legen Sie im Tresor einen Client für den Agenten mit den benötigten Scopes an, registrieren Sie dann den Proxy und starten Sie ihn:
$ clavitor-proxy init $ clavitor-proxy ca $ clavitor-proxy serve
init registriert den Proxy als diesen Client. ca gibt die Zertifizierungsstelle des Proxys aus: Fügen Sie sie zum Truststore hinzu, den der HTTP-Client Ihres Agenten verwendet, denn der Proxy baut die HTTPS-Verbindung des Agenten selbst auf. Richten Sie den Agenten dann auf den Proxy:
$ export HTTPS_PROXY="http://clavitor:$(cat proxy-auth)@127.0.0.1:1983"
$ curl -H "Authorization: Bearer clavitor://OpenAI/key" \
https://api.openai.com/v1/chat/completionsproxy-auth ist das eigene Zugriffstoken des Proxys, die Datei neben dem Binary. Jede Verbindung muss es mitführen, damit ein anderer Benutzer auf demselben Rechner den Proxy nicht mitbenutzen kann. Der Proxy lauscht auf 127.0.0.1:1983 und nur auf diesem Rechner, sofern Sie ihn nicht absichtlich für ein vertrauenswürdiges privates Netzwerk einrichten.
Es funktioniert mit jedem Agenten, dessen HTTP-Client HTTPS_PROXY beachtet: Claude Code, Codex, Ihre eigenen Skripte. Ein Zugangsdatum geht nur an einen Host, den sein Eintrag als Webadresse führt, damit ein Agent mit Prompt-Injection dieselbe Referenz nicht auf den Server eines Fremden richten kann. Die Schritt-für-Schritt-Anleitung steht in der Proxy-Dokumentation.
Was ist mit den anderen Geheimnissen des Agenten?
Nicht jedes Geheimnis reist in einem HTTP-Header. Ein Deploy-Passwort, ein SSH-Schlüssel, ein Zwei-Faktor-Code für eine Anmeldung.
Dafür bittet der Agent den Tresor mit clavitor-cli um jeweils einen benannten Eintrag, und nur um Einträge, die ihm zugewiesen wurden:
$ clavitor-cli get "GitHub Deploy" --field password $ clavitor-cli get "Stripe API" --field key clavitor-cli: CV-2041: Access denied.
Der Agent kann den Tresor nicht auflisten. Eine Namenssuche zeigt höchstens fünf passende Titel, darüber nur eine Anzahl.
Authenticator-Codes funktionieren auf dieselbe Weise. clavitor-cli totp "GitHub" berechnet den aktuellen Code auf dem Rechner des Agenten, sodass er eine Zwei-Faktor-Anmeldung abschließen kann, ohne dass jemand ein Telefon abliest. Der Tresor hält das Geheimnis verschlüsselt.
Was das nicht löst
Ein Proxy hält den Schlüssel vom Agenten fern. Er macht den Agenten nicht vertrauenswürdig.
- Ein kompromittierter Agent kann die Zugriffe, die ihm gegeben wurden, weiterhin nutzen. Er kann den Schlüssel nur nicht mit nach Hause nehmen.
- Wer Administratorzugriff auf den Rechner hat, kann den Proxy ebenfalls nutzen oder seinen Speicher lesen.
- Eine API, die Ihren Schlüssel in ihrer Antwort zurückgibt, liefert ihn an den Agenten. Der Proxy setzt Schlüssel in Anfragen ein und filtert keine Antworten.
Deshalb ist der Zugriff drumherum so wichtig wie der Proxy selbst:
- Scope. Jeder Agent bekommt nur die Einträge, die er braucht. Ein Arbeits-Agent sieht GitHub und AWS. Ein Deploy-Agent sieht SSH-Schlüssel und die Datenbank.
- Leselimits. Jeder Agent darf nur so viele verschiedene Einträge pro Minute und pro Stunde lesen, und Sie legen die Zahlen fest. Ein Agent, der sein Stundenlimit zweimal innerhalb von zwei Stunden überschreitet, wird gesperrt, bis Sie ihn entsperren.
- Ein Protokoll. Jeder Lesevorgang wird protokolliert: welcher Agent, welcher Eintrag, wann.
Sie betreiben mehrere Agenten? Geben Sie jedem seinen eigenen Proxy und seine eigene Registrierung. Dann hat jeder seinen eigenen Scope, seine eigenen Limits und seine eigene Spur, und Agent A kann die Schlüssel von Agent B nicht sehen.
Die Kurzfassung
Geben Sie einem Agenten nicht Ihren Schlüssel. Geben Sie ihm einen Namen für den Schlüssel, und halten Sie den Schlüssel einen Schritt entfernt, an einem Ort, der jedes Mal neu entscheidet, ob dieser Agent ihn jetzt benutzen darf.
Richten Sie den Proxy ein oder sehen Sie, wie der Agentenzugriff funktioniert.