TOTP / 2FA Kod Üretici

TOTP / 2FA Kod Üretici Nedir?

// Generate a TOTP code in the browser with the Web Crypto API
// (SHA-1, 6 digits, 30s period — RFC 6238 defaults)
async function generateTotp(base32Secret, time = Date.now()) {
  // Decode the Base32 secret to raw bytes (A-Z, 2-7)
  const alpha = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ234567';
  let bits = '';
  for (const c of base32Secret.replace(/=+$/, '').toUpperCase())
    bits += alpha.indexOf(c).toString(2).padStart(5, '0');
  const bytes = new Uint8Array(
    bits.match(/.{8}/g).map((b) => parseInt(b, 2)));

  // Counter = number of 30s steps since the Unix epoch (8-byte big-endian)
  const counter = Math.floor(time / 1000 / 30);
  const msg = new Uint8Array(8);
  let c = counter;
  for (let i = 7; i >= 0; i--) { msg[i] = c & 0xff; c = Math.floor(c / 256); }

  const key = await crypto.subtle.importKey(
    'raw', bytes, { name: 'HMAC', hash: 'SHA-1' }, false, ['sign']);
  const hmac = new Uint8Array(await crypto.subtle.sign('HMAC', key, msg));

  // Dynamic truncation (RFC 4226) -> 6-digit code
  const off = hmac[hmac.length - 1] & 0x0f;
  const bin = ((hmac[off] & 0x7f) << 24) | (hmac[off + 1] << 16) |
              (hmac[off + 2] << 8) | hmac[off + 3];
  return (bin % 1_000_000).toString().padStart(6, '0');
}

const code = await generateTotp('JBSWY3DPEHPK3PXP');
// -> a 6-digit code that rotates every 30 seconds

Temel Özellikler

TOTP Üretici Örnekleri

secret: JBSWY3DPEHPK3PXP
algorithm: SHA-1
digits: 6
period: 30s

Code: 282760  ·  expires in 30s

secret: JBSWY3DPEHPK3PXP
algorithm: SHA-256
digits: 8
period: 30s

Code: 31094217  ·  expires in 30s

issuer: Acme
account: alice@example.com
secret: JBSWY3DPEHPK3PXP

otpauth://totp/Acme:alice@example.com?secret=JBSWY3DPEHPK3PXP&issuer=Acme&algorithm=SHA1&digits=6&period=30

TOTP Üretici Nasıl Kullanılır

1. 1

   Bir Base32 Secret Yapıştırın

   Üret sekmesinde, Base32 secret'ınızı yapıştırın (örneğin JBSWY3DPEHPK3PXP). Geçerli TOTP kodu, 30 saniyelik bir geri sayımla anında görünür — Üret düğmesi yoktur.

2. 2

   Gelişmiş Seçenekleri Ayarlayın (isteğe bağlı)

   Sağlayıcınızın verdiğiyle eşleştirmek için algoritmayı (SHA-1/256/512), hane sayısını (6 veya 8) ya da periyodu (30 veya 60sn) değiştirmek üzere gelişmiş seçenekleri açın.

3. 3

   Kurun veya Doğrulayın

   Bir authenticator uygulaması için secret ve QR üretmek üzere Kurulum sekmesini ya da bir kodu ±1 zaman adımı toleransıyla bir secret'a karşı kontrol etmek üzere Doğrula sekmesini kullanın.

Yaygın Hatalar

secret + SHA-1/6 digits  // but server expects SHA-256/8

algorithm: SHA-256, digits: 8  // match the otpauth:// URI

system clock 90s fast  // code is two steps ahead

enable NTP / automatic time  // code aligns with server

secret: "JBSW 0NE8"  // contains 0 and 8

secret: "JBSWY3DPEHPK3PXP"  // valid Base32

Yaygın Kullanım Senaryoları

Bir 2FA Oturum Açma Akışını Ayıkla

Bir kullanıcının authenticator uygulamasının gösterdiği tam kodu yeniden üretin, böylece iki faktörlü bir oturum açmanın neden reddedildiğini izleyebilirsiniz.

Yeni Bir Hesap Kaydet

Yeni bir Base32 secret ve QR kodu üretin, ardından 2FA'yı kurmak için onu Google Authenticator, Authy veya 1Password'e tarayın.

Sunucunuzun Penceresini Doğrula

Arka uçunuzun yeni dönen bir kodu kabul ettiğini ve süresi dolmuş birini reddettiğini onaylamak için kodları bir secret'a karşı doğrulayın.

Uçtan Uca Test Fixture'ları Oluştur

İki faktörlü kimlik doğrulama akışının otomatik testlerini yürütmek için bilinen bir secret'tan deterministik TOTP kodları hesaplayın.

Kurumsal Ayarlarla Eşleştir

Bir sağlayıcı SHA-1 / 6 hane varsayılanlarından ayrıldığında, bir uyumsuzluğu ayıklamak için 8 haneli veya SHA-256 kodlarını yeniden üretin.

Erişimi Hızla Kurtar

Telefonunuz kullanılamadığında yedeklenmiş bir secret'tan geçerli kodu üretin — secret'ın tek kullanımlık bir kopyasını kullanarak.

Teknik Ayrıntılar

RFC 6238 / RFC 4226 Uyumlu

RFC 4226'daki HOTP dinamik kısaltma algoritmasının üzerine, seçilebilir SHA-1, SHA-256 ve SHA-512 ile RFC 6238'e göre TOTP uygular.

Yerel Web Crypto HMAC

Kodlar, big-endian zaman adımı sayacı üzerinde crypto.subtle HMAC aracılığıyla türetilir. Base32 kod çözme ve kısaltma tamamen tarayıcıda çalışır.

Standart otpauth:// URI'leri, Sıfır Bağımlılık

Kurulum URI'leri, issuer, algoritma, haneler ve periyot parametreleriyle Key Uri Format'ı (otpauth://totp) izler. Harici kitaplık yok, ağ çağrısı yok.

En İyi Uygulamalar

Secret'ı Bir Parola Gibi Ele Al

Base32 secret'a sahip olan herkes gelecekteki her kodu üretebilir. Onu bir secret yöneticisinde saklayın, asla sürüm kontrolünde tutmayın ve burada test secret'larını tercih edin.

Saatleri Senkronize Tut

TOTP doğru zamana bağlıdır. Kodların doğrulama penceresi içinde hizalanması için sunucularda ve cihazlarda ağ zamanı senkronizasyonunu etkinleştirin.

Gerekmedikçe Varsayılanlara Bağlı Kal

SHA-1, 6 hane ve 30 saniyelik periyot uygulama uyumluluğunu en üst düzeye çıkarır. Yalnızca sağlayıcınız zorunlu kıldığında 8 haneye veya SHA-256/512'ye geçin.

TOTP / 2FA Üretici SSS