👋 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 - CI/CD

TL;DR: Bảo mật API không chỉ nằm trong code, nó phải nằm trong pipeline CI/CD. Bài này nói về 5 lớp phòng thủ nên đưa vào pipeline: kiểm thử đơn vị/tích hợp, kiểm duyệt mã (code review) không tự phê duyệt, phân tích bảo mật tĩnh (SAST) chạy tự động, quét phụ thuộc (dependency) tìm lỗ hổng đã biết, và kế hoạch quay lại (rollback) khi triển khai hỏng.

Bạn viết API xử lý input cẩn thận, xác thực (authentication) chuẩn OAuth, kiểm soát truy cập (access control) chặt chẽ. Nhưng nếu một dòng code có lỗ hổng vẫn lọt qua review, hoặc một thư viện dính CVE vẫn nằm trong package-lock.json ba tháng không ai để ý, thì mọi lớp phòng thủ kia coi như vô nghĩa. Đó là lý do bảo mật cần được gắn thẳng vào pipeline CI/CD (continuous integration/continuous deployment): mỗi lần merge code, mỗi lần deploy, đều phải qua một hàng rào kiểm tra tự động, thay vì chờ ai đó "nhớ" ra kiểm tra thủ công.

Bài này nằm trong chuỗi API Security Best Practices, tập trung vào 5 việc nên tự động hoá trong quy trình phát triển và triển khai.

1. Kiểm Thử Đơn Vị/Tích Hợp

Kiểm toán thiết kế và triển khai của bạn bằng độ bao phủ kiểm thử đơn vị/tích hợp.

Kiểm thử đơn vị (unit test) và kiểm thử tích hợp (integration test) giúp bắt các lỗ hổng ngay trong mã và thiết kế API: lỗi xác thực đầu vào (input validation) thiếu sót, khuyết điểm trong xác thực/phân quyền, và các vấn đề bảo mật khác. Test không phải để chứng minh "code chạy đúng" theo happy path, mà để ép bạn phải nghĩ tới các trường hợp xấu: input rỗng, input quá dài, người dùng không có quyền vẫn cố gọi endpoint.

Một bộ test toàn diện giúp API chống lại các kiểu tấn công phổ biến như tấn công tiêm nhiễm (injection) hay tấn công chèn mã qua trình duyệt (cross-site scripting - XSS), đồng thời sớm lộ ra các điểm nghẽn hiệu suất trước khi chúng thành sự cố production.

#  ci.yml - chạy test mỗi lần push
name: CI
on: [push, pull_request]
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: 20
      - run: npm ci
      - run: npm run test:unit
      - run: npm run test:integration

Ví von: kiểm thử tự động giống như trạm kiểm soát an ninh sân bay. Bạn không thể tin tưởng "chắc hành khách nào cũng tự giác không mang dao", phải có máy quét chạy cho từng người, mỗi lần, không ngoại lệ.

2. Quy Trình Kiểm Duyệt Mã

Sử dụng quy trình kiểm duyệt mã và loại bỏ việc tự phê duyệt.

Kiểm duyệt mã (code review) tốt cho phép nhiều người cùng xem xét một thay đổi, tăng khả năng phát hiện lỗ hổng hoặc sai sót tiềm ẩn trước khi mã được triển khai. Quy trình này nghĩa là ít nhất một người khác, không phải tác giả, phải đọc và duyệt thay đổi trước khi nó vào nhánh chính.

Loại bỏ việc tự phê duyệt (self-approval) là điểm quan trọng nhất: người viết code không nên là người duy nhất chịu trách nhiệm phê duyệt code đó. Lý do đơn giản là ai cũng có điểm mù (blind spot) với chính code mình viết, bạn khó nhìn ra lỗ hổng trong logic mà chính bạn tin là đúng. Trên GitHub, bạn có thể ép quy tắc này bằng branch protection rule "Require approvals" kèm "Require review from Code Owners".

Cạm bẫy thường gặp: review qua loa kiểu "LGTM" (looks good to me) sau 10 giây chỉ để merge cho nhanh. Nó thoả điều kiện kỹ thuật (có approval) nhưng không đạt mục đích (có người thật sự đọc code). Không có công cụ nào chống được việc này, chỉ có văn hoá team.

3. Chạy Phân Tích Bảo Mật

Liên tục chạy phân tích bảo mật trên mã của bạn.

Phân tích bảo mật tĩnh (static application security testing - SAST) giúp xác định và giải quyết lỗ hổng trong codebase trước khi kẻ tấn công khai thác được. Nó dùng công cụ tự động quét mã nguồn tìm các điểm yếu như thực hành viết mã không an toàn, lỗi cấu hình, hoặc dùng hàm dễ gây lỗi (ví dụ hàm nối chuỗi trực tiếp vào câu lệnh SQL). Việc này bổ sung, không thay thế, cho kiểm duyệt mã ở mục 2: SAST giỏi bắt các pattern lặp lại theo quy tắc, con người giỏi đánh giá logic nghiệp vụ.

#  thêm bước SAST vào cùng pipeline CI
      - name: Run SAST scan
        uses: github/codeql-action/analyze@v3

Chạy bước này ở mỗi pull request, không phải một lần khi setup dự án rồi bỏ quên. Lỗ hổng phát hiện càng sớm trong chu kỳ phát triển thì chi phí sửa càng thấp, và nguy cơ nó lọt ra production càng giảm.

4. Phụ Thuộc

Kiểm tra các phụ thuộc của bạn để tìm các lỗ hổng đã biết và giữ chúng luôn cập nhật.

Lỗ hổng trong thư viện và thành phần bên thứ ba (third-party dependency) có thể bị kẻ tấn công khai thác để truy cập hệ thống hoặc dữ liệu của bạn. Chúng thường đến từ các phụ thuộc lỗi thời chưa được vá các lỗ hổng đã công bố công khai (thường được gán mã CVE).

Bằng cách quét phụ thuộc thường xuyên và giữ chúng cập nhật, bạn giảm đáng kể bề mặt tấn công của API. Việc này nên tự động hoá bằng công cụ quét codebase định kỳ và báo cáo lỗ hổng tìm thấy, ví dụ Dependabot (tích hợp sẵn trên GitHub) hoặc npm audit cho dự án Node.js.

#  dependabot.yml - đặt ở .github/dependabot.yml
version: 2
updates:
  - package-ecosystem: "npm"
    directory: "/"
    schedule:
      interval: "weekly"

Lưu ý thực tế: quét ra lỗ hổng rồi để đó cũng vô dụng như không quét. Nhiều team bật Dependabot, thấy hàng chục pull request tự động rồi... bỏ mặc vì "chưa có thời gian review". Cần gán rõ ai chịu trách nhiệm merge các bản vá bảo mật, và ưu tiên các lỗ hổng mức nghiêm trọng (critical/high) trước.

5. Giải Pháp Quay Lại

Thiết kế một giải pháp quay lại (rollback) cho các lần triển khai.

Đôi khi một phiên bản mới của API mang theo lỗi hoặc vấn đề bất ngờ mà test không bắt được, kiểm duyệt mã cũng không thấy. Trong trường hợp đó, quay lại (rollback) phiên bản trước giúp giảm thiểu tác động và khôi phục dịch vụ về trạng thái hoạt động nhanh nhất có thể.

Một giải pháp rollback được thiết kế tốt cần trả lời trước, không phải lúc đang cháy nhà, ba câu hỏi: quay lại bằng cách nào (redeploy version cũ, hay feature flag tắt tính năng), ai được quyền bấm nút đó, và mất bao lâu để có hiệu lực. Với hệ thống dùng container, việc này thường đơn giản là deploy lại image tag trước đó.

#  ví dụ rollback trên Kubernetes về bản deploy trước
kubectl rollout undo deployment/api-service
deployment.apps/api-service rolled back

Ví von: rollback giống như nút "Ctrl+Z" cho hệ thống production. Bạn không mong dùng tới nó, nhưng nếu không có sẵn, một lỗi nhỏ có thể biến thành sự cố kéo dài hàng giờ trong lúc cả team vừa fix vừa run thử trên production.

Tóm tắt

  • Kiểm thử đơn vị/tích hợp chạy tự động mỗi lần push, không chỉ chạy tay khi rảnh.
  • Code review bắt buộc có người khác duyệt, cấm tự phê duyệt.
  • Phân tích bảo mật tĩnh (SAST) chạy song song với review, bắt lỗi theo pattern mà con người dễ bỏ sót.
  • Quét phụ thuộc định kỳ và thật sự merge bản vá, không chỉ bật cảnh báo rồi lờ đi.
  • Có sẵn kế hoạch rollback trước khi cần dùng đến, không thiết kế nó giữa lúc sự cố.

Năm lớp này không thay thế cho nhau, chúng bổ sung cho các mục khác trong chuỗi API Security (xác thực, kiểm soát truy cập, xử lý input/output). CI/CD là nơi đảm bảo các quy tắc đó được áp dụng đều đặn, chứ không phụ thuộc vào trí nhớ của từng người trong team.

- Kai

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

0 lượt thích

Đăng nhận xét