Çerez Bayrakları

Coddy'nin Node.js Journey'sinin Kimlik Doğrulama ve Güvenlik bölümünün bir parçası. Ders 13 / 24.

Bayrakları olmayan bir çerez, şifrelenmemiş HTTP üzerinden gönderilir, diğer sitelerin tetiklediği isteklerle birlikte iletilir ve tarayıcı kapanana kadar varlığını sürdürür. res.cookie üzerindeki dört seçenek bunu daha güvenli hâle getirir:

httpOnly: sayfadaki betikler bunu okuyamaz.
sameSite: 'lax', kullanıcı bir bağlantıyı izlediği durumlar dışında, diğer sitelerin gönderdiği isteklerde çerezin yer almasını engeller; 'strict' bu durumlarda da yer almasını engeller.
secure: yalnızca HTTPS üzerinden gönderilir; ağdaki diğer kişilerin okuyabileceği şifrelenmemiş HTTP üzerinden asla gönderilmez.
maxAge: milisaniye cinsinden ne kadar süre varlığını sürdüreceği.

res.cookie('cart', cartId, {
    httpOnly: true,
    sameSite: 'strict',
    secure: true,
    maxAge: 30 * 60 * 1000, // 30 dakika
});

Görev

Kolay

sid çerezini sıkılaştır; böylece tarayıcılar onu yalnızca ait olduğu yerde gönderir ve bir gün sonra siler.

server.js dosyasında, POST /login içinde sid çerezine şu dört seçeneği ver:
- httpOnly; böylece sayfadaki betikler onu okuyamaz. Bu seçenek zaten var.
- sameSite değerini 'lax' olarak ayarla; böylece kullanıcı sitene giden bir bağlantıyı izlemediği sürece tarayıcı, diğer sitelerin başlattığı isteklere çerezi eklemez.
- secure; böylece çerez yalnızca HTTPS üzerinden gönderilir.
- Bir günlük maxAge. maxAge milisaniye cinsindendir ve başlıkta aynı süre saniye olarak gösterilir; bu nedenle bir gün Max-Age=86400 olarak görünür.
Oturum açma işlemi çalışmaya devam etmeli: POST /login sonrasında GET /me kullanıcıyı döndürür.

Dene: Çalıştır'a bas. Önce POST /signup, ardından POST /login isteğini gönder; ikisinde de {"username": "ada", "password": "correct horse"} kullan. Oturum açma yanıtının Başlıklar sekmesini aç. Set-Cookie şu şekilde görünür: sid=oqjRxvxmXl_nRwAwOLxgZyI2sYq9hZtN; Max-Age=86400; Path=/; Expires=Sat, 31 Oct 2026 12:00:00 GMT; HttpOnly; Secure; SameSite=Lax. GET /me isteğini gönder: {"username": "ada"}.

Kendin dene

import express from 'express';
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.use(express.json());

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, 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 });
    res.json({ username: user.username });
});

// Oturum çerezine ait kullanıcıyı bulur veya 401 yanıtı verir.
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 };
    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();
});

// Bu tarayıcının GET /visit isteğini kaç kez gönderdiğini sayar.
app.get('/visit', (req, res) => {
    const cookies = parseCookies(req.get('cookie'));
    const visits = Number(cookies.visits ?? 0) + 1;
    res.cookie('visits', String(visits));
    res.json({ visits });
});

// Notlar: Her kullanıcı yalnızca kendi notlarını okur ve yazar.
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.listen(3000, () => {
    console.log('Vault is running on port 3000');
});

Kendini test et

Bu ders kısa bir quiz içerir. Soruları yanıtlamak ve ilerlemeni kaydetmek için derse başla.

Kimlik Doğrulama ve Güvenlik bölümündeki tüm dersler

Kendi başına pratik yap: Express playground