Hoàn thành bài "Bài 5: Xác thực đầu vào và Xử lý lỗi" trước để mở khoá bài này.Đến bài trước

Giới thiệu

Middleware xác thực nằm giữa các request đến và route handlers của bạn, xác minh rằng người dùng đúng là người mà họ khai báo trước khi cấp quyền truy cập vào các tài nguyên được bảo vệ. Trong bài học này, bạn sẽ xây dựng middleware xác thực dựa trên JWT và áp dụng nó cho các routes cụ thể, biến API mở của bạn thành một hệ thống bảo mật, sẵn sàng cho production.

Các hàm middleware có quyền truy cập vào request object, response object, và hàm middleware tiếp theo trong stack. Middleware xác thực sẽ kiểm tra Authorization header, xác thực token, gắn thông tin người dùng vào request, và hoặc chuyển quyền điều khiển cho handler tiếp theo hoặc từ chối request.

Xây dựng Middleware Xác thực

Tạo một hàm middleware để trích xuất và xác minh các JWT token. Middleware kiểm tra Bearer token trong Authorization header, xác thực nó bằng secret key của bạn, và gắn payload đã giải mã vào request object để các handler phía sau sử dụng.

javascript
const jwt = require('jsonwebtoken');
const authenticate = (req, res, next) => {
const authHeader = req.headers.authorization;
if (!authHeader || !authHeader.startsWith('Bearer ')) {
return res.status(401).json({ error: 'No token provided' });
}
const token = authHeader.substring(7);
try {
const decoded = jwt.verify(token, process.env.JWT_SECRET);
req.user = decoded;
next();
} catch (error) {
return res.status(401).json({ error: 'Invalid or expired token' });
}
};
module.exports = authenticate;

Middleware trích xuất token bằng cách loại bỏ tiền tố Bearer, xác minh nó với secret của bạn, và lưu trữ dữ liệu người dùng đã giải mã vào `req.user`. Nếu xác minh thất bại, nó trả về status 401 mà không gọi `next`, dừng pipeline của request.

flowchart hiển thị request chảy qua middleware xác thực với hai nhánh - token hợp lệ tiếp tục đến route handler, token không hợp lệ trả về lỗi 401

Bảo vệ Routes bằng Middleware

Áp dụng middleware xác thực cho các routes yêu cầu xác định danh tính người dùng. Bạn có thể bảo vệ từng route riêng lẻ, nhóm routes, hoặc toàn bộ router bằng cách chèn middleware trước các hàm handler của bạn.

javascript
const express = require('express');
const authenticate = require('./middleware/authenticate');
const router = express.Router();
router.get('/profile', authenticate, (req, res) => {
res.json({
userId: req.user.id,
email: req.user.email,
message: 'This is your protected profile'
});
});
router.post('/posts', authenticate, async (req, res) => {
const post = await createPost({
...req.body,
authorId: req.user.id
});
res.status(201).json(post);
});
router.get('/public', (req, res) => {
res.json({ message: 'This endpoint is public' });
});

Middleware xác thực chạy trước route handler. Các route không có middleware sẽ vẫn truy cập công khai. Đối tượng req.user được middleware gán vào cho phép các handler truy cập vào danh tính của người dùng đã xác thực.

Kiểm soát truy cập dựa trên vai trò

Mở rộng middleware của bạn để xử lý phân quyền bằng cách kiểm tra vai trò hoặc quyền của người dùng. Tạo một hàm wrapper chấp nhận các vai trò yêu cầu và trả về middleware thực thi các yêu cầu đó.

javascript
const authorize = (...allowedRoles) => {
return (req, res, next) => {
if (!req.user) {
return res.status(401).json({ error: 'Authentication required' });
}
if (!allowedRoles.includes(req.user.role)) {
return res.status(403).json({ error: 'Insufficient permissions' });
}
next();
};
};
router.delete('/users/:id', authenticate, authorize('admin'), async (req, res) => {
await deleteUser(req.params.id);
res.status(204).send();
});
router.put('/posts/:id', authenticate, authorize('admin', 'editor'), async (req, res) => {
const post = await updatePost(req.params.id, req.body);
res.json(post);
});

Middleware authorize giả định rằng authenticate đã chạy trước đó và đã gắn req.user. Nó kiểm tra vai trò của người dùng so với các giá trị được phép và trả về 403 Forbidden nếu vai trò không khớp. Chuỗi nhiều hàm middleware lại với nhau để thực thi cả xác thực lẫn phân quyền.

Xử lý lỗi và làm mới token

Xử lý các tình huống xác thực phổ biến một cách hợp lý. Phân biệt giữa token bị thiếu, token không hợp lệ và token đã hết hạn để đưa ra phản hồi rõ ràng. Cân nhắc triển khai refresh token cho các phiên đăng nhập dài hạn.

javascript
const authenticate = (req, res, next) => {
const authHeader = req.headers.authorization;
if (!authHeader || !authHeader.startsWith('Bearer ')) {
return res.status(401).json({
error: 'No token provided',
code: 'TOKEN_MISSING'
});
}
const token = authHeader.substring(7);
try {
const decoded = jwt.verify(token, process.env.JWT_SECRET);
req.user = decoded;
next();
} catch (error) {
if (error.name === 'TokenExpiredError') {
return res.status(401).json({
error: 'Token expired',
code: 'TOKEN_EXPIRED'
});
}
return res.status(401).json({
error: 'Invalid token',
code: 'TOKEN_INVALID'
});
}
};

Các phản hồi lỗi có cấu trúc với mã lỗi giúp client xử lý đúng các chế độ thất bại khác nhau. Token hết hạn có thể kích hoạt luồng làm mới token, trong khi token không hợp lệ thì yêu cầu xác thực lại.

Tóm tắt

Middleware xác thực tập trung logic bảo mật và áp dụng nó một cách nhất quán trên toàn bộ API của bạn. Bằng cách trích xuất và xác minh JWT token, gắn thông tin người dùng vào request, và thực thi kiểm soát truy cập dựa trên vai trò, bạn biến các endpoint mở thành một hệ thống an toàn. Luôn chạy xác thực trước phân quyền, trả về các phản hồi lỗi rõ ràng, và cân nhắc chiến lược hết hạn cũng như làm mới token cho các triển khaiở môi trường production.

Luyện tập sau buổi học

Bài kiểm tra cuối bài

Ôn lại kiến thức, thử sức và nhận góp ý cho bài làm.

0/1
Đã trả lời · 0/1