Cross-site request forgery (CSRF hay XSRF — giả mạo request giữa các site) là một dạng tấn công mà các lệnh không được cho phép được gửi đi từ một user đáng tin cậy tới một web application. Để giúp ngăn chặn điều này, bạn có thể dùng package csrf-csrf.
Dùng với Express (mặc định)
Bắt đầu bằng việc cài package cần thiết:
$ npm i csrf-csrf
Cảnh báo Như đã ghi chú trong tài liệu của csrf-csrf, middleware này yêu cầu session middleware hoặc cookie-parser phải được khởi tạo trước đó. Vui lòng xem tài liệu để biết thêm chi tiết.
Sau khi cài xong, đăng ký middleware csrf-csrf như một global middleware.
import { doubleCsrf } from 'csrf-csrf';
// ...
// somewhere in your initialization file
const {
invalidCsrfTokenError, // This is provided purely for convenience if you plan on creating your own middleware.
generateToken, // Use this in your routes to generate and provide a CSRF hash, along with a token cookie and token.
validateRequest, // Also a convenience if you plan on making your own middleware.
doubleCsrfProtection, // This is the default CSRF protection middleware.
} = doubleCsrf(doubleCsrfOptions);
app.use(doubleCsrfProtection);
Dùng với Fastify
Bắt đầu bằng việc cài package cần thiết:
$ npm i --save @fastify/csrf-protection
Sau khi cài xong, đăng ký plugin @fastify/csrf-protection như sau:
import fastifyCsrf from '@fastify/csrf-protection';
// ...
// somewhere in your initialization file after registering some storage plugin
await app.register(fastifyCsrf);
Cảnh báo Như đã giải thích trong tài liệu của @fastify/csrf-protection tại đây, plugin này yêu cầu một storage plugin (plugin lưu trữ) phải được khởi tạo trước. Vui lòng xem tài liệu đó để biết thêm hướng dẫn.
Ghi chú người dịch Cơ chế “double submit cookie” mà csrf-csrf dùng hoạt động bằng cách so khớp token nằm trong cookie với token client gửi kèm request (qua header hoặc form field) — server không cần lưu token. Laravel (@csrf) và Rails (authenticity_token) mặc định dùng kiểu khác: token lưu trong session phía server rồi so với token trong form. Mục tiêu giống nhau (chặn request giả mạo từ site khác), chỉ khác nơi lưu token. Điểm dễ gây lỗi khi vibe-code: middleware này không thay thế session/cookie-parser, nó cần chạy sau middleware đó trong chuỗi xử lý, nếu không sẽ báo lỗi thiếu cookie ngay cả khi bạn đã cấu hình đúng.