Security Blog

Voiko Claude Code käyttää 2FA-koodejani näkemättä salaisuutta?

#45

November 22, 2026 · By Mila

← All posts

Kyllä. Pitäkää tunnistautujan salaisuus holvissa, ja antakaa agentin pyytää koodia, ei koskaan salaisuutta. `clavitor-cli totp "GitHub"` laskee nykyiset kuusi numeroa agentin koneella ja tulostaa vain ne. Holvi pitää salaisuuden salattuna eikä koskaan näe sitä.

Tämän sivun loppuosa selittää, miksi tämä on tärkeää, miten se otetaan käyttöön, ja minkä yhden valinnan teette jokaiselle tilille.

Miksi puhelin lakkasi toimimasta

Kaksivaiheinen kirjautuminen rakennettiin ihmisen ja puhelimen ympärille. Sivusto pyytää koodin, avaatte tunnistautumissovelluksen, kirjoitatte kuusi numeroa.

Sitten kirjautujaksi tuli skripti. Claude Code tekee julkaisun, avaa hallintapaneelin, tarkistaa konsolin, joka on 2FA:n takana. Neljännessä vaiheessa se pysähtyy ja odottaa, että etsitte puhelimenne.

Ihmiset tekevät sitten nopean ratkaisun. He liittävät salaisuuden, QR-koodin takana olevan pitkän merkkijonon, asetustiedostoon tai kehotteeseen ja antavat agentin luoda koodit itse.

Se merkkijono ei ole koodi. Se on asia, joka tuottaa jokaisen koodin niin kauan kuin tili on olemassa. Kenellä tahansa sen haltijalla on toinen tunnistautumistekijänne, kunnes nollaatte sen. Agentin käsissä se voi päätyä lokiin, transkriptioon tai vastaukseen kehotteinjektioon, joka pyytää "asetuksianne, virheenkorjausta varten".

Kaava: pyytäkää koodi, ei salaisuutta

Koodi kestää kolmekymmentä sekuntia. Salaisuus kestää, kunnes vaihdatte sen. Agentin tulisi saada ensimmäinen eikä koskaan jälkimmäinen.

Clavitorilla tämä on yksi komento:

$ code=$(clavitor-cli totp "GitHub")

Mitä tapahtuu:

  1. CLI noutaa GitHub-kohdan holvista salattuna.
  2. Se purkaa kertakäyttösalasanan kentän salauksen agentin omalla avaimella, agentin koneella.
  3. Se laskee nykyisen koodin ja tulostaa sen yhdellä rivillä, ei mitään muuta.

Ottaa koodin talteen sen komennon sisällä, joka tarvitsee sitä, kuten yllä. Älkää ajako totp-komentoa erikseen: silloin koodi päätyy agentin tulosteeseen, joka on sen transkriptio.

Se lukee joko pelkän salaisuuden (kuusi numeroa, kolmekymmentä sekuntia) tai täyden otpauth://-linkin, ja noudattaa linkin omia asetuksia: 6–8 numeroa, SHA-1, SHA-256 tai SHA-512.

Käyttöönotto Claude Codelle

  1. Avatkaa holvissanne Clients ja sitten + New client. Nimekää se "Claude Code" ja valitkaa kohdat, joita se saa käyttää.
  2. Koneella, jolla Claude Code toimii, liittäkää rekisteröintiblob, kirjoittakaa rekisteröintiavain kehotteeseen ja asentakaa taito:
$ clavitor-cli init '<blob>'
Enrollment key:
$ clavitor-cli skill install

Taito opettaa Claude Codelle, miten holvia käytetään: yksi kohde kerrallaan, nimen perusteella, ja arvot talteen siellä, missä niitä käytetään, tulostamisen sijaan.

Se yksi valinta: mitkä koodit agentti saa lukea?

Uusi tunnistautujan salaisuus Clavitorissa on vain teidän. Se tallennetaan Identity Encryption -menetelmällä, jonka vain teidän laitteistonne avain avaa. Pyytäkää agenttia käyttämään sitä, ja se saa kieltäytymisen (CV-2048), jossa mainitaan kyseinen kenttä.

Se on oikea oletus. Pankkinne, sähköpostinne, yrityksenne hallintakonsoli: mikään agentti ei tarvitse niiden koodeja.

Tileille, joilla agentin pitää päästä kirjautumaan sisään itse, avatkaa kohta holvisivullanne ja napsauttakaa pientä L3-merkkiä kentän vieressä. Vahvistakaa, ja vain tuo yksi kenttä siirtyy Credential Encryption -menetelmään. Merkki lukee L2, ja clavitor-cli totp toimii sille. Avattu holvisivunne pitää jo avainta hallussaan, joten lisänapautusta ei tarvita. Muutitteko mieltänne? Napsauttakaa L2, vahvistakaa, ja vain teidän avaimenne avaa sen taas.

Kyse on siis tilikohtaisesta valinnasta, ja se on teidän päätöksenne joka kerta.

Mitä tämä ei ratkaise

Koodi on edelleen toimiva koodi kolmekymmentä sekuntia.

  • Agentti, johon on onnistuttu vaikuttamaan, voi silti kirjautua sisään sillä pääsyoikeudella, jonka sille annoitte. Se ei vain voi viedä salaisuutta mukanaan.
  • Kun agentti voi luoda omat koodinsa, 2FA ei enää todista, että paikalla oli ihminen. Hyväksyttävää julkaisutilille. Miettikää kahdesti siellä, missä "ihminen hyväksyi tämän" on olennaisinta.
  • Henkilö, jolla on järjestelmänvalvojan pääsy agentin koneelle, voi käyttää kaikkea sitä, mitä agentti voi käyttää.

Siksi ympärillä oleva pääsy ratkaisee:

  • Laajuus. Agentti tavoittaa vain ne kohdat, jotka annoitte sen asiakkaalle.
  • Lukurajat. Jokainen koodi on yksi kohdan luku, joka lasketaan asiakkaan rajoihin.
  • Kirjaus. Jokainen koodipyyntö on yksi kohdan luku, ja se kirjataan auditointilokiinne.

Lyhyesti

Älkää antako agentille tunnistautujan salaisuuttanne. Antakaa sille tapa pyytää nykyistä koodia, tileiltä jotka valitsette, ja pitäkää lokissa rivi joka kerta, kun se tekee niin.

Katsokaa, miten agenttien pääsy toimii tai lukakaa totp-dokumentaatio.