Menu
CoddyTech

Ograniczanie częstotliwości logowania

Część sekcji Uwierzytelnianie i bezpieczeństwo ścieżki Node.js w Coddy. Lekcja 23 z 24.

Skrypt może w ciągu minuty sprawdzić tysiące haseł dla jednego konta. Zliczaj nieudane logowania według nazwy użytkownika, a gdy w ciągu minuty będzie ich pięć, odmawiaj kolejnych prób aż do końca tej minuty.

Status 429 Too Many Requests wyjaśnia przyczynę, a nagłówek Retry-After określa, ile sekund należy odczekać. Zliczaj tylko nieudane próby: osoba, która wpisze prawidłowe hasło, nigdy nie powinna zablokować sobie dostępu. Map przechowuje wartości pod kluczami: map.get(key) odczytuje wartość, a map.set(key, value) ją zapisuje. Dane są przechowywane w pamięci, co wystarcza w przypadku jednego serwera, i znikają po jego ponownym uruchomieniu. Ten przykład pozwala wysłać jeden e-mail do resetowania hasła na minutę, więc przechowuje tylko czas. Twój mechanizm logowania zlicza nieudane próby, więc jego rejestr przechowuje liczbę prób i czas.

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());
    // ... wyślij wiadomość e-mail
});

Ta wersja edukacyjna zlicza zakończone nieudane próby w jednym procesie serwera. Równoczesne żądania mogą przekroczyć limit, gdy trwa sprawdzanie haseł; mechanizm ograniczania liczby prób w środowisku produkcyjnym musi zliczać próbę przed sprawdzeniem hasła i przechowywać liczniki w magazynie współdzielonym przez wszystkie serwery.

challenge icon

Wyzwanie

Łatwy

Ten krok otwiera przygotowany projekt API prywatnych notatek kursu, a nie pliki Twojego projektu z lekcji Security Headers (w tym server.js). Twoja wcześniejsza praca pozostaje w swojej lekcji. Przed edycją server.js przeczytaj dostarczone pliki. Ta kopia zawiera filtry właściciela prywatnych notatek, kontrole ról i nagłówki bezpieczeństwa.

Skrypt może próbować tysięcy haseł na minutę dla jednego konta. Ogranicz te próby: po 5 błędnych hasłach dla jednej nazwy użytkownika w ciągu minuty przestań sprawdzać hasła dla tej nazwy, aż minie minuta.

  1. W server.js, nad POST /login, zapisuj nieudane logowania dla każdej nazwy użytkownika w obiekcie Map. Dla każdej nazwy zapisuj liczbę nieudanych prób oraz czas pierwszej z nich.
  2. W POST /login, zanim sprawdzisz hasło, wyszukaj zapis dotyczący nazwy użytkownika. Zapis, którego pierwsza nieudana próba miała miejsce minutę temu lub wcześniej, traktuj tak, jakby go nie było. Gdy dla nazwy odnotowano 5 nieudanych prób w ciągu minuty, odpowiedz statusem 429 i {"error": "Too many failed logins. Try again later."}. Zrób to nawet wtedy, gdy hasło byłoby prawidłowe. 429 Too Many Requests oznacza „zwolnij”.
  3. W przypadku odpowiedzi 429 ustaw nagłówek Retry-After na całkowitą liczbę sekund pozostałych do upływu minuty od pierwszej nieudanej próby, na przykład Retry-After: 42.
  4. Gdy hasło jest błędne, dodaj 1 do liczby nieudanych prób dla danej nazwy użytkownika, a następnie odpowiedz zwykłym statusem 401. Pierwsza nieudana próba lub pierwsza po wygaśnięciu starego zapisu rozpoczyna nowy licznik od 1 i zapisuje bieżący czas.
  5. Nigdy nie zliczaj udanego logowania. Nieudane próby dla jednej nazwy użytkownika nigdy nie ograniczają innej nazwy.

Wypróbuj: Naciśnij „Uruchom”.

  • Wyślij POST /signup z {"username": "ada", "password": "correct horse"}.
  • Wyślij pięć razy POST /login z {"username": "ada", "password": "guess"}: za każdym razem otrzymasz status 401.
  • Wyślij żądanie po raz szósty: otrzymasz status 429. Karta Headers pokaże Retry-After z liczbą sekund nie większą niż 60.
  • Wyślij prawidłowe hasło, {"username": "ada", "password": "correct horse"}: nadal otrzymasz status 429.
  • Wyślij POST /signup, a następnie POST /login, z {"username": "bob", "password": "correct horse"}: otrzymasz status 200, ponieważ ograniczenie dotyczy tylko ady. Po minucie ada znów będzie mogła się zalogować.

Spróbuj swoich sił

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());

// Nagłówki nakazujące przeglądarce ostrożnie traktować każdą odpowiedź.
app.use((req, res, next) => {
    res.set({
        'X-Content-Type-Options': 'nosniff',
        'Referrer-Policy': 'no-referrer',
        'Content-Security-Policy': "default-src 'self'",
    });
    next();
});

// Jedyne konto administratora. Jego hasło pochodzi ze środowiska.
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 });
});

// Znajduje użytkownika na podstawie ciasteczka sesyjnego albo zwraca 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();
}

// Zwraca 403, chyba że zalogowany użytkownik ma tę rolę.
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();
});

// Twoje notatki w formie strony.
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>`);
});

// Notatki: każdy użytkownik odczytuje i zapisuje tylko własne.
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();
});

// Dla administratorów: ile jest kont.
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');
});

Wszystkie lekcje w sekcji Uwierzytelnianie i bezpieczeństwo

Poćwicz samodzielnie: Edytor online Express