Content-Type, validate dữ liệu người dùng, dùng đúng header Authorization, tránh mã hoá phía client, và tận dụng API Gateway để gộp các lớp bảo vệ này lại một chỗ.
Bạn nghĩ API đã có xác thực (authentication) là an toàn? Chưa chắc. Kẻ tấn công không cần "bẻ" được mật khẩu của bạn nếu họ có thể lừa API chạy sai phương thức, gửi sai định dạng dữ liệu, hoặc nhét dữ liệu độc hại vào một trường tưởng chừng vô hại. Input chính là nơi họ thử đầu tiên, vì nó luôn mở, luôn nhận dữ liệu từ bên ngoài, và server không có cách nào biết chắc dữ liệu đó "sạch" hay không cho tới khi tự mình kiểm tra.
Đây là phần "Input" trong chuỗi bài về bảo mật API của tôi. Nếu bạn mới bắt đầu series này, có thể xem thêm các phần khác ở mục bài liên quan cuối trang.
Vì sao input luôn là cửa ngõ đầu tiên
Mọi request gửi tới API đều mang theo dữ liệu do bên ngoài cung cấp: URL, header, query string, body. Server không thể mặc định tin dữ liệu đó đúng định dạng, đúng kiểu người dùng mong muốn. Nếu bạn bỏ qua bước kiểm tra ở tầng input, bất kỳ chỗ nào xử lý dữ liệu đó sau này (bộ phân tích cú pháp, câu truy vấn cơ sở dữ liệu, lệnh hệ thống...) đều có thể bị lợi dụng. Nói cách khác: input là hàng rào đầu tiên, và hàng rào yếu thì mọi lớp phòng thủ phía sau đều phải gánh thêm rủi ro.
6 nguyên tắc bảo mật đầu vào cho API
1. Dùng đúng phương thức HTTP
Sử dụng phương thức HTTP phù hợp theo hoạt động: GET (đọc), POST (tạo), PUT/PATCH (thay thế/cập nhật), và DELETE (xoá một bản ghi). Trả về 405 Method Not Allowed nếu phương thức được gửi lên không phù hợp với tài nguyên đó.
Nghe đơn giản nhưng đây là hàng rào rẻ tiền và hiệu quả: nếu API chỉ định nghĩa route cho GET /orders/:id mà lại "lỡ" chấp nhận cả POST trên cùng route đó (do framework mặc định), bạn vô tình mở thêm một đường tấn công mà mình không kiểm soát.
2. Xác thực Content-Type
Kiểm tra header Content-Type của request để đảm bảo dữ liệu gửi lên đúng định dạng server mong đợi (ví dụ API chỉ nhận application/json thì từ chối các request gửi text/plain hay multipart/form-data không cần thiết). Việc này không "chặn XSS" một cách trực tiếp như nhiều tài liệu cũ hay nói, nhưng nó ngăn kẻ tấn công lừa bộ phân tích cú pháp (parser) của bạn xử lý sai kiểu dữ liệu, giảm nguy cơ tấn công chèn (injection) và tình trạng nhầm lẫn kiểu nội dung (content-type confusion) khi dữ liệu bị diễn giải sai định dạng.
app.use((req, res, next) => {
const needsBody = req.method === 'POST' || req.method === 'PUT';
const contentType = req.headers['content-type'] || '';
if (needsBody && !contentType.includes('application/json')) {
return res.status(415).json({ error: 'Unsupported Media Type' });
}
next();
});
3. Validate dữ liệu người dùng
Đầu vào người dùng là nguồn phổ biến nhất của lỗ hổng trong ứng dụng web, vì nó thường không được xác thực (validate), làm sạch (sanitize) hoặc thoát ký tự (escape) đúng cách trước khi đưa vào xử lý. Kẻ tấn công lợi dụng đúng chỗ hở đó: chèn câu lệnh SQL vào ô tìm kiếm, chèn script vào ô bình luận, hoặc gửi giá trị vượt giới hạn khiến logic nghiệp vụ chạy sai.
Nguyên tắc thực dụng: validate theo danh sách cho phép (allowlist) thay vì cố liệt kê mọi thứ cần chặn (denylist). Ví dụ với username, chỉ chấp nhận chữ, số và dấu gạch dưới:
const isValidUsername = (value) => /^[a-zA-Z0-9_]{3,20}$/.test(value);
if (!isValidUsername(req.body.username)) {
return res.status(400).json({ error: 'Username không hợp lệ' });
}
Đây là ví dụ đơn giản hoá để minh hoạ ý tưởng allowlist, thực tế bạn nên dùng thư viện validate (Joi, Zod, class-validator...) thay vì tự viết regex cho mọi trường dữ liệu.
4. Dùng đúng header Authorization
Gửi mã thông báo (token) xác thực qua header Authorization chuẩn, thay vì nhét vào tham số query string hoặc body tuỳ ý.
curl -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..." \
https://api.example.com/v1/orders
GET /orders?token=eyJhbGci.... Token trong query string sẽ nằm trong log truy cập, lịch sử trình duyệt, và bộ nhớ đệm (cache) của các proxy trung gian, tất cả đều là nơi bạn không kiểm soát được ai đọc được dữ liệu đó.Hãy hình dung header Authorization như việc bạn đưa thẻ ra vào cho bảo vệ kiểm tra riêng tại cửa, còn nhét token vào query string giống như hô to số thẻ giữa hành lang đông người, ai đứng gần cũng nghe và ghi lại được. Ngoài nguy cơ bị log/cache lộ token, gửi token qua query string hay body còn khiến request dễ bị lợi dụng trong tấn công giả mạo yêu cầu liên trang (CSRF): kẻ tấn công có thể dụ người dùng gửi một request kèm sẵn token của họ mà chính người dùng không hay biết. Header Authorization giúp server xác thực token ngay từ đầu, trước khi request được xử lý tiếp, và không bị các hệ thống trung gian vô tình ghi lại.
5. Tránh mã hoá phía client
Ưu tiên mã hoá phía máy chủ thay vì mã hoá phía máy khách (client-side). Mã nguồn chạy trên trình duyệt hoặc app di động luôn có thể bị đảo ngược kỹ thuật (reverse engineer), nghĩa là bất kỳ thuật toán hay khoá mã hoá nào bạn nhúng ở phía client đều có nguy cơ bị lộ. Việc mã hoá thật sự cần bảo mật (mật khẩu, dữ liệu nhạy cảm) nên luôn được xử lý ở server, nơi bạn kiểm soát được khoá và thuật toán.
6. Tận dụng API Gateway
API Gateway đóng vai trò như bảo vệ đứng ở cổng chung cư: thay vì để mỗi căn hộ (mỗi service) tự lắp khoá, tự kiểm tra khách ra vào, bạn đặt một điểm kiểm soát tập trung ngay từ cổng. Một số việc API Gateway có thể gánh thay các service riêng lẻ:
- Xác thực và uỷ quyền: xử lý xác minh JWT, OAuth và các cơ chế xác thực khác ở một chỗ, thay vì lặp lại logic này trong từng service.
- Giới hạn tốc độ (rate limiting) và lọc lưu lượng: chặn bớt tấn công từ chối dịch vụ phân tán (DDoS), brute force và các dạng lạm dụng khác trước khi chúng chạm tới service phía sau.
- Mã hoá và giải mã dữ liệu nhạy cảm khi đi qua gateway.
- Ghi log và giám sát tập trung lưu lượng API, giúp phát hiện bất thường sớm hơn.
- Tích hợp với các công cụ bảo mật khác như tường lửa ứng dụng web (WAF), hệ thống quản lý sự kiện bảo mật (SIEM).
Cạm bẫy thường gặp
- Chỉ validate ở phía client (trình duyệt/app) mà quên validate lại ở server. Client-side validation chỉ để trải nghiệm người dùng tốt hơn, không thay thế được kiểm tra ở server vì client hoàn toàn có thể bị bỏ qua.
- Dùng denylist (liệt kê ký tự/chuỗi cần chặn) thay vì allowlist. Bạn sẽ luôn thiếu trường hợp, trong khi allowlist mặc định từ chối mọi thứ không nằm trong danh sách cho phép.
- Tin tưởng Content-Type client gửi lên mà không có thêm lớp kiểm tra nào khác, một số client vẫn có thể giả mạo header này.
- Log token xác thực (kể cả khi nó nằm trong header) vào hệ thống logging chung mà không che (mask) đi.
Tóm tắt
- Ràng buộc đúng phương thức HTTP cho từng route, trả 405 khi sai.
- Xác thực Content-Type trước khi xử lý body, để giảm nguy cơ injection và nhầm lẫn kiểu dữ liệu.
- Validate input theo allowlist, không cố liệt kê mọi thứ cần chặn.
- Gửi token qua header Authorization chuẩn, không qua query string hay body.
- Mã hoá dữ liệu nhạy cảm ở phía server, không phụ thuộc vào mã nguồn phía client.
- Dùng API Gateway làm điểm kiểm soát tập trung cho xác thực, rate limiting và giám sát.
- Kai