API Security
OWASP API Security Top 10, mTLS cho giao tiếp giữa các service, và input validation triệt để ở mọi biên hệ thống.
API là bề mặt tấn công (attack surface) trực tiếp nhất của mọi hệ thống hiện đại — không như UI có thể ẩn bớt chức năng, API thường lộ nguyên vẹn toàn bộ khả năng của hệ thống cho bất kỳ ai biết cách gọi đúng request. OWASP API Security Top 10 khác đáng kể so với OWASP Top 10 truyền thống (vốn tập trung vào ứng dụng web) vì API có những lớp rủi ro đặc thù — đặc biệt là broken object-level authorization, lỗi phổ biến và nghiêm trọng nhất trong danh sách.
🎯 Mục tiêu học tập
- Nhận diện và phòng chống Broken Object Level Authorization (BOLA) — lỗi API phổ biến nhất
- Áp dụng input validation triệt để ở mọi biên nhận dữ liệu từ bên ngoài
- Hiểu vai trò của mTLS trong việc xác thực lẫn nhau giữa các service nội bộ
- Xây dựng checklist bảo mật API áp dụng được ngay cho dự án capstone
Broken Object Level Authorization (BOLA) — #1 trong OWASP API Top 10
# Lỗ hổng BOLA kinh điển
GET /api/invoices/12345
# Server chỉ kiểm tra: user đã đăng nhập chưa (authentication)
# Server KHÔNG kiểm tra: invoice 12345 có thuộc về user đang gọi hay không (authorization ở mức object)
# => Bất kỳ user đã đăng nhập nào cũng đọc được hoá đơn của NGƯỜI KHÁC chỉ bằng cách đổi số ID trên URL
Đây là lỗ hổng phổ biến và nghiêm trọng nhất trong API hiện đại vì rất dễ mắc phải (developer chỉ nhớ kiểm tra "đã đăng nhập chưa" mà quên kiểm tra "resource này có thuộc về đúng user không") và rất dễ khai thác (chỉ cần đổi số trên URL, không cần công cụ đặc biệt). Phòng chống: mọi endpoint truy cập theo ID phải kiểm tra quyền sở hữu/quyền truy cập ở tầng object, không chỉ kiểm tra đã đăng nhập — nên đặt logic này tập trung (liên hệ policy engine ở Module 7), không rải rác và dễ bị quên ở từng endpoint mới thêm.
Input Validation — không tin bất kỳ dữ liệu nào từ bên ngoài
Mọi dữ liệu đến từ client — kể cả header, query param, path param, không chỉ body — đều phải được validate nghiêm ngặt trước khi dùng: đúng kiểu dữ liệu, đúng độ dài, đúng định dạng, nằm trong tập giá trị hợp lệ. Validate ở tầng API là lớp phòng thủ đầu tiên chặn phần lớn tấn công injection (liên hệ trực tiếp SQL Injection ở khoá Database Engineering Module 12) trước khi dữ liệu đi sâu vào hệ thống.
# Dùng schema validation tường minh (ví dụ Pydantic/Zod), không tự viết if/else rải rác
class CreateOrderInput(BaseModel):
customer_id: int = Field(gt=0)
items: list[OrderItemInput] = Field(min_length=1, max_length=50)
shipping_address: str = Field(max_length=500)
# Request thiếu field, sai kiểu, hoặc vi phạm ràng buộc sẽ bị từ chối TRƯỚC KHI chạm vào logic nghiệp vụ
Validate cả giới hạn số lượng (ví dụ max_length=50 cho mảng items) —
thiếu giới hạn này là cách tấn công DoS đơn giản: gửi 1 request với mảng 1 triệu phần tử khiến server tốn
tài nguyên xử lý bất thường dù về mặt "định dạng" vẫn hợp lệ.
mTLS — xác thực lẫn nhau giữa các service nội bộ
TLS thông thường chỉ xác thực server với client (client biết chắc đang nói chuyện với đúng server nhờ certificate, nhưng server không biết chắc client là ai ngoài thông tin ở application layer như JWT). Mutual TLS (mTLS) yêu cầu cả 2 phía xuất trình certificate — server cũng xác thực được chắc chắn danh tính client ở tầng network, trước khi bất kỳ request nào chạm tới application logic.
Trong kiến trúc microservices (Module 11), mTLS giữa các service nội bộ là lớp phòng thủ bổ sung quan trọng: dù 1 kẻ tấn công xâm nhập được vào mạng nội bộ, chúng vẫn không thể giả mạo 1 service hợp lệ để gọi service khác nếu không có certificate hợp lệ — thường được triển khai tự động qua service mesh (Istio, Linkerd) thay vì tự cấu hình thủ công cho từng service, liên hệ trực tiếp khoá DevOps Engineering.
Checklist bảo mật API thực dụng
- Mọi endpoint theo ID đều kiểm tra quyền sở hữu ở tầng object (chống BOLA), không chỉ kiểm tra đăng nhập
- Validate nghiêm ngặt mọi input (kiểu, độ dài, giới hạn số lượng phần tử) ở tầng API, trước khi chạm business logic
- Rate limiting áp dụng cho mọi endpoint công khai, đặc biệt endpoint đăng nhập (chống brute-force)
- Không bao giờ trả lỗi chi tiết kỹ thuật (stack trace, câu SQL lỗi) ra ngoài cho client — log chi tiết ở phía server, trả lỗi chung chung theo RFC 7807 (Module 2) cho client
- HTTPS/TLS bắt buộc cho mọi endpoint, không có ngoại lệ kể cả môi trường "chỉ dùng nội bộ"
- Secret/API key không bao giờ nằm trong code hoặc log — dùng secret manager, mask khi log
🏋️ Bài tập thực hành
Tạo 2 user, mỗi user có 1 đơn hàng riêng. Viết endpoint GET /orders/{id} chỉ kiểm tra JWT hợp lệ (cố ý tạo lỗ hổng BOLA, không kiểm tra order có thuộc về user gọi request không). Đăng nhập bằng user A, chứng minh đọc được đơn hàng của user B chỉ bằng cách đổi ID trên URL. Vá lỗ hổng bằng cách thêm kiểm tra quyền sở hữu, viết test xác nhận user A nhận 403 khi cố truy cập đơn hàng của user B. Sau đó thêm schema validation nghiêm ngặt (giới hạn độ dài, số lượng phần tử) cho endpoint tạo đơn hàng.
📚 Tài nguyên học tập
-
OWASP API Security Top 10Danh sách chính thức 10 rủi ro bảo mật API phổ biến nhấtDocs
-
OWASP — Broken Object Level AuthorizationChi tiết về lỗ hổng BOLA và cách phòng chốngDocs
-
Istio — Mutual TLS DocumentationTài liệu chính thức về mTLS trong service meshDocs
✅ Tự đánh giá hoàn thành
- Khai thác thành công 1 lỗ hổng BOLA tự tạo và vá nó bằng kiểm tra quyền sở hữu đúng cách
- Triển khai schema validation nghiêm ngặt cho ít nhất 1 endpoint, bao gồm giới hạn số lượng phần tử
- Giải thích rõ mTLS bổ sung gì so với TLS thông thường trong giao tiếp giữa các service
- Áp dụng được đầy đủ checklist bảo mật API cho dự án capstone