Security Blog

Apakah Claude Code dapat menggunakan kode 2FA Anda tanpa melihat secret-nya?

#45

November 22, 2026 · By Mila

← All posts

Ya. Simpan secret authenticator di brankas, dan biarkan agen meminta kode, bukan secret-nya. `clavitor-cli totp "GitHub"` menghitung enam digit saat ini di mesin agen dan hanya mencetak digit tersebut. Brankas menyimpan secret dalam bentuk terenkripsi dan tidak pernah melihatnya.

Bagian selanjutnya dari halaman ini menjelaskan mengapa hal itu penting, cara mengaturnya, dan satu keputusan yang Anda ambil untuk setiap akun.

Mengapa ponsel berhenti bekerja

Sign-in dua faktor dibangun di sekitar seorang manusia dengan ponsel. Situs meminta kode, Anda membuka aplikasi authenticator, Anda mengetik enam digit.

Lalu yang melakukan sign-in menjadi sebuah skrip. Claude Code men-deploy, membuka dashboard, memeriksa konsol yang berada di balik 2FA. Pada langkah keempat ia berhenti dan menunggu Anda mencari ponsel Anda.

Maka orang melakukan cara cepat. Mereka menempelkan secret, string panjang di balik kode QR, ke file konfigurasi atau prompt, dan membiarkan agen membuat kode sendiri.

String itu bukan kode. Itu adalah hal yang menghasilkan setiap kode, selama akun itu hidup. Siapa pun yang memegangnya memiliki faktor kedua Anda sampai Anda me-reset-nya. Di tangan agen, ia bisa berakhir di log, transkrip, atau balasan atas prompt injection yang meminta "setup Anda, untuk debugging".

Polanya: minta kodenya, bukan secret-nya

Sebuah kode berlaku tiga puluh detik. Sebuah secret berlaku sampai Anda mengubahnya. Jadi agen seharusnya mendapatkan yang pertama dan tidak pernah yang kedua.

Dengan Clavitor itu satu perintah:

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

Apa yang terjadi:

  1. CLI mengambil entri GitHub dari brankas, dalam bentuk terenkripsi.
  2. CLI mendekripsi field one-time-password dengan kunci agen itu sendiri, di mesin agen.
  3. CLI menghitung kode saat ini dan mencetaknya dalam satu baris, tidak ada yang lain.

Tangkap kode di dalam perintah yang membutuhkannya, seperti di atas. Jangan menjalankan totp sendirian: maka kode akan masuk ke output agen, yang merupakan transkripnya.

CLI membaca secret biasa (enam digit, tiga puluh detik) atau tautan otpauth:// lengkap, dan mengikuti pengaturan tautan itu sendiri: 6 sampai 8 digit, SHA-1, SHA-256 atau SHA-512.

Menyiapkannya untuk Claude Code

  1. Di brankas Anda, buka Clients, lalu + New client. Beri nama "Claude Code" dan pilih entri yang boleh digunakannya.
  2. Di mesin tempat Claude Code berjalan, tempelkan enrollment blob, ketik enrollment key saat diminta, dan instal skill:
$ clavitor-cli init '<blob>'
Enrollment key:
$ clavitor-cli skill install

Skill itu mengajarkan Claude Code cara menggunakan brankas: satu entri pada satu waktu, berdasarkan nama, dan nilai ditangkap di tempat digunakan, bukan dicetak.

Satu keputusan: kode mana yang boleh dibaca agen?

Secret authenticator baru di Clavitor hanya milik Anda. Ia disimpan di bawah Enkripsi identitas, yang hanya kunci perangkat keras Anda yang dapat membukanya. Minta agen menggunakannya dan ia akan mendapat penolakan (CV-2048) yang menyebutkan field tersebut.

Itu adalah default yang tepat. Bank Anda, email Anda, konsol admin perusahaan Anda: tidak ada agen yang membutuhkan kode-kode itu.

Untuk akun-akun tempat agen seharusnya melewati sign-in sendiri, buka entri di halaman brankas Anda dan klik lencana L3 kecil di sebelah field. Konfirmasikan, dan field itu saja berpindah ke Enkripsi kredensial. Lencananya menjadi L2, dan clavitor-cli totp bekerja untuk field itu. Halaman brankas Anda yang tidak terkunci sudah memegang kuncinya, jadi tidak ada ketukan tambahan. Berubah pikiran? Klik L2, konfirmasikan, dan hanya kunci Anda yang membukanya lagi.

Jadi ini per akun, dan itu keputusan Anda setiap kali.

Apa yang tidak diselesaikan oleh ini

Sebuah kode tetap merupakan kode yang berfungsi selama tiga puluh detik.

  • Agen yang telah dibujuk tetap dapat sign-in dengan akses yang Anda berikan. Ia hanya tidak dapat membawa kabur secret-nya.
  • Begitu agen dapat membuat kodenya sendiri, 2FA itu tidak lagi membuktikan bahwa ada manusia di sana. Tidak masalah untuk akun deploy. Pikirkan dua kali di tempat yang "seorang manusia menyetujui ini" adalah intinya.
  • Seseorang dengan akses administrator ke mesin agen dapat menggunakan apa pun yang dapat digunakan agen.

Itulah mengapa akses di sekitarnya penting:

  • Cakupan. Agen hanya menjangkau entri yang Anda berikan kepada client-nya.
  • Batasan baca. Setiap kode adalah satu pembacaan entri, dihitung terhadap batasan client.
  • Catatan. Setiap permintaan kode adalah satu pembacaan entri, dan tercatat di log audit Anda.

Versi singkatnya

Jangan berikan secret authenticator Anda kepada agen. Berikan cara untuk meminta kode saat ini, untuk akun yang Anda pilih, dan simpan satu baris di log untuk setiap kali ia melakukannya.

Lihat cara kerja akses agen atau baca dokumentasi totp.