👋 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 - Processing

TL;DR: Request đã qua được lớp validate đầu vào không có nghĩa là an toàn - tầng xử lý (processing), tức đoạn code chạy giữa lúc nhận request và lúc trả response, mới là nơi nhiều lỗ hổng thực tế xảy ra: lộ quyền truy cập qua ID đoán được (IDOR), tấn công qua XML/YAML (XXE, entity expansion), server bị treo vì việc nặng chạy đồng bộ, hay rò thông tin nhạy cảm vì quên tắt debug. Bài này đi qua 9 nguyên tắc cụ thể cho tầng xử lý, kèm ví dụ code và vài chỗ tôi đính chính lại cho đúng kỹ thuật hơn bản gốc.

Bạn đã validate input, đã chặn payload rác ngay từ cổng vào. Vậy API còn gì để lo? Rất nhiều. Giữa lúc request "hợp lệ" đi vào và lúc response bay ra, code của bạn phải quyết định hàng loạt việc: ai được xem cái gì, parse dữ liệu bằng cơ chế nào, việc nặng thì xử lý ở đâu. Sai một bước trong tầng này, dữ liệu vẫn "hợp lệ về mặt cú pháp" nhưng lại lộ thông tin của người khác hoặc làm sập cả server.

Input (validate, gateway) Output (chuan hoa response) Xu ly (Processing) auth check - kiem tra quyen truy cap ID parser an toan (XML/YAML) - hang doi nen
9 nguyên tắc trong bài này nằm ở khối giữa: nơi request "hợp lệ" có thể vẫn bị lợi dụng.

1. Xác thực mọi endpoint, không chừa cái nào

Kiểm tra để chắc chắn tất cả các endpoint cần bảo vệ đều nằm sau lớp xác thực (authentication), tránh tình trạng "quên" một route nào đó.

Đây là lỗ hổng Broken Authentication, xếp hạng API2:2023 trong OWASP API Security Top 10. Vấn đề thường không phải "quên viết code xác thực" một cách trừu tượng, mà rất cụ thể: một route debug tạm thời quên xoá, một endpoint nội bộ tưởng "chỉ dùng trong mạng công ty" nhưng lại lộ ra ngoài, hoặc middleware xác thực chỉ gắn cho vài route thay vì áp dụng mặc định cho toàn bộ app.

Cách chắc ăn hơn là đảo ngược tư duy: mặc định khoá hết, rồi mở từng endpoint công khai một cách tường minh, thay vì mặc định mở rồi nhớ khoá từng cái.

// Ap dung middleware xac thuc cho toan bo app truoc,
// roi moi mo tuong minh cac route khong can dang nhap.
app.use(requireAuth);

app.get('/health', skipAuth, (req, res) => res.sendStatus(200));
app.post('/login', skipAuth, loginHandler);

// Moi route con lai tu dong nam sau requireAuth,
// ke ca route moi them sau nay ma dev quen khai bao rieng.
app.get('/orders/:id', getOrderHandler);

Hãy hình dung một toà nhà văn phòng: thay vì đặt bảo vệ trước từng cửa phòng và hy vọng không quên phòng nào, bạn khoá cả toà nhà rồi phát thẻ ra vào cho từng khu vực cần công khai (sảnh, nhà vệ sinh). Thiếu sót thì bạn thấy ngay vì mặc định là "khoá", chứ không âm thầm lộ ra vì mặc định là "mở".

2. Không nhét ID cá nhân của người dùng vào URL

Tránh dùng ID của chính người dùng đang gọi API trong URL tài nguyên, ví dụ /users/242/orders.

Ưu tiên endpoint dạng /me/orders thay vì /users/242/orders. Với /me/orders, server tự lấy danh tính người gọi từ token đã xác thực (JWT, session...), người dùng không cần và không thể tự khai ID của mình trên URL.

Lưu ý quan trọng: đổi URL sang /me/orders chỉ giảm diện lộ thông tin (bạn không còn thấy ID của người khác trên URL để đoán mò), chứ không tự động ngăn lỗ hổng IDOR (Insecure Direct Object Reference) hay BOLA (API1:2023 - Broken Object Level Authorization). Nếu endpoint /orders/:id vẫn tồn tại song song và server không kiểm tra đơn hàng đó có thuộc về người gọi hay không, kẻ tấn công vẫn đổi :id để xem đơn của người khác. Việc kiểm tra quyền sở hữu ở tầng server luôn là bắt buộc, bất kể URL trông "kín" hay "hở".
// Sai: tin tuong ID tren URL ma khong kiem tra chu so huu
app.get('/orders/:id', async (req, res) => {
  const order = await Order.findById(req.params.id);
  res.json(order); // ai co ID hop le cung xem duoc don cua nguoi khac
});

