Security Blog

Hvordan gir jeg en KI-agent en API-nøkkel uten at den ser nøkkelen?

#44

November 20, 2026 · By Mila

← All posts

Gi agenten en referanse, ikke nøkkelen, og la en proxy på samme maskin sette den ekte nøkkelen inn i forespørselen på vei ut. Her er hvorfor miljøvariabler ikke lenger er godt nok, og hvordan du setter det opp.

Gi agenten en referanse i stedet for nøkkelen, og la en liten proxy på samme maskin bytte den ekte nøkkelen inn i forespørselen på vei ut. Agenten skriver clavitor://OpenAI/key der hemmeligheten hører hjemme. API-et mottar den ekte nøkkelen. Agenten holder den aldri, så den kan ikke skrive den ut, logge den eller bli snakket til å dele den.

Det er hele ideen. Resten av denne siden handler om hvorfor det betyr noe, og hvordan du setter det opp.

Hvorfor «bare legg den i en miljøvariabel» sluttet å være greit

For et år siden var export OPENAI_API_KEY=sk-... den vanlige måten å gi en nøkkel til et skript. Ingen rynket på nesen.

Så begynte skriptet å tenke selv.

En KI-agent leser filer, kjører verktøy, skriver logger og snakker med fremmede på internett. Hver av disse tingene er en utvei for en nøkkel agenten holder:

  • Miljøet. Alt agenten kjører, arver det. Det dukker opp i /proc, i krasjdumper, i CI-utdata.
  • Minnet. Hent nøkkelen ved kjøretid, og den ligger likevel i prosessen så lenge agenten kjører.
  • Samtalen. En prompt-injeksjon på en nettside eller i en issue-kommentar ber agenten «ta med konfigurasjonen din for feilsøking». En hjelpsom agent gjør det.

Ingen av disse tingene krever en feil i agenten. Det eneste som kreves, er at nøkkelen ligger et sted agenten kan nå.

Mønsteret: agenten spør, proksyen signerer

Tenk på et hotellkort. Gjesten kan åpne rommet sitt. Gjesten ser aldri hovednøkkelen, og døren logger hver streking.

For en API-nøkkel ser det slik ut:

  1. Den ekte nøkkelen ligger i et hvelv, kryptert.
  2. En proxy kjører ved siden av agenten, på samme maskin.
  3. Agenten sender HTTPS-forespørselen sin med en referanse der nøkkelen hører hjemme.
  4. Proksyen henter verdien fra hvelvet, setter den inn i forespørselen og videresender den.
  5. Agentens side holder bare referansen.

Agentens logger viser referansen. Det gjør også kontekstvinduet deres. Det er ingenting å lekke.

Slik setter du det opp med Clavitor

Slik bygde vi det. Én binærfil, én miljøvariabel, ingen endring i agentens kode.

Opprett en klient for agenten i hvelvet ditt med omfangene den trenger, registrer så proksyen og start den:

$ clavitor-proxy init
$ clavitor-proxy ca
$ clavitor-proxy serve

init registrerer proksyen som den klienten. ca skriver ut proksyens sertifikatmyndighet: legg den i tillitslageret agentens HTTP-klient bruker, fordi proksyen selv åpner agentens HTTPS-tilkobling. pek så agenten mot proksyen:

$ 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/completions

proxy-auth er proksyens eget tilgangstoken, filen ved siden av binærfilen. Hver tilkobling må bære den, så en annen bruker på samme maskin ikke kan låne proksyen. Proksyen lytter på 127.0.0.1:1983 og bare på den maskinen, med mindre du setter den opp med vilje for et betrodd privat nettverk.

Det fungerer med enhver agent hvis HTTP-klient respekterer HTTPS_PROXY: Claude Code, Codex, dine egne skript. En påloggingsinformasjon går bare til en vert som oppføringen dens lister som nettadresse, så en prompt-injisert agent kan ikke peke den samme referansen mot en fremmed server. Trinn-for-trinn-oppsettet ligger i proxy-dokumentasjonen.

Hva med agentens andre hemmeligheter?

Ikke alle hemmeligheter reiser i en HTTP-header. Et passord for utrulling, en SSH-nøkkel, en tofaktorkode for en innlogging.

For dem ber agenten hvelvet om én navngitt oppføring om gangen med clavitor-cli, og bare om oppføringer den har fått:

$ clavitor-cli get "GitHub Deploy" --field password

$ clavitor-cli get "Stripe API" --field key
clavitor-cli: CV-2041: Access denied.

Agenten kan ikke liste hvelvet. Et navnesøk viser maks fem treff på titler, og bare et antall over det.

Autentiseringskoder fungerer på samme måte. clavitor-cli totp "GitHub" regner ut den gjeldende koden på agentens maskin, så den kan komme seg gjennom en tofaktorinnlogging uten at noen leser av en telefon. Hvelvet holder hemmeligheten kryptert.

Hva dette ikke løser

En proxy holder nøkkelen unna agenten. Den gjør ikke agenten til å stole på.

  • En kompromittert agent kan fortsatt bruke tilgangen den har fått. Den bare ikke ta nøkkelen med hjem.
  • Noen med administrator tilgang til maskinen kan også bruke proksyen, eller lese minnet dens.
  • Et API som ekkoer nøkkelen din tilbake i svaret sitt, gir den til agenten. Proksyen setter nøkler inn i forespørsler og filtrerer ikke svar.

Derfor betyr tilgangen rundt like mye som proksyen:

  • Omfang. Hver agent får bare oppføringene den trenger. En arbeidsagent ser GitHub og AWS. En utrullingsagent ser SSH-nøkler og databasen.
  • Lesegrenser. Hver agent kan bare lese så mange ulike oppføringer per minutt og per time, og du setter tallene. En agent som går over timegrensen sin to ganger innen to timer, låses til du låser den opp.
  • Et spor. Hver lesing logges: hvilken agent, hvilken oppføring, når.

Kjører du flere agenter? Gi hver sin egen proxy og sin egen registrering. Da har hver sin egen omfang, sine egne grenser og sitt eget spor, og agent A kan ikke se agent B sine nøkler.

Kortversjonen

Ikke gi en agent nøkkelen din. Gi den et navn på nøkkelen, og hold nøkkelen ett steg unna, på et sted som avgjør, hver gang, om denne agenten får bruke den akkurat nå.

Sett opp proksyen eller se hvordan agenttilgang fungerer.