otp node js؛ ورود با شماره و کد یکبارمصرف فقط با امکانات خود Node
otp node js یعنی ساختن ورود با شمارهی موبایل و کد پیامکی در سروری که با Node.js نوشته شده است. کار اصلی چهار قدم دارد: کد با مولد امن ساخته میشود، چکیدهی آن با زمان انقضا ذخیره میشود، کد با پیامک میرود، و در بررسی، تعداد تلاش و زمان مقایسه کنترل میشود. نیازی به کتابخانهی اضافه نیست؛ ماژول crypto خود Node برای همهی این کارها کافی است. این صفحه نمونهی کوتاه و فارسینویسیشدهی آن را میدهد و آخرش نشان میدهد ورود با فینگت چطور کل ماجرا را کوتاه میکند.
otp node js چه قطعههایی دارد؟
otp در node.js از دو تابع اصلی ساخته میشود: requestCode که کد میسازد و میفرستد، و verifyCode که کد کاربر را میسنجد. بعد از آن یک نشست ساخته میشود تا کاربر وارد بماند.
اگر مفهوم کد یکبارمصرف برایتان تازه است، اول رمز یکبار مصرف otp را بخوانید. این صفحه فقط پیادهسازی را نشان میدهد. بخش خود سرویس پیامک هم به شرکتی که انتخاب کردهاید بستگی دارد؛ اصول کلی آن در وب سرویس پیامک آمده است.
چرا بدون Express؟
نمونهها فقط از ماژولهای خود Node استفاده میکنند تا هر چیزی که میبینید قابل اجرا باشد. اگر پروژهتان Express دارد، ساخت otp با express همین دو تابع است؛ هر کدام را در یک مسیر POST صدا میزنید و کوکی را با res.cookie میگذارید. منطق امنیتی یکی است و به چارچوب بستگی ندارد.
ساخت کد، چکیده، انقضا و سقف تلاش در همهی چارچوبها یکسان است. فقط جای صدا زدن آنها فرق میکند.
ابزارهای ماژول crypto که لازم دارید
برای کد یکبارمصرف با crypto فقط سه تابع کافی است. معنی هر کدام و دلیل انتخابش را اینجا میخوانید.
- crypto.randomInt
- عدد صحیح تصادفی از منبع امن سیستمعامل میدهد. Math.random برای کدهای امنیتی مناسب نیست، چون خروجیاش را میشود از روی چند نمونه پیشبینی کرد.
- crypto.createHmac
- چکیدهی کلیددار میسازد. با کلید مخفی سرور، حتی اگر کسی همهی چکیدهها را بردارد نمیتواند از روی آن کد را پیدا کند. چون کد ششرقمی فقط یک میلیون حالت دارد، چکیدهی بیکلید را میشود بهسرعت شکست.
- crypto.timingSafeEqual
- دو مقدار را بدون نشت زمان مقایسه میکند. هر دو ورودی باید همطول باشند؛ چکیدهها همیشه همطولاند.
- crypto.randomBytes
- بایتهای تصادفی امن میدهد؛ برای ساختن شناسهی نشست به کار میآید.
ساخت کد و بررسی آن؛ منطق اصلی
نمونهی زیر را در یک فایل ES module ذخیره کنید، مثلاً otp.mjs. دادهها برای سادگی در حافظهاند؛ اگر سرور شما چند نمونه دارد یا ریاستارت میشود، همین ساختار را در پایگاهداده یا Redis بگذارید و کد منطق همان میماند. تابع sendSms جانشین است و هیچ شرکتی را نشان نمیدهد.
ارسال واقعی را باید طبق مستندات شرکت پیامکی بنویسید. یک خط تعریف کلی از شکل آن را در ورود با موبایل php هم میبینید.
import { randomInt, createHmac, timingSafeEqual, randomBytes } from 'node:crypto'
// کلید مخفی چکیده؛ از متغیر محیطی بخوانید و در مخزن کد نگذارید
const SECRET = process.env.OTP_SECRET ?? 'CHANGE_ME_LONG_RANDOM_STRING'
const CODE_TTL = 3 * 60 * 1000 // اعتبار کد: سه دقیقه
const MAX_ATTEMPTS = 5 // حداکثر تلاش اشتباه
const COOLDOWN = 60 * 1000 // فاصلهی دو ارسال برای یک شماره
const MAX_PER_HOUR = 5 // سقف ارسال در ساعت
// ذخیرهی نمونه در حافظه: شماره ← { hash, expiresAt, attempts, lastSent, windowStart, sendCount }
const codes = new Map()
const users = new Map() // شماره ← شناسهی کاربر
const sessions = new Map() // شناسهی نشست ← شناسهی کاربر
// جانشین: ارسال واقعی را طبق مستندات سرویسدهندهی خودتان بنویسید
async function sendSms(phone, text) {
console.log('[DEV] SMS to', phone, text) // فقط برای آزمایش؛ در تولید حذفش کنید
}
// شماره را به قالب 09xxxxxxxxx برمیگرداند؛ در غیر این صورت null
export function normalizePhone(raw) {
const fa = '۰۱۲۳۴۵۶۷۸۹'
let d = String(raw).replace(/[۰-۹]/g, (c) => fa.indexOf(c)).replace(/\D+/g, '')
if (d.startsWith('98')) d = '0' + d.slice(2)
return /^09\d{9}$/.test(d) ? d : null
}
const hashCode = (phone, code) => createHmac('sha256', SECRET).update(phone + ':' + code).digest()
// خروجی: 'sent' | 'invalid' | 'wait' | 'limit'
export async function requestCode(rawPhone) {
const phone = normalizePhone(rawPhone)
if (!phone) return 'invalid'
const now = Date.now()
const row = codes.get(phone)
let sendCount = 1
let windowStart = now
if (row) {
if (now - row.lastSent < COOLDOWN) return 'wait' // فاصلهی ارسال دوباره
if (now - row.windowStart < 3600_000) {
if (row.sendCount >= MAX_PER_HOUR) return 'limit' // سقف ساعتی
sendCount = row.sendCount + 1
windowStart = row.windowStart
}
}
// شش رقم با مولد امن؛ صفرهای ابتدایی حفظ میشوند
const code = String(randomInt(0, 1_000_000)).padStart(6, '0')
// با ذخیرهی مقدار تازه، کد قبلی همین شماره باطل و شمارندهی تلاش صفر میشود
codes.set(phone, { hash: hashCode(phone, code), expiresAt: now + CODE_TTL, attempts: 0, lastSent: now, windowStart, sendCount })
await sendSms(phone, 'کد ورود: ' + code + '\nاین کد را به هیچکس ندهید.')
return 'sent'
}
// خروجی: { status: 'ok', sessionId } | { status: 'invalid' | 'expired' | 'locked' }
export function verifyCode(rawPhone, input) {
const phone = normalizePhone(rawPhone)
if (!phone || !/^\d{6}$/.test(String(input))) return { status: 'invalid' }
const row = codes.get(phone)
if (!row || row.expiresAt < Date.now()) return { status: 'expired' }
row.attempts += 1 // تلاش را پیش از مقایسه میشماریم
if (row.attempts > MAX_ATTEMPTS) { // بیش از سقف: کد سوخته است
codes.delete(phone)
return { status: 'locked' }
}
// مقایسهی بدون نشت زمان؛ هر دو چکیده همطولاند
if (!timingSafeEqual(row.hash, hashCode(phone, String(input)))) return { status: 'invalid' }
codes.delete(phone) // یکبارمصرف
// کاربر را پیدا کن یا بساز
if (!users.has(phone)) users.set(phone, users.size + 1)
const sessionId = randomBytes(32).toString('hex') // شناسهی نشست تازه
sessions.set(sessionId, users.get(phone))
return { status: 'ok', sessionId }
}
export const sessionUser = (id) => sessions.get(id)چون Node تکرشتهای است و verifyCode هیچ await ندارد، بین خواندن و نوشتن شمارنده فاصلهای نیست که درخواست دیگری وارد شود. اگر ذخیره را به پایگاهداده ببرید، افزایش شمارنده را باید در خود پایگاه و با یک دستور اتمی انجام دهید، نه خواندن و نوشتن جدا.
لاگین با موبایل node js روی یک سرور ساده
این هم سروری که دو تابع بالا را به یک API کوچک تبدیل میکند. فقط از ماژول http استفاده شده است. اگر Express دارید، بدنهی هر if مستقیماً در یک app.post میرود.
import http from 'node:http'
import { requestCode, verifyCode } from './otp.mjs'
// بدنهی JSON را میخواند؛ بدنهی بزرگ را رد میکند
const readJson = (req) => new Promise((resolve, reject) => {
let raw = ''
req.on('data', (c) => { raw += c; if (raw.length > 2048) { reject(new Error('too large')); req.destroy() } })
req.on('end', () => { try { resolve(JSON.parse(raw || '{}')) } catch { reject(new Error('bad json')) } })
})
const send = (res, code, body, headers = {}) => {
res.writeHead(code, { 'Content-Type': 'application/json; charset=utf-8', ...headers })
res.end(JSON.stringify(body))
}
http.createServer(async (req, res) => {
if (req.method !== 'POST') return send(res, 405, { status: 'method_not_allowed' })
let body
try { body = await readJson(req) } catch { return send(res, 400, { status: 'bad_request' }) }
if (req.url === '/otp/request') {
// پیام ثابت میدهیم تا ربات نفهمد کدام شماره عضو سایت است
return send(res, 200, { status: await requestCode(body.phone) })
}
if (req.url === '/otp/verify') {
const r = verifyCode(body.phone, body.code)
if (r.status !== 'ok') return send(res, 200, { status: r.status })
// کوکی نشست: HttpOnly و SameSite؛ در HTTPS مقدار Secure را هم اضافه کنید
return send(res, 200, { status: 'ok' }, {
'Set-Cookie': `sid=${r.sessionId}; HttpOnly; SameSite=Lax; Path=/; Max-Age=86400`,
})
}
send(res, 404, { status: 'not_found' })
}).listen(3000)پیش از انتشار، سقف درخواست بر پایهی IP را جلوی همین مسیرها بگذارید؛ نمونهی ما فقط سقف شماره را دارد و مهاجم میتواند شماره عوض کند. روشهای لایهبندی این سقفها را در جلوگیری از sms bombing بخوانید.
ورود با شماره موبایل در node؛ از درخواست تا کوکی
پیش از رفتن سراغ اشتباهها، یک بار کل مسیر یک ورود را از دید سرور مرور کنیم. این نقشه کمک میکند هر تابع را در جای درستش ببینید.
- ۱
فرم شماره
کاربر شماره را میدهد. مرورگر آن را به مسیر درخواست کد میفرستد.
- ۲
اعتبارسنجی و سقف
سرور شماره را نرمال میکند، فاصلهی ارسال و سقف ساعتی را میسنجد و در صورت رد، بدون ساختن کد پاسخ میدهد.
- ۳
ساخت و ذخیره
کد با randomInt ساخته میشود و فقط چکیدهی کلیددار آن، همراه انقضا و شمارندهی صفر، ذخیره میشود.
- ۴
ارسال پیامک
تابع sendSms کد را میفرستد. خطای ارسال را ثبت کنید ولی جزئیاتش را به کاربر نشان ندهید.
- ۵
فرم کد
کاربر کد را وارد میکند. سرور انقضا، سقف تلاش و برابری چکیدهها را میسنجد.
- ۶
نشست
در صورت موفقیت کد حذف میشود، شناسهی نشست تازه ساخته میشود و در کوکی HttpOnly به مرورگر میرسد.
لاگین با موبایل node js همین شش قدم است. هر چیز دیگری، از ظاهر فرم تا حسابداری پیامک، به آن اضافه میشود ولی جایگزینش نمیشود.
وقتی سرور شما بیش از یک نمونه دارد
نمونهی ما با یک پردازش کار میکند. در سرور واقعی معمولاً چند پردازش یا چند ماشین دارید و باید چند چیز عوض شود. این فهرست همانهاست.
- ذخیرهی مشترک Map را با Redis یا پایگاهداده عوض کنید تا درخواست کد و بررسی آن، هر کدام به هر نمونهای که رسیدند، یک داده را ببینند.
- انقضای خودکار در Redis برای هر کلید زمان انقضا بگذارید تا پاکسازی دستی لازم نباشد.
- افزایش اتمی شمارنده شمارندهی تلاش را با دستور افزایش خود ذخیرهگاه بالا ببرید، نه با خواندن و نوشتن جدا در کد.
- نشست مشترک شناسهی نشست هم باید در ذخیرهگاه مشترک باشد، وگرنه کاربر با درخواست بعدی از حساب خارج میشود.
- پشت پروکسی اگر پشت nginx یا CDN هستید، IP واقعی را از هدر مطمئن بخوانید و فقط از پروکسی خودتان بپذیرید، نه از هر درخواستی.
- زمانسنج پیامک تماس با وب سرویس پیامک زمانسنج داشته باشد تا کندی سرویسدهنده درگاه ورود شما را نخواباند.
کی otp node js را خودتان بنویسید؟
نوشتن کد یکبارمصرف با crypto در Node سریع انجام میشود، ولی نگهداشتن آن در طول سالها کار است. تصمیم را با این دو ستون بسنجید.
خودتان بنویسید وقتی
- ورود شما منطق خاصی دارد، مثل چند نقش یا ادغام با سیستم داخلی.
- همهی کاربران باید بتوانند فقط با شماره و پیامک وارد شوند.
- تیم شما پایش، سقف و ثبت خطا را نگه میدارد.
لازم نیست بنویسید وقتی
- هدف فقط این است که کاربر بدون رمز وارد شود و شمارهی تأییدشدهاش را بگیرید.
- نمیخواهید برای هر ورود هزینهی پیامک بدهید.
- میخواهید سقفها، انقضا و هشدار سوءاستفاده را کس دیگری نگه دارد.
در بسیاری از پروژهها ترکیب هر دو بهترین است: ورود پیامکی برای همه، دکمهی فینگت برای کاربرانی که اپ دارند. برای محاسبهی هزینهی پیامک ورود، هزینه پیامک سایت روش حساب را شرح داده است.
اشتباههای رایج در otp در node.js
نمونهی کوتاه شده است تا خوانا بماند. این اشتباهها همانهاییاند که در پروژههای واقعی بیشتر میبینیم.
Math.random برای کد
خروجیاش قابل پیشبینی است. برای هر کدی که امنیت به آن تکیه دارد از crypto.randomInt استفاده کنید.
مقایسهی سادهی رشتهها
مقایسه با === روی چکیدهها زمان پاسخ را کمی وابسته به نتیجه میکند. timingSafeEqual این نشت را ندارد.
ذخیرهی کد خام یا چکیدهی ساده
کد ششرقمی فقط یک میلیون حالت دارد و هر چکیدهی بیکلید بهسرعت شکسته میشود. چکیدهی کلیددار با کلید مخفی سرور این را سختتر میکند.
نگه داشتن وضعیت فقط در حافظهی یک پردازش
اگر چند نمونهی سرور دارید، درخواست کد ممکن است به یکی و بررسی به دیگری برسد. حافظهی مشترک مثل Redis یا پایگاهداده لازم است.
پیامهای متفاوت برای شمارهی ثبتشده و نشده
مهاجم از تفاوت پیامها فهرست کاربران را بیرون میکشد. در درخواست کد، پاسخ را ثابت نگه دارید.
باطل نکردن کد پس از موفقیت
کد درست باید همان لحظه حذف شود. در غیر این صورت تا انقضا قابل استفادهی دوباره است.
ریختن کد در لاگ
خط console.log نمونه فقط برای آزمایش است. در تولید کد و شمارهی کامل را در لاگ نگذارید.
فراموش کردن پاکسازی
ورودیهای منقضی در Map یا جدول جمع میشوند. یک زمانبند ساده که هر چند دقیقه ورودیهای منقضی را حذف کند کافی است.
بعد از ورود موفق؛ نشست را چطور سالم نگه داریم؟
خیلی از پروژهها کد را درست میسازند ولی نشست را سهلانگارانه نگه میدارند. اگر شناسهی نشست لو برود، همهی زحمت otp node js بیاثر میشود. این موارد را بررسی کنید.
شناسهی تصادفی بلند
در نمونه از randomBytes با سیودو بایت استفاده شد. شناسهی کوتاه یا قابلحدس، مثل شمارهی ردیف، را هرگز به عنوان نشست نپذیرید.
کوکی HttpOnly
با این ویژگی، جاوااسکریپت صفحه به کوکی دسترسی ندارد و اگر کسی به سایت شما اسکریپت تزریق کند، نشست را نمیدزدد.
Secure و SameSite
در HTTPS ویژگی Secure را اضافه کنید تا کوکی از مسیر ناامن نرود. SameSite هم جلوی ارسال خودکار کوکی از سایتهای دیگر را میگیرد.
مدت محدود
نشستها را عمر محدود بدهید، مثلاً یک روز یا چند روز، و هنگام خروج کاربر سمت سرور هم حذف کنید.
نشست تازه بعد از ورود
همیشه بعد از موفقیت شناسهی جدید بسازید؛ شناسهی قبل از ورود را به حساب واردشده تبدیل نکنید.
عملیات حساس
تغییر شماره یا حذف حساب را دوباره با یک کد تازه تأیید کنید، نه فقط با نشست باز.
کد یکبارمصرف با crypto را چطور آزمایش کنیم؟
پیش از وصل کردن به پیامک واقعی، منطق را با خروجی کنسول بیازمایید. هر قدم یک رفتار مشخص را امتحان میکند.
درخواست و ورود درست
یک شماره بدهید، کد را از کنسول بخوانید و ورود را امتحان کنید. باید وضعیت ok بگیرید و بار دوم با همان کد رد شوید.
شش بار کد اشتباه
بار ششم باید وضعیت locked بدهد و حتی کد درست هم دیگر کار نکند.
صبر تا انقضا
برای آزمایش، CODE_TTL را موقتاً پنج ثانیه کنید. کد درست بعد از پنج ثانیه باید expired بدهد.
ارسال پشتسرهم
دو درخواست کد پشتسرهم، دومی را wait میدهد. پس از شش بار ارسال با فاصله، ششمی باید limit بدهد.
شمارهی فارسی
شمارهای مثل ۰۹۱۲… باید بدون خطا نرمال شود و همان کد را بدهد.
اتصال واقعی
در پایان sendSms را به سرویسدهنده وصل کنید و رسیدن پیامک را بسنجید. اگر نرسید، کد تایید نمیاد را ببینید.
ورود با فینگت؛ همین کار بدون ساخت و نگهداری آن
چیزی که در این صفحه ساختیم باید نگهداری شود: ذخیرهسازی مشترک، سقفها، هزینهی هر پیامک و پاسخگویی به کاربری که کدش نرسیده است. اگر فقط میخواهید کاربر وارد شود، راه کوتاهتری هم هست.
در ورود با فینگت، سایت شما کاربر را به finget.ir میفرستد، کاربر ورود را در اپ فینگت تأیید میکند و مرورگرش با یک کد کوتاهعمر، حدود دو دقیقه، به آدرس بازگشت سایت برمیگردد. سرور شما همان کد را با یک درخواست POST تبدیل به اطلاعات کاربر میکند. نام، شمارهی موبایل تأییدشده و یک شناسهی ثابت برای همین سایت دریافت میکنید. شمارهی کاربر فقط یک بار، هنگام ثبتنام در اپ، با پیامک تأیید شده است.
نمونهی ورود با فینگت در Node.js
نمونهی زیر از fetch خود Node استفاده میکند. SITE_ID و کلید API را از پنل سرویسدهندگان میگیرید و آدرس بازگشت را هم همانجا ثبت میکنید. state را برای هر درخواست تازه میسازید و در نشست نگه میدارید تا بعد از بازگشت با آنچه خودتان فرستادهاید مقایسه کنید.
import { randomBytes, timingSafeEqual } from 'node:crypto'
// ۱) ساخت لینک ورود؛ state را در نشست کاربر نگه دارید
export function loginUrl(session) {
session.fgState = randomBytes(16).toString('hex') // مقدار تصادفی برای جلوگیری از درخواست جعلی
return 'https://finget.ir/auth?client_id=SITE_ID&state=' + session.fgState
}
// ۲) آدرس بازگشت: کد کوتاهعمر را به اطلاعات کاربر تبدیل کنید
export async function handleCallback(session, query) {
const a = Buffer.from(String(session.fgState ?? ''))
const b = Buffer.from(String(query.state ?? ''))
if (a.length === 0 || a.length !== b.length || !timingSafeEqual(a, b)) throw new Error('state نامعتبر')
delete session.fgState
const res = await fetch('https://finget.ir/api/v1/auth/token', {
method: 'POST',
headers: { 'Content-Type': 'application/json', Authorization: 'Bearer ' + process.env.FINGET_API_KEY },
body: JSON.stringify({ code: String(query.code ?? '') }),
signal: AbortSignal.timeout(8000), // بدون زمانسنج، قطعی شبکه ورود را هم میخواباند
})
if (!res.ok) throw new Error('کد نامعتبر یا منقضی')
const { user, isNew } = await res.json()
// user شامل id (مثل fgu_...)، name و phone است؛ isNew میگوید کاربر برای سایت تازه است
return { id: user.id, name: user.name, phone: user.phone, isNew } // با id ثابت کاربر را پیدا یا بسازید
}در این کد نه sendSms هست، نه جدول کد، نه شمارندهی تلاش. شناسهی fgu برای هر کاربر در سایت شما ثابت میماند. کلید API را فقط در سرور نگه دارید. اپ فعلاً برای اندروید است، پس فرم پیامکی خودتان برای بقیهی کاربران میماند و دکمهی فینگت کنارش اضافه میشود.
ثبتنام صاحبان سایت و اتصال سایت رایگان است؛ از صفحهی دانلود اپ را ببینید. نمونهی PHP همین منطق در ورود با موبایل php آمده و برای مرور شکل کلی روش، ورود بدون رمز عبور را بخوانید.
پرسشهای متداول درباره otp node js
برای otp node js به کتابخانهی خارجی نیاز دارم؟
نه. crypto برای ساخت کد، چکیده و مقایسهی امن و fetch برای تماس با وب سرویسها در خود Node هست. فقط برای ذخیرهسازی مشترک، مثل Redis یا پایگاهداده، درایور لازم دارید.
فرق crypto.randomInt با Math.random چیست؟
randomInt از منبع تصادفی امن سیستمعامل میخواند و برای امنیت ساخته شده است. Math.random خروجی قابل پیشبینی دارد و نباید برای کد ورود به کار برود.
Map در حافظه برای تولید کافی است؟
فقط برای آزمایش. با ریاستارت سرور دادهها میروند و با چند نمونهی سرور وضعیت بین آنها مشترک نیست. در تولید از Redis یا پایگاهداده استفاده کنید و افزایش شمارنده را در خود آن انجام دهید.
sendSms را چطور بنویسم؟
نمونهی ما عمداً فقط یک جانشین است. آدرس، نام فیلدها و کدهای خطا را مستندات شرکت پیامکیتان تعیین میکند. ساختار کلی تابع و نکتهی زمانسنج در صفحهی وب سرویس پیامک آمده است.
چرا state را در ورود فینگت میسازیم؟
تا مطمئن شوید بازگشتی که به آدرس شما رسیده از درخواستی است که همین کاربر شروع کرده است. مقدار را تصادفی بسازید، در نشست نگه دارید و در بازگشت مقایسه کنید.
کد فینگت چقدر اعتبار دارد؟
کوتاهعمر است، حدود دو دقیقه، و یک بار قابل استفاده است. سرور شما باید بلافاصله بعد از بازگشت آن را با کلید API تبدیل کند.
این روش کاربران بدون اپ فینگت را هم پوشش میدهد؟
نه. اپ فعلاً برای اندروید است و کاربر باید آن را داشته باشد. پس معمولاً دکمهی فینگت را کنار ورود پیامکی میگذارند و هر کاربر راه خودش را انتخاب میکند.