👋 Chào mừng đến với Nocoem — kiến thức Backend, System Design và lập trình. Khám phá ngay

API Security Best Practices - Output

TL;DR: Kiểm tra đầu vào kỹ tới đâu cũng vô ích nếu response API của bạn tự "khai" thêm thông tin cho kẻ tấn công. Bài này gom 7 việc nên làm ở đầu ra: đặt đúng các header bảo mật (nosniff, X-Frame-Options, CSP), giấu dấu vết công nghệ, ép kiểu nội dung nhất quán, chỉ trả dữ liệu cần thiết và trả đúng mã trạng thái.

Bạn validate input cẩn thận, chặn SQL injection, lọc XSS ở đầu vào... rồi API vẫn để lộ chuyện dùng Express phiên bản nào qua header, hoặc trả nguyên object user (kèm cả password hash) chỉ vì "cho tiện". Bảo mật API không chỉ nằm ở cửa vào, mà còn ở chỗ bạn trả lời ra sao. Dưới đây là những việc nên làm với response để không tự bắn vào chân mình.

1. Chặn trình duyệt tự đoán kiểu file: X-Content-Type-Options

Gửi header X-Content-Type-Options: nosniff.

Giả sử người dùng upload một file thực chất là HTML/JS nhưng đặt tên avatar.jpg. Nếu server trả về đúng Content-Type: image/jpeg nhưng trình duyệt "không tin", nó tự mở file ra đọc nội dung thật rồi phát hiện đó là HTML, thì trình duyệt có thể tự ý render và thực thi nội dung đó như một trang HTML, mở đường cho tấn công chèn mã liên trang (XSS).

Header X-Content-Type-Options: nosniff yêu cầu trình duyệt tin tuyệt đối vào Content-Type mà server khai báo, không tự "đoán" (sniff) kiểu nội dung dựa trên bytes thực tế. Nhờ vậy, file HTML giả dạng ảnh vẫn chỉ được xử lý như ảnh, không bị thực thi như trang web.

2. Chặn nhúng trang trong iframe: X-Frame-Options

Gửi header X-Frame-Options: DENY.

Tấn công nhấp chuột ẩn (clickjacking) hoạt động bằng cách nhúng trang của bạn vào một <iframe> vô hình, đặt chồng lên một nút bấm giả trên trang của kẻ tấn công. Người dùng tưởng mình bấm nút "Xem thêm" nhưng thực ra đang bấm nút "Chuyển tiền" ẩn bên dưới.

Đặt X-Frame-Options: DENY báo trình duyệt: tuyệt đối không hiển thị trang này trong bất kỳ iframe nào, kể cả từ cùng domain. Nếu bạn cần cho phép nhúng từ chính domain mình thì dùng SAMEORIGIN thay vì DENY.

3. Khoá chặt nguồn tài nguyên: Content-Security-Policy

Gửi header Content-Security-Policy: default-src 'none'.

Chính sách bảo mật nội dung (Content Security Policy - CSP) là danh sách trắng các nguồn mà trình duyệt được phép tải script, ảnh, stylesheet... cho trang. Giá trị default-src 'none' là điểm khởi đầu chặt nhất: mặc định không cho tải bất kỳ tài nguyên nào, sau đó bạn mở dần từng loại (script-src 'self', img-src 'self'...) cho đúng nhu cầu thực tế.

Lợi ích rõ nhất: kể cả khi kẻ tấn công chèn được một đoạn <script> độc hại vào trang qua lỗ hổng XSS nào đó, trình duyệt vẫn từ chối chạy nó nếu script đó không nằm trong danh sách CSP cho phép.

4. Xoá dấu vết công nghệ

Bỏ các header nhận dạng framework/server (ví dụ X-Powered-By) khỏi response.

Các header kiểu X-Powered-By: Express hay Server: nginx/1.18.0 tự khai ra bạn đang chạy công nghệ gì, phiên bản nào. Kẻ tấn công có thể tra ngay CVE (lỗ hổng đã công bố) của đúng phiên bản đó rồi nhắm khai thác thẳng, thay vì phải dò mù.

Lưu ý: đây là "che dấu vết" (security through obscurity), giúp giảm bề mặt tấn công chứ không thay thế được việc vá lỗi và cập nhật phiên bản đầy đủ.

5. Ép buộc Content-Type nhất quán

Luôn đặt và kiểm tra header Content-Type đúng kiểu MIME thực tế của dữ liệu.

Content-Type là "lời khai" của dữ liệu bạn gửi đi: đây là JSON, đây là ảnh, đây là văn bản thuần. Nếu client và server hiểu sai kiểu nội dung (ví dụ server trả text thuần nhưng client parse như JSON), dữ liệu có thể bị phân tích sai cách, mở đường cho lỗi phân tích cú pháp mà kẻ tấn công lợi dụng được, hoặc bị giả mạo nội dung (content spoofing).

Ép buộc Content-Type đúng giúp cả hai phía "nói chung ngôn ngữ", và server có căn cứ để từ chối những request/response không đúng định dạng đã thoả thuận.

6. Tránh trả lại dữ liệu nhạy cảm

Chỉ trả về đúng dữ liệu mà client thực sự cần.