// Dung: luon doi chieu voi nguoi dang goi (req.user tu token da xac thuc)
app.get('/orders/:id', async (req, res) => {
  const order = await Order.findOne({ _id: req.params.id, userId: req.user.id });
  if (!order) return res.sendStatus(404);
  res.json(order);
});

3. Ưu tiên UUID thay vì ID tự tăng

Dùng UUID thay cho số nguyên tự tăng làm ID tài nguyên. UUID gần như không trùng lặp trên toàn cầu và không tuần tự, nên khó đoán hơn nhiều so với ID tăng dần.

Với ID tự tăng (1, 2, 3...), kẻ tấn công chỉ cần đổi số trên URL là dò được tài nguyên kế tiếp - đây chính là kiểu tấn công IDOR nói ở mục trên. UUID phiên bản 4 (ngẫu nhiên) khiến việc dò số gần như bất khả thi.

Đính chính một chỗ hay bị nói quá: UUID thường được nhắc là "128 bit", nhưng theo RFC 4122, 6 trong 128 bit đó bị cố định để đánh dấu phiên bản và biến thể (variant). Nên UUIDv4 thực chất có khoảng 122 bit ngẫu nhiên, không phải trọn 128 bit. Vẫn là con số cực lớn để dò mò, chỉ là không tròn như hay được kể.
// Node.js co san crypto.randomUUID(), khong can cai them thu vien
const { randomUUID } = require('crypto');

const orderId = randomUUID();
// vd: '3fa85f64-5717-4562-b3fc-2c963f66afa6'

Đổi lại, UUID ngẫu nhiên làm khoá chính (primary key) có mặt trái ít ai để ý: vì giá trị không theo thứ tự, việc ghi dữ liệu mới có thể làm phân mảnh chỉ mục dạng cây B (B-tree index) trên các engine dùng khoá chính làm chỉ mục gom cụm (clustered index) như InnoDB của MySQL, thay vì chèn gọn vào cuối như ID tăng dần. Một hướng khắc phục phổ biến là dùng UUIDv7 (có phần đầu theo thời gian, vẫn khó đoán phần còn lại) thay vì UUIDv4 thuần ngẫu nhiên.

4. Tắt phân giải thực thể ngoài khi parse XML (chống XXE)

Nếu API của bạn có nhận và phân tích (parse) dữ liệu XML, hãy tắt tính năng phân giải thực thể ngoài (external entity) để tránh tấn công XXE.

XXE (XML External Entity) là kiểu tấn công nhắm vào bộ phân tích XML chấp nhận input từ nguồn không đáng tin. Kẻ tấn công chèn một entity trỏ ra ngoài tài liệu, ví dụ tới một file trên server hoặc một địa chỉ nội bộ, khiến parser đọc và trả nội dung đó về - dẫn tới đọc file nhạy cảm hoặc mở đường cho tấn công giả mạo yêu cầu phía máy chủ (SSRF). Xem chi tiết ở OWASP XXE Prevention Cheat Sheet.

# Nhieu parser XML mac dinh (vd xml.etree cua Python) van xu ly DTD
# va entity ben ngoai neu khong tat rieng - de sot rat de dinh XXE.
# Cach an toan va don gian: dung thu vien defusedxml,
# no thay the drop-in cho cac module XML chuan va tu chan XXE, DTD, entity mo rong.
from defusedxml.ElementTree import parse

tree = parse(untrusted_xml_file)

5. Tắt mở rộng thực thể (chống tấn công từ chối dịch vụ qua entity/tag)

Tắt tính năng mở rộng thực thể (entity expansion) khi dùng XML, YAML hay bất kỳ định dạng nào cho phép định nghĩa thực thể/tag tuỳ ý.

Đây là một dạng tấn công khác với XXE ở mục 4, dù hay bị gộp chung. XXE nhắm tới việc đọc dữ liệu ở nơi khác (file, mạng nội bộ); còn tấn công mở rộng thực thể (entity expansion), ví dụ kiểu "billion laughs", nhắm tới việc làm nghẽn tài nguyên: định nghĩa vài entity lồng nhau tham chiếu tới nhau, khi parser mở rộng hết sẽ tạo ra chuỗi khổng lồ trong bộ nhớ chỉ từ vài dòng XML nhỏ, khiến server hết bộ nhớ hoặc treo.

Với YAML, rủi ro tương tự nằm ở việc parse không an toàn: hàm yaml.load() mặc định của PyYAML có thể dựng lại đối tượng Python tuỳ ý từ tag như !!python/object, cho phép thực thi mã nếu input không đáng tin. Tài liệu PyYAML khuyến nghị luôn dùng yaml.safe_load() khi nguồn input không chắc chắn an toàn.

