Security Blog

Claude Code, gizli anahtarı görmeden 2FA kodlarımı kullanabilir mi?

#45

November 22, 2026 · By Mila

← All posts

Evet. Kimlik doğrulayıcı gizli anahtarını bir kasada tutun ve ajanın kodu istemesine izin verin, asla gizli anahtarı değil. `clavitor-cli totp "GitHub"`, ajanın makinesinde güncel altı basamağı hesaplar ve yalnızca onları yazdırır. Kasa, gizli anahtarı şifreli tutar ve onu asla görmez.

Bu sayfanın geri kalanı, bunun neden önemli olduğunu, nasıl kurulacağını ve her hesap için verdiğiniz tek kararı açıklıyor.

Telefon neden artık işe yaramıyor

İki adımlı oturum açma, telefonu olan bir kişi etrafında tasarlandı. Site bir kod ister, siz kimlik doğrulayıcı uygulamanızı açar, altı basamak yazarsınız.

Sonra oturum açan bir betik oldu. Claude Code dağıtır, bir panel açar, 2FA arkasındaki bir konsolu denetler. Dördüncü adımda durur ve telefonunuzu bulmanızı bekler.

İnsanlar da hızlı çözümü uygular. Gizli anahtarı — QR kodunun arkasındaki uzun dizgiyi — bir yapılandırma dosyasına veya bir isteme yapıştırır ve ajanın kendisi kod üretmesine izin verir.

O dizgi bir kod değildir. Hesap yaşadığı sürece her kodu üreten şeydir. Onu elinde tutan, siz sıfırlayana kadar ikinci faktörünüze sahiptir. Bir ajanın elinde günlüğe, transkripte veya "kurulumunuzu, hata ayıklama için" diyen bir istem enjeksiyonuna verilen yanıta düşebilir.

Örüntü: kodu isteyin, gizli anahtarı değil

Bir kod otuz saniye yaşar. Bir gizli anahtar, siz onu değiştirene kadar yaşar. Dolayısıyla ajan ilkiyi almalı, ikinciyi asla almamalıdır.

Clavitor ile bu tek komuttur:

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

Ne olur:

  1. CLI, GitHub kaydını kasadan, şifreli olarak alır.
  2. Tek kullanımlık parola alanını, ajanın kendi anahtarıyla, ajanın makinesinde çözer.
  3. Güncel kodu hesaplar ve tek satırda yazdırır, başka hiçbir şey.

Kodu, ona ihtiyaç duyan komutun içinde yakalayın, yukarıdaki gibi. totp komutunu tek başına çalıştırmayın: o zaman kod ajanın çıktısına, yani transkriptine düşer.

CLI düz bir gizli anahtar (altı basamak, otuz saniye) veya tam bir otpauth:// bağlantısı okur ve o bağlantının kendi ayarlarını izler: 6 ila 8 basamak, SHA-1, SHA-256 veya SHA-512.

Claude Code için kurulum

  1. Kasanızda Clients'ı açın, sonra + New client'ı seçin. "Claude Code" adını verin ve kullanmasına izin verilecek kayıtları seçin.
  2. Claude Code'un çalıştığı makinede kayıt blob'unu yapıştırın, istemde kayıt anahtarını yazın ve yeteneği kurun:
$ clavitor-cli init '<blob>'
Enrollment key:
$ clavitor-cli skill install

Bu yetenek, Claude Code'a kasayı nasıl kullanacağını öğretir: aynı anda tek bir kayıt, adıyla, ve değerler yazdırılmak yerine kullanıldıkları yerde yakalanır.

Tek karar: bir ajan hangi kodları okuyabilir?

Clavitor'daki yeni bir kimlik doğrulayıcı gizli anahtarı yalnızca sizindir. Kimlik şifrelemesi altında kaydedilir ve yalnızca donanım anahtarınız açar. Bir ajandan onu kullanmasını isterseniz, alanı adlandıran bir ret yanıtı alır (CV-2048).

Bu doğru varsayılandır. Bankanız, e-postanız, şirketinizin yönetim konsolu: hiçbir ajanın bu kodlara ihtiyacı yoktur.

Ajanın kendi başına oturum açması gereken hesaplarda, kasanızın sayfasında kaydı açın ve alanın yanındaki küçük L3 rozetine tıklayın. Onaylayın; o tek alan Kimlik bilgileri şifrelemesine taşınır. Rozet L2 okur ve clavitor-cli totp onun için çalışır. Kilidi açık kasa sayfanız zaten anahtarı elinde tutar, yani ekstra bir dokunuş gerekmez. Fikrinizi mi değiştirdiniz? L2'ye tıklayın, onaylayın ve yalnızca sizin anahtarınız tekrar açar.

Yani hesap hesaptır ve her seferinde karar sizindir.

Bunun çözmediği şeyler

Bir kod, otuz saniye boyunca yine de geçerli bir koddur.

  • Bir şeylere ikna edilmiş bir ajan, ona verdiğiniz erişimle yine oturum açabilir. Yalnızca gizli anahtarla uzaklaşamaz.
  • Bir ajan kendi kodlarını üretebildiğinde, o 2FA artık orada bir kişinin bulunduğunu kanıtlamaz. Bir dağıtım hesabı için sorun değil. "Bir insan bunu onayladı" noktanın kendisi olduğu yerlerde iki kez düşünün.
  • Ajanın makinesinde yönetici erişimi olan biri, ajanın kullanabildiği her şeyi kullanabilir.

Bu yüzden etrafındaki erişim önemlidir:

  • Kapsam. Ajan yalnızca istemcisine verdiğiniz kayıtlara ulaşabilir.
  • Okuma sınırları. Her kod, kaydın bir okumasıdır ve istemcinin sınırlarına sayılır.
  • Bir kayıt. Her kod isteği kaydın bir okumasıdır ve denetim günlüğünüze kaydedilir.

Kısa versiyon

Ajanınıza kimlik doğrulayıcı gizli anahtarınızı vermeyin. Ona, seçtiğiniz hesaplar için güncel kodu isteme yolu verin ve her yaptığında günlükte bir satır kalsın.

Ajan erişiminin nasıl çalıştığına bakın veya totp belgelerini okuyun.