Trả nguyên object User lấy từ database (kèm password hash, token nội bộ, email nhân viên...) chỉ vì code cho gọn là thói quen rất phổ biến và cũng rất nguy hiểm. Càng lộ nhiều thông tin, bề mặt tấn công càng lớn: rò rỉ dữ liệu, dò thông tin để tấn công tiếp theo, hay đơn giản là vi phạm quy định bảo vệ dữ liệu cá nhân.

Cách làm đúng: định nghĩa rõ một "hình dạng" response (DTO/serializer) chỉ chứa field client cần, thay vì trả thẳng bản ghi database.

7. Trả đúng mã trạng thái HTTP

Trả về mã trạng thái đúng với kết quả thao tác, không "gói" mọi thứ vào 200 OK.
  • 200 OK - request thành công
  • 400 Bad Request - dữ liệu client gửi lên sai định dạng
  • 401 Unauthorized - chưa xác thực hoặc xác thực sai
  • 405 Method Not Allowed - method HTTP không được hỗ trợ cho endpoint đó

Nếu server luôn trả 200 OK ngay cả khi request thất bại (và nhét lỗi vào body), client rất dễ bỏ qua lỗi đó, tưởng thao tác thành công rồi tiếp tục xử lý dữ liệu rác hoặc hiển thị nhầm cho người dùng. Mã trạng thái đúng giúp client (và cả các công cụ giám sát) phản ứng đúng ngay từ tầng giao thức.

Ví dụ: gộp các header này vào một middleware

Với Express, bạn có thể gom hết vào một middleware chạy trước mọi route:

// security-headers.js
function securityHeaders(req, res, next) {
  res.setHeader('X-Content-Type-Options', 'nosniff');
  res.setHeader('X-Frame-Options', 'DENY');
  res.setHeader(
    'Content-Security-Policy',
    "default-src 'none'; script-src 'self'; img-src 'self'"
  );
  res.removeHeader('X-Powered-By'); // Express tự thêm header này mặc định

  next();
}

module.exports = securityHeaders;
// app.js
const express = require('express');
const securityHeaders = require('./security-headers');

const app = express();
app.use(securityHeaders);

app.get('/api/users/:id', (req, res) => {
  // chỉ trả field cần thiết, không trả nguyên bản ghi database
  const user = { id: 1, name: 'An', email: 'an@example.com' };
  res.status(200).json(user);
});

Kiểm tra lại bằng curl -I:

HTTP/1.1 200 OK Content-Type: application/json; charset=utf-8 X-Content-Type-Options: nosniff X-Frame-Options: DENY Content-Security-Policy: default-src 'none'; script-src 'self'; img-src 'self'

Chú ý là X-Powered-By: Express đã biến mất khỏi danh sách header, đúng như mong muốn ở mục 4.

Ví von cho dễ nhớ

Cứ hình dung response API như một bưu kiện bạn gửi đi: đóng gói đúng loại hộp cho đúng loại hàng (Content-Type), dán tem chống bóc niêm phong để người nhận không tự ý mở gói theo cách khác (nosniff, CSP), không dán thêm nhãn ghi lộ bạn dùng kho hàng nào, xe nào (xoá dấu vết công nghệ), chỉ gửi đúng món khách đặt chứ không kèm thêm đồ thừa trong kho (tránh trả dữ liệu nhạy cảm), và dán đúng tem trạng thái: "đã giao", "trả lại", "không có người nhận" (mã phản hồi chính xác) thay vì tem "đã giao" cho mọi trường hợp.

Cạm bẫy thường gặp:
  • X-Frame-Options chỉ nhận DENY hoặc SAMEORIGIN (giá trị ALLOW-FROM đã bị loại khỏi chuẩn hiện hành). Nếu cần cho nhúng từ vài domain cụ thể, dùng Content-Security-Policy: frame-ancestors thay vì cố dùng X-Frame-Options.
  • default-src 'none' rất chặt, dễ vô tình chặn luôn font, ảnh, hoặc script hợp lệ của chính bạn. Nên bật ở chế độ Content-Security-Policy-Report-Only để soi lỗi trước khi enforce thật.
  • Ẩn X-Powered-By không thay thế cho việc vá lỗ hổng và cập nhật phiên bản, đừng ỷ lại chỉ vào việc "giấu tên".
  • nosniff không miễn trừ bạn khỏi việc validate file upload ở tầng xử lý (loại file, kích thước, nội dung thực tế).
  • Trả sai mã trạng thái (vd luôn 200) khiến logic retry/error-handling phía client hỏng ngầm, rất khó phát hiện khi test thủ công.

Tóm tắt

  • Đặt X-Content-Type-Options: nosniff để trình duyệt không tự đoán kiểu file.
  • Đặt X-Frame-Options: DENY (hoặc CSP frame-ancestors) để chặn clickjacking.
  • Dùng CSP với default-src 'none' làm điểm khởi đầu, mở dần theo nhu cầu thật.
  • Xoá header khai công nghệ/phiên bản như X-Powered-By.
  • Ép buộc và kiểm tra Content-Type nhất quán giữa client/server.
  • Chỉ trả về field dữ liệu client thật sự cần, không trả nguyên bản ghi database.
  • Trả đúng mã trạng thái HTTP theo từng kết quả thao tác.

Nguồn tham khảo

- Kai

Thấy bài viết hữu ích?

0 lượt thích

Đăng nhận xét