Ограничение частоты входов
Часть раздела Аутентификация и безопасность путешествия по Node.js на Coddy. Урок 23 из 24.
Скрипт может проверять тысячи паролей в минуту для одной учётной записи. Подсчитывайте неудачные попытки входа для каждого имени пользователя и после пяти попыток за минуту отказывайтесь проверять новые, пока не закончится минута.
Статус 429 «Слишком много запросов» объясняет причину отказа, а заголовок Retry-After указывает, сколько секунд нужно подождать. Подсчитывайте только неудачные попытки: человек, который ввёл правильный пароль, ни в коем случае не должен блокировать себе доступ. В Map значения хранятся по ключам: map.get(key) считывает значение, а map.set(key, value) записывает его. Данные хранятся в памяти — этого достаточно для одного сервера, — и очищаются при перезапуске сервера. В этом примере разрешено отправлять одно письмо для сброса пароля в минуту, поэтому хранится только время. При входе подсчитываются неудачные попытки, поэтому в записи хранятся и счётчик, и время.
const lastSent = new Map();
app.post('/reset', (req, res) => {
const email = String(req.body.email ?? '').toLowerCase();
const wait = (lastSent.get(email) ?? 0) + 60_000 - Date.now();
if (wait > 0) {
res.set('Retry-After', String(Math.ceil(wait / 1000)));
return res.status(429).json({ error: 'One reset email a minute' });
}
lastSent.set(email, Date.now());
// ... отправить письмо
});В этой учебной версии подсчитываются завершённые неудачные попытки в одном процессе сервера. Параллельные запросы могут превысить установленный лимит, пока выполняется проверка паролей; ограничитель для промышленной среды должен учитывать попытку до проверки пароля и хранить счётчики в хранилище, общем для всех серверов.
Задание
ЛегкоНа этом шаге открывается подготовленный для курса проект API приватных заметок, а не файлы проекта из урока Security Headers (включая server.js). Ваша предыдущая работа остаётся в своём уроке. Прочитайте предоставленные файлы, прежде чем редактировать server.js. Эта копия содержит фильтры владельцев приватных заметок, проверки ролей и заголовки безопасности.
Скрипт может перебирать тысячи паролей в минуту для одной учётной записи. Замедлите его: после 5 неправильных паролей для одного имени пользователя в течение минуты перестаньте проверять пароли для этого имени, пока минута не истечёт.
- В
server.js, передPOST /login, храните вMapзаписи о неудачных попытках входа для каждого имени пользователя. Для каждого имени храните количество неудачных попыток и время первой из них. - В
POST /login, прежде чем проверять пароль, найдите запись для имени пользователя. Запись, для которой с момента первой неудачной попытки прошла минута или больше, считается отсутствующей. Когда для имени набралось 5 неудачных попыток в течение минуты, отправьте ответ со статусом 429 и{"error": "Too many failed logins. Try again later."}. Сделайте это, даже если пароль верный. 429 Too Many Requests означает «сбавьте темп». - При ответе 429 установите заголовок
Retry-Afterв целое число секунд, оставшихся до истечения минуты с момента первой неудачной попытки, напримерRetry-After: 42. - Если пароль неправильный, увеличьте количество неудачных попыток для этого имени пользователя на 1, затем отправьте обычный ответ 401. Первая неудачная попытка или первая попытка после устаревшей записи начинает новый отсчёт с 1 и текущим временем.
- Никогда не учитывайте успешный вход. Неудачные попытки для одного имени пользователя никогда не ограничивают другое имя.
Попробуйте: нажмите Run.
- Отправьте
POST /signupс{"username": "ada", "password": "correct horse"}. - Пять раз отправьте
POST /loginс{"username": "ada", "password": "guess"}: каждый раз статус 401. - Отправьте запрос в шестой раз: статус 429. На вкладке Headers отображается
Retry-Afterсо значением в секундах, не превышающим 60. - Отправьте правильный пароль,
{"username": "ada", "password": "correct horse"}: по-прежнему статус 429. - Отправьте
POST /signup, а затемPOST /loginс{"username": "bob", "password": "correct horse"}: статус 200, потому что ограничение действует только для ada. Через минуту ada снова сможет войти.
Попробуйте сами
import express from 'express';
import { ObjectId } from 'mongodb';
import { randomBytes } from 'node:crypto';
import { parseCookies } from './cookies.js';
import { notes, sessions, users } from './db.js';
import { hashPassword, verifyPassword } from './passwords.js';
const app = express();
app.disable('x-powered-by');
app.use(express.json());
// Заголовки, которые предписывают браузеру осторожно обрабатывать каждый ответ.
app.use((req, res, next) => {
res.set({
'X-Content-Type-Options': 'nosniff',
'Referrer-Policy': 'no-referrer',
'Content-Security-Policy': "default-src 'self'",
});
next();
});
// Единственная учётная запись администратора. Её пароль берётся из переменных окружения.
await users.insertOne({ username: 'admin', role: 'admin', passwordHash: await hashPassword(process.env.ADMIN_PASSWORD) });
app.post('/signup', async (req, res) => {
const username = String(req.body.username ?? '').trim().toLowerCase();
const password = String(req.body.password ?? '');
if (!username || password.length < 8) {
return res.status(400).json({ error: 'Pick a username and a password of at least 8 characters' });
}
if (await users.findOne({ username })) {
return res.status(409).json({ error: 'That username is taken' });
}
await users.insertOne({ username, role: 'member', passwordHash: await hashPassword(password) });
res.status(201).json({ username });
});
app.post('/login', async (req, res) => {
const username = String(req.body.username ?? '').trim().toLowerCase();
const user = await users.findOne({ username });
if (!user || !(await verifyPassword(String(req.body.password ?? ''), user.passwordHash))) {
return res.status(401).json({ error: 'Wrong username or password' });
}
const sid = randomBytes(24).toString('base64url');
await sessions.insertOne({ _id: sid, userId: user._id, createdAt: new Date() });
res.cookie('sid', sid, {
httpOnly: true,
sameSite: 'lax',
secure: true,
maxAge: 24 * 60 * 60 * 1000,
});
res.json({ username: user.username });
});
// Находит пользователя по cookie сеанса или возвращает ответ 401.
async function requireUser(req, res, next) {
const { sid } = parseCookies(req.get('cookie'));
const session = sid && (await sessions.findOne({ _id: sid }));
const user = session && (await users.findOne({ _id: session.userId }));
if (!user) {
return res.status(401).json({ error: 'Log in first' });
}
req.user = { id: user._id.toHexString(), username: user.username, role: user.role };
next();
}
// Возвращает ответ 403, если у вошедшего пользователя нет этой роли.
function requireRole(role) {
return (req, res, next) => {
if (req.user.role !== role) {
return res.status(403).json({ error: 'Not allowed' });
}
next();
};
}
app.get('/me', requireUser, (req, res) => {
res.json({ username: req.user.username });
});
app.post('/logout', async (req, res) => {
const { sid } = parseCookies(req.get('cookie'));
if (sid) {
await sessions.deleteOne({ _id: sid });
}
res.clearCookie('sid');
res.status(204).end();
});
// Ваши заметки в виде страницы.
app.get('/', requireUser, async (req, res) => {
const list = await notes.find({ owner: req.user.id }).toArray();
const items = list.map((note) => `<li>${note.text}</li>`).join('');
res.send(`<!doctype html><title>Vault</title><h1>${req.user.username}'s notes</h1><ul>${items}</ul>`);
});
// Заметки: каждый пользователь читает и записывает только свои.
app.get('/notes', requireUser, async (req, res) => {
res.json(await notes.find({ owner: req.user.id }).toArray());
});
app.post('/notes', requireUser, async (req, res) => {
const note = { owner: req.user.id, text: String(req.body.text ?? '') };
await notes.insertOne(note);
res.status(201).json(note);
});
app.get('/notes/:id', requireUser, async (req, res) => {
if (!ObjectId.isValid(req.params.id)) {
return res.status(404).json({ error: 'Note not found' });
}
const note = await notes.findOne({ _id: new ObjectId(req.params.id), owner: req.user.id });
if (!note) {
return res.status(404).json({ error: 'Note not found' });
}
res.json(note);
});
app.delete('/notes/:id', requireUser, async (req, res) => {
if (!ObjectId.isValid(req.params.id)) {
return res.status(404).json({ error: 'Note not found' });
}
const { deletedCount } = await notes.deleteOne({ _id: new ObjectId(req.params.id), owner: req.user.id });
if (!deletedCount) {
return res.status(404).json({ error: 'Note not found' });
}
res.status(204).end();
});
// Для администраторов: сколько всего учётных записей.
app.get('/admin', requireUser, requireRole('admin'), async (req, res) => {
res.json({ users: await users.countDocuments() });
});
app.listen(3000, () => {
console.log('Vault is running on port 3000');
});
Все уроки раздела Аутентификация и безопасность
1Пароли
Байты и шестнадцатеричный текстПолучение ключа пароляНовая сольНикогда не храните паролиСравнение байтов ключаПроверка пароляПравила регистрации4Владельцы и безопасность
Только ваши заметкиРоли администратораПотренируйтесь самостоятельно: Песочница Express