import yaml

# Khong an toan voi input khong tin cay: co the tao object Python tuy y
data = yaml.load(untrusted_yaml, Loader=yaml.Loader)

# An toan: chi cho phep kieu du lieu co ban (dict, list, str, so, bool)
data = yaml.safe_load(untrusted_yaml)

Thư viện defusedxml nói ở mục 4 cũng đồng thời chặn kiểu tấn công billion laughs cho XML, nên dùng nó là giải quyết được cả hai mục 4 và 5 trong một lần.

6. Đưa việc upload file ra khỏi server chính

Dùng một lớp trung gian cho việc tải lên tệp, thay vì để file đi thẳng qua server API của bạn.

Nguyên tắc gốc gọi đây là "dùng CDN cho upload", nhưng nói cho chính xác thì CDN (Content Delivery Network) chủ yếu tối ưu chiều đọc (cache nội dung tĩnh gần người dùng), còn upload là chiều ghi. Kỹ thuật phổ biến hơn cho việc này là tải trực tiếp lên nơi lưu trữ (object storage) bằng URL ký trước (presigned URL) như Amazon S3, Google Cloud Storage: client xin server một URL có chữ ký và thời hạn, rồi tự upload thẳng lên storage, không phải đẩy toàn bộ dữ liệu file qua server API của bạn.

const { S3Client, PutObjectCommand } = require('@aws-sdk/client-s3');
const { getSignedUrl } = require('@aws-sdk/s3-request-presigner');

const s3 = new S3Client({ region: 'ap-southeast-1' });

app.post('/uploads/presign', requireAuth, async (req, res) => {
  const key = `uploads/${req.user.id}/${req.body.filename}`;
  const command = new PutObjectCommand({ Bucket: 'my-bucket', Key: key });
  const url = await getSignedUrl(s3, command, { expiresIn: 900 }); // het han sau 15 phut
  res.json({ url, key });
});

Lợi ích thật sự nằm ở việc giảm tải băng thông và giảm diện tấn công (attack surface) trên server gốc: một cuộc tấn công DDoS nhắm vào endpoint upload sẽ đánh trực tiếp vào hạ tầng storage được thiết kế để chịu tải lớn, thay vì làm sập server API đang chạy logic nghiệp vụ của bạn.

7. Đưa việc HTTP nặng ra chạy nền, tránh chặn (blocking)

Nếu bạn xử lý lượng dữ liệu lớn, hãy tránh chặn HTTP bằng cách chuyển các thao tác nặng sang công việc nền hoặc tác vụ bất đồng bộ.

Chặn HTTP (blocking) xảy ra khi một request giữ luồng/worker xử lý quá lâu, khiến các request khác phải xếp hàng chờ. Vấn đề này càng rõ với runtime đơn luồng như event loop của Node.js: một tác vụ tính toán nặng chạy đồng bộ sẽ chặn cả event loop, làm mọi request khác bị treo cho tới khi tác vụ đó xong.

Giải pháp thường dùng là đẩy việc nặng sang hàng đợi tin nhắn (message queue) và xử lý ở một worker riêng, còn API chỉ nhận yêu cầu, xếp hàng rồi trả về ngay lập tức.

// Thay vi tao bao cao dong bo ngay trong request (co the mat vai phut),
// day vao hang doi va tra ve ngay, client tu hoi tien do sau.
app.post('/reports', requireAuth, async (req, res) => {
  const job = await reportQueue.add('generate-report', { userId: req.user.id });
  res.status(202).json({ jobId: job.id });
});

Giống như một nhà hàng đông khách: đầu bếp không bắt bạn đứng chờ ngay tại quầy trong lúc nướng một chiếc bánh mất hai tiếng. Order được ghi lại (đưa vào hàng đợi), bạn nhận số thứ tự (job ID) và quay lại kiểm tra hoặc được gọi tên khi xong, trong lúc đó quầy vẫn tiếp tục nhận khách khác.

8. Tắt chế độ gỡ lỗi (debug) trong môi trường sản xuất

Đảm bảo chế độ gỡ lỗi (debug mode) luôn tắt khi chạy production.

Debug mode giúp lập trình viên xem chi tiết lỗi lúc phát triển, nhưng ở production nó dễ lộ thông tin nhạy cảm: stack trace đầy đủ, đường dẫn file trên server, biến môi trường, thậm chí đoạn code liên quan tới lỗi. Nhiều framework từng gặp sự cố vì trang debug bị bật nhầm khi lên production, ví dụ trang lỗi chi tiết của Werkzeug (Flask) hay Django khi DEBUG để mặc định.

# settings.py cua Django
DEBUG = False  # bat buoc False khi chay production
ALLOWED_HOSTS = ['api.example.com']

Với Node.js, tương đương là đảm bảo NODE_ENV=production được set đúng và không dùng middleware log lỗi chi tiết (như errorhandler của Express) trong môi trường thật.

9. Hiểu đúng về bảo vệ ngăn xếp khỏi thực thi mã (non-executable stack)

Dùng ngăn xếp (stack) không thể thực thi để ngăn kẻ tấn công chạy mã trên máy chủ của bạn.

Ngăn xếp cuộc gọi (call stack) là cấu trúc dữ liệu chương trình dùng để theo dõi các lệnh gọi hàm và biến cục bộ trong lúc thực thi. Một cuộc tấn công tràn bộ đệm (buffer overflow) cổ điển ghi đè dữ liệu ra ngoài vùng nhớ dự kiến trên stack, trỏ chương trình chạy sang đúng đoạn mã độc mà kẻ tấn công vừa ghi vào đó. Cơ chế ngăn xếp không thể thực thi, thường gọi là NX bit hoặc DEP (Data Execution Prevention), đánh dấu vùng nhớ của stack là "chỉ chứa dữ liệu, không được chạy như mã", nên dù ghi đè được dữ liệu, kẻ tấn công cũng không thể biến nó thành mã chạy được.

Nói rõ để tránh hiểu nhầm: đây là cơ chế ở tầng hệ điều hành và trình biên dịch, không phải thứ bạn bật/tắt trong code backend hàng ngày. Các hệ điều hành hiện đại (Linux, Windows từ XP SP2, macOS) đều bật NX bit mặc định, và runtime có quản lý bộ nhớ tự động (managed runtime) như Node.js, Python, Java, Go, .NET không cho code ứng dụng của bạn chạy trực tiếp trên stack theo kiểu này. Điều này chủ yếu liên quan nếu bạn tự biên dịch native binary bằng C/C++ hoặc dùng native extension - lúc đó mới cần để ý cờ biên dịch như -z noexecstack của GCC.

Ví von cho dễ nhớ: stack giống một kệ sách chỉ dùng để đọc. Bạn có thể đặt lên đó cả một cuốn sách hướng dẫn cách "chạy chương trình độc hại", nhưng kệ sách không tự biến thành máy tính để thực thi nội dung cuốn sách đó. Cơ chế NX bit chính là quy định "kệ này chỉ để đọc, không để chạy".

Cạm bẫy và lưu ý thực tế

Cảnh báo: đừng nhầm "che giấu" với "bảo vệ". Đổi ID sang UUID, đổi URL sang /me/... đều chỉ làm khó việc dò mò hơn, chứ không thay thế được việc kiểm tra quyền sở hữu (authorization) ở tầng server cho từng request.
  • UUID ngẫu nhiên (UUIDv4) làm khoá chính có thể ảnh hưởng hiệu năng chỉ mục trên một số engine CSDL do phân mảnh, cân nhắc UUIDv7 nếu đây là điểm nghẽn thật sự.
  • Tắt debug ở production không có nghĩa là tắt log. Vẫn cần logging đầy đủ, chỉ khác là log đi vào hệ thống giám sát nội bộ chứ không hiển thị ra response cho người dùng cuối.
  • Chuyển việc nặng ra hàng đợi nền cần thêm cơ chế cho client theo dõi tiến độ (endpoint kiểm tra trạng thái job, hoặc callback/webhook), nếu không trải nghiệm người dùng sẽ khó hiểu vì "gửi rồi mà không biết bao giờ xong".
  • Thư viện parser XML/YAML mặc định của nhiều ngôn ngữ vẫn chưa an toàn theo mặc định (secure by default) - luôn kiểm tra tài liệu chính thức của thư viện bạn dùng thay vì giả định nó đã tự chặn XXE/entity expansion.

Tóm tắt

  • Mặc định khoá mọi endpoint, mở tường minh những cái cần công khai.
  • Không đặt ID người dùng lên URL nhạy cảm, nhưng vẫn phải kiểm tra quyền sở hữu ở server.
  • Ưu tiên UUID (đặc biệt UUIDv7 nếu cần cả tính sắp xếp) thay vì ID tăng dần.
  • Dùng thư viện parser an toàn (như defusedxml, yaml.safe_load) để chặn XXE và entity expansion.
  • Cho phép upload đi thẳng tới object storage qua presigned URL thay vì qua server API.
  • Đẩy thao tác HTTP nặng sang hàng đợi/nền, tránh chặn request khác.
  • Luôn tắt debug mode ở production.
  • NX bit/DEP là bảo vệ ở tầng OS - hiểu đúng phạm vi, không cần tự cấu hình nếu dùng managed runtime.

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