پرش به محتوای اصلی

راهنمای کد دومرحله‌ای TOTP/HOTP

زمان مطالعه: ۳ دقیقه

این ابزار چیست؟

کدهای شش‌رقمی ورود دومرحله‌ای که Google Authenticator یا برنامه‌های مشابه نشان می‌دهند، با استاندارد TOTP از یک کلید مخفی و ساعت ساخته می‌شوند؛ نسخه‌ی شمارنده‌ای آن HOTP نام دارد. برنامه‌نویسی که ورود دومرحله‌ای را پیاده می‌کند باید بتواند کد را بسازد، بسنجد و QR افزودن حساب را تولید کند. این ابزار همه‌ی این کارها را برای آزمایش انجام می‌دهد.

کلید را می‌سازید یا وارد می‌کنید، الگوریتم، تعداد رقم و بازه را تنظیم می‌کنید و کد فعلی، قبلی و بعدی را با شمارش معکوس می‌بینید. همه‌چیز در مرورگر شما محاسبه می‌شود و این ابزار هیچ ورودی‌ای را در تاریخچه ذخیره نمی‌کند؛ با این حال کلید حساب‌های واقعی خود را این‌جا نگذارید.

گام‌به‌گام

  1. نوع کد را انتخاب کنید

    «TOTP (زمانی)» برای کدهایی که هر چند ثانیه عوض می‌شوند و «HOTP (شمارنده‌ای)» برای کدهایی که با هر استفاده جلو می‌روند.

  2. کلید را بدهید

    کلید مخفی Base32 را بنویسید یا یکی تازه بسازید؛ می‌توانید یک نشانی otpauth:// را هم بچسبانید تا همه‌ی تنظیم‌ها از آن خوانده شود.

  3. تنظیم‌ها را بررسی کنید

    الگوریتم SHA1، SHA256 یا SHA512، تعداد رقم و بازه را مطابق سرویس بگذارید. بیشتر برنامه‌ها SHA1، شش رقم و ۳۰ ثانیه را انتظار دارند.

  4. کد را ببینید یا بسنجید

    کد فعلی و کدهای قبلی و بعدی نمایش داده می‌شوند. در «بررسی یک کد» کدی را بنویسید تا ببینید با بازه‌ی فعلی یا یک بازه پیش یا پس می‌خواند یا نه.

  5. QR بسازید

    صادرکننده و نام حساب را بنویسید تا نشانی otpauth و QR آن برای افزودن به برنامه‌ی احراز هویت ساخته شود.

نمونه‌های کاربردی

  • کلید بردار آزمون RFC 6238

    کلید رشته‌ی 12345678901234567890 است که در Base32 نوشته شده؛ با هشت رقم، نشانی otpauth زیر ساخته می‌شود.

    نتیجه: otpauth://totp/Example:ali%40example.ir?issuer=Example&secret=GEZDGNBVGY3TQOJQGEZDGNBVGY3TQOJQ&algorithm=SHA1&digits=8&period=30

  • کلید کوتاه

    کلید رایج آموزش‌ها فقط ۸۰ بیت است و ابزار هشدار می‌دهد.

    نتیجه: این کلید ۸۰ بیتی است؛ RFC 4226 دست‌کم ۱۲۸ بیت (۲۶ نویسه‌ی Base32) می‌خواهد.

اشتباه‌های رایج

  • ساعت نادرست دستگاه: TOTP به زمان وابسته است و چند ثانیه اختلاف هم کد را نامعتبر می‌کند. ساعت سرور و گوشی را خودکار همگام کنید.
  • تنظیم‌های ناهمخوان: اگر سرور SHA256 یا هشت رقم بخواهد و برنامه‌ی کاربر پیش‌فرض را بگذارد، کدها نمی‌خوانند. همه‌ی تنظیم‌ها را در نشانی otpauth بگذارید.
  • پذیرفتن دوباره‌ی یک کد: سرور باید کدی را که یک بار پذیرفته در همان بازه دوباره نپذیرد تا جلوی حمله‌ی بازپخش گرفته شود.
  • ذخیره‌ی کلید بدون رمزگذاری در پایگاه داده: هر کس کلید را داشته باشد همه‌ی کدها را می‌سازد. آن را مثل گذرواژه حفاظت کنید.

TOTP چطور کار می‌کند؟

زمان یونیکس بر طول بازه، معمولاً ۳۰ ثانیه، تقسیم می‌شود تا یک شمارنده به دست آید. HMAC این شمارنده با کلید مخفی حساب می‌شود و چند رقم از نتیجه بیرون کشیده می‌شود. سرور و برنامه‌ی کاربر با کلید و ساعت یکسان، کد یکسان می‌سازند بی‌آنکه چیزی میانشان رد و بدل شود.

در بردار آزمون RFC 6238 با همین کلید، در ثانیه‌ی ۵۹ پس از آغاز زمان یونیکس، کد هشت‌رقمی SHA1 برابر 94287082 است؛ این ابزار همین مقدار را می‌سازد.

پرسش‌های متداول

چرا کد این ابزار با برنامه‌ی گوشی من فرق دارد؟
معمولاً ساعت یکی از دو دستگاه جلو یا عقب است؛ کد TOTP هر ۳۰ ثانیه از روی زمان ساخته می‌شود. ساعت هر دو را خودکار تنظیم کنید و مطمئن شوید الگوریتم، تعداد رقم و بازه هم یکی است.
کلید مخفی یا QR من جایی ذخیره می‌شود؟
خیر؛ همه‌چیز در حافظه‌ی همین صفحه است و با بستن آن پاک می‌شود. چون هر کس کلید یا QR را داشته باشد کدها را می‌سازد، آن را فقط روی دستگاه خودتان نمایش دهید.
TOTP و HOTP چه فرقی دارند؟
TOTP (RFC 6238) کد را از زمان می‌سازد و هر چند ثانیه عوض می‌شود؛ HOTP (RFC 4226) از یک شمارنده که با هر بار استفاده یکی زیاد می‌شود. بیشتر سرویس‌ها TOTP به کار می‌برند.

ابزارهای مرتبط