Claude Code può usare i miei codici 2FA senza vedere il segreto?
Sì. Conservi il segreto dell'autenticatore in una cassaforte e lasci che l'agente chieda il codice, mai il segreto. `clavitor-cli totp "GitHub"` calcola le sei cifre correnti sulla macchina dell'agente e stampa solo quelle. La cassaforte conserva il segreto cifrato e non lo vede mai.
Il resto di questa pagina spiega perché la cosa conta, come configurarla e l'unica scelta che Lei prende per ciascun account.
Perché il telefono ha smesso di funzionare
L'accesso a due fattori era stato pensato attorno a una persona con un telefono. Il sito chiede un codice, Lei apre l'app dell'autenticatore, digita sei cifre.
Poi chi accede è diventato uno script. Claude Code fa il deploy, apre una dashboard, controlla una console che sta dietro un 2FA. Al quarto passo si ferma e aspetta che Lei trovi il telefono.
Così la gente fa la cosa rapida. Incolla il segreto, la lunga stringa dietro il codice QR, in un file di configurazione o in un prompt, e lascia che l'agente generi i codici da solo.
Quella stringa non è un codice. È la cosa che genera ogni codice, per tutta la vita dell'account. Chi la possiede ha il Suo secondo fattore finché non lo reimposta. Nelle mani di un agente può finire in un log, in una trascrizione o in una risposta a un prompt injection che chiede "la tua configurazione, per il debug".
Il pattern: chiedere il codice, non il segreto
Un codice dura trenta secondi. Un segreto dura finché non lo cambia. L'agente quindi deve ricevere il primo e mai il secondo.
Con Clavitor è un solo comando:
$ code=$(clavitor-cli totp "GitHub")
Cosa succede:
- La CLI recupera la voce GitHub dalla cassaforte, cifrata.
- Decifra il campo della password monouso con la chiave dell'agente stesso, sulla macchina dell'agente.
- Calcola il codice corrente e lo stampa su una riga, nient'altro.
Catturi il codice all'interno del comando che lo serve, come sopra. Non esegua totp da solo: in quel caso il codice finisce nell'output dell'agente, che è la sua trascrizione.
Legge un segreto semplice (sei cifre, trenta secondi) o un link otpauth:// completo, e segue le impostazioni del link stesso: da 6 a 8 cifre, SHA-1, SHA-256 o SHA-512.
Configurazione per Claude Code
- Nella Sua cassaforte, apra Clients, poi + New client. Lo chiami "Claude Code" e scelga le voci che potrà usare.
- Sulla macchina dove gira Claude Code, incolli il blob di enrollment, digiti la chiave di enrollment al prompt e installi la skill:
$ clavitor-cli init '<blob>' Enrollment key: $ clavitor-cli skill install
La skill insegna a Claude Code come usare la cassaforte: una voce alla volta, per nome, e i valori catturati dove vengono usati invece che stampati.
L'unica scelta: quali codici può leggere un agente?
Un nuovo segreto dell'autenticatore in Clavitor è solo Suo. È salvato sotto Crittografia dell'identità, che solo la Sua chiave hardware apre. Se chiede a un agente di usarlo, riceve un rifiuto (CV-2048) che nomina il campo.
È il default giusto. La Sua banca, la Sua email, la console di amministrazione della Sua azienda: nessun agente ha bisogno di quei codici.
Per gli account in cui un agente deve superare l'accesso da solo, apra la voce nella Sua pagina della cassaforte e clicchi il piccolo badge L3 accanto al campo. Confermi, e quel solo campo passa a Crittografia delle credenziali. Il badge mostra L2, e clavitor-cli totp funziona per lui. La Sua pagina della cassaforte sbloccata ha già la chiave, quindi non c'è un tocco in più. Ha cambiato idea? Clicchi L2, confermi, e di nuovo solo la Sua chiave lo apre.
Quindi è per account, ed è una Sua decisione ogni volta.
Cosa questo non risolve
Un codice resta un codice valido per trenta secondi.
- Un agente che è stato convinto a fare qualcosa può comunque accedere con i permessi che Lei gli ha dato. Semplicemente non può portarsi via il segreto.
- Una volta che un agente può generare i propri codici, quel 2FA non dimostra più che c'era una persona. Va bene per un account di deploy. Ci pensi due volte dove "un essere umano ha approvato questo" è il punto.
- Chi ha accesso da amministratore alla macchina dell'agente può usare tutto ciò che l'agente può usare.
Ecco perché conta ciò che sta attorno:
- Ambito. L'agente raggiunge solo le voci che Lei ha assegnato al suo client.
- Limiti di lettura. Ogni codice è una lettura della voce, conteggiata nei limiti del client.
- Una traccia. Ogni richiesta di codice è una lettura della voce, e viene registrata nel Suo log di audit.
In breve
Non dia a un agente il Suo segreto dell'autenticatore. Gli dia un modo per chiedere il codice corrente, per gli account che sceglie, e tenga una riga nel log per ogni volta che lo fa.
Veda come funziona l'accesso degli agenti o legga la documentazione di totp.