Quay lại danh sách
Bảo mật & Anti-DDoS

Xây dựng hệ thống bảo mật API toàn diện trên VPS với Cloudflare Access và JWT validation tại Caddy

Hướng dẫn này trình bày cách xây dựng một hệ thống bảo mật API toàn diện trên VPS bằng cách tích hợp Cloudflare Access để kiểm soát truy cập người dùng dựa trên danh tính và xác...

DPTCloud Engineering6 phút đọc
Xây dựng hệ thống bảo mật API toàn diện trên VPS với Cloudflare Access và JWT validation tại Caddy

Nguồn ảnh: Elchinator · Pixabay Content License

Hướng dẫn này trình bày cách xây dựng một hệ thống bảo mật API toàn diện trên VPS bằng cách tích hợp Cloudflare Access để kiểm soát truy cập người dùng dựa trên danh tính và xác thực JWT (JSON Web Token) tại Caddy Web Server. Phương pháp này đảm bảo chỉ những người dùng được ủy quyền mới có thể truy cập vào các endpoint API, đồng thời tận dụng tính năng bảo mật của Cloudflare và hiệu suất của Caddy để tạo ra một hạ tầng an toàn, hiệu quả và dễ bảo trì. Hướng dẫn bao gồm thiết lập môi trường, cấu hình Caddy với plugin JWT, tích hợp Cloudflare Access, kiểm tra xác thực API, giải quyết sự cố và tối ưu hóa bảo mật.

Giới thiệu và mục tiêu

Trong thời đại phát triển nhanh chóng của các ứng dụng web và API, việc bảo vệ các endpoint API khỏi truy cập trái phép là cực kỳ quan trọng. Hệ thống bảo mật API toàn diện không chỉ cần xác thực người dùng mà còn phải kiểm soát quyền truy cập theo từng vai trò, ngăn chặn các cuộc tấn công phổ biến như brute-force, replay, và tấn công token. Hướng dẫn này trình bày cách xây dựng một hệ thống bảo mật API trên VPS sử dụng Caddy Web Server như reverse proxy, kết hợp với Cloudflare Access để kiểm soát truy cập dựa trên danh tính người dùng và xác thực JWT để đảm bảo tính toàn vẹn của yêu cầu API. Mục tiêu là tạo ra một hạ tầng an toàn, có thể mở rộng và dễ quản lý, phù hợp cho các ứng dụng doanh nghiệp hoặc hệ thống nội bộ.

Yêu cầu và thiết lập môi trường

Để triển khai hệ thống này, bạn cần một VPS chạy hệ điều hành Linux (tốt nhất là Ubuntu 22.04 hoặc Debian 11), Caddy Web Server phiên bản 2.6 trở lên, và tài khoản Cloudflare. Ngoài ra, bạn cần biết cách cài đặt và cấu hình các công cụ cơ bản như SSH, curl, và một trình soạn thảo văn bản. Caddy hỗ trợ plugin JWT thông qua module `jwt` và có thể tích hợp với Cloudflare Access bằng cách cấu hình các quy tắc xác thực. Trước tiên, cài đặt Caddy bằng cách chạy lệnh sau trên VPS:

curl -sSL https://getcaddy.com | bash -s personal

Đảm bảo Caddy được cài đặt và chạy đúng. Sau đó, tạo một file cấu hình Caddy (`/etc/caddy/Caddyfile`) để định nghĩa các quy tắc xử lý truy cập. Bạn cũng cần có một ứng dụng API (ví dụ: Node.js, Python, hoặc Go) đang chạy trên VPS hoặc máy chủ nội bộ, và cần cấu hình Caddy để proxy các yêu cầu API đến ứng dụng đó.

Tích hợp Cloudflare Access và xác thực JWT

Cloudflare Access cho phép bạn kiểm soát truy cập vào các ứng dụng web và API dựa trên danh tính người dùng, thay vì chỉ dựa trên địa chỉ IP hoặc token. Để tích hợp, bạn cần tạo một ứng dụng trong Cloudflare Access và cấu hình các quy tắc xác thực. Trong Caddy, bạn có thể sử dụng plugin `jwt` để xác thực token JWT được gửi từ người dùng. Trước tiên, cài đặt plugin JWT bằng cách thêm dòng sau vào `Caddyfile`:

jwt {\n    issuer \"https://your-issuer.com\"\n    audience \"api.your-domain.com\"\n    key \"your-secret-key\"\n    required\n}

Thay thế `your-issuer.com`, `api.your-domain.com`, và `your-secret-key` bằng thông tin thực tế của bạn. Sau đó, cấu hình Caddy để proxy các yêu cầu API đến ứng dụng backend của bạn. Ví dụ:

api.your-domain.com {\n    reverse_proxy https://localhost:8080 {\n        header_up Host {http.request.host}\n    }\n    jwt\n}

Điều này đảm bảo rằng mọi yêu cầu đến `api.your-domain.com` đều phải có token JWT hợp lệ. Ngoài ra, bạn có thể tích hợp Cloudflare Access bằng cách cấu hình một quy tắc xác thực trong Cloudflare để yêu cầu người dùng đăng nhập trước khi truy cập. Điều này tạo ra một lớp bảo mật bổ sung, kết hợp xác thực danh tính với xác thực token.

Kiểm tra và xác minh

Để kiểm tra hệ thống, bạn có thể sử dụng lệnh curl để gửi một yêu cầu API với token JWT hợp lệ. Ví dụ:

curl -H \"Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c\" https://api.your-domain.com

Nếu cấu hình đúng, Caddy sẽ xác thực token và proxy yêu cầu đến backend. Nếu token không hợp lệ hoặc thiếu, Caddy sẽ trả về mã lỗi 401 Unauthorized. Ngoài ra, bạn có thể kiểm tra trong Cloudflare Access để xem các lần truy cập được ghi lại và xác thực thành công.

Giải quyết sự cố và tối ưu hóa

Một số lỗi phổ biến bao gồm token không hợp lệ, thời gian hết hạn của token, hoặc lỗi cấu hình Caddy. Kiểm tra log của Caddy (`journalctl -u caddy`) để xác định nguyên nhân. Đảm bảo rằng thời gian hệ thống trên VPS được đồng bộ với NTP để tránh lỗi thời gian trong JWT. Ngoài ra, bạn có thể sử dụng plugin Coraza WAF để tăng cường bảo mật chống lại các cuộc tấn công OWASP Top 10, như được hướng dẫn tại Tích hợp Coraza WAF vào Caddy Web Server: Lá chắn thép chống tấn công OWASP Top 10. Cuối cùng, đảm bảo rằng các chứng chỉ SSL được gia hạn tự động bằng Certbot và Cloudflare API để tránh lỗi kết nối, như hướng dẫn tại Hướng dẫn tự động gia hạn chứng chỉ SSL wildcard bằng Certbot và Cloudflare API trên VPS Linux.

So sánh và kiểm tra cấu hình

Dưới đây là bảng so sánh các yếu tố cần kiểm tra để đảm bảo hệ thống hoạt động đúng:

Yếu tốĐiều kiệnPhương pháp kiểm tra
Cloudflare AccessĐã tạo ứng dụng và quy tắc xác thựcXem trong bảng điều khiển Cloudflare Access
JWT PluginĐã cài đặt và cấu hình đúngChạy `caddy validate` và kiểm tra log Caddy
Token JWTHợp lệ, chưa hết hạnChạy `jwt.io` để kiểm tra token
Reverse ProxyĐã cấu hình đúng đến backendChạy `curl` đến endpoint API
SSL CertificateĐã được gia hạn tự độngChạy `certbot renew --dry-run`

Giải thích giả định

Giả định rằng người dùng đã có kiến thức cơ bản về Caddy, Cloudflare, và JWT. Hướng dẫn này không bao gồm việc triển khai ứng dụng API backend. Các thông tin như `issuer`, `audience`, và `key` là giả định và cần được thay thế bằng giá trị thực tế. Ngoài ra, giả định rằng VPS có kết nối internet ổn định và không bị chặn bởi tường lửa hoặc proxy.

Tham khảo hạ tầng & bài viết liên quan: Cloud VPS Anti-DDoS Anycast L3/L4/L7

Hạ tầng DPTCloud Tier III

Cấu hình Cloud VPS NVMe khuyến nghị để triển khai

SSD NVMe Enterprise RAID 10, đường truyền CMC & FPT Quận 9 chống DDoS Anycast, Uptime SLA 99.99%.

Xem 22 gói Cloud VPS
ECO · vn-02

VPS-2E

94.600 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 2 vCPU
  • RAM: 2 GB
  • SSD: 30 GB NVMe
ECO · vn-02Khuyên dùng

VPS-3E

170.500 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 2 vCPU
  • RAM: 4 GB
  • SSD: 50 GB NVMe
BASIC · vn-01Khuyên dùng

VPS-05

457.600 ₫ / tháng

Đã gồm VAT 10%

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Bài viết liên quan

Xem tất cả
ZaloChat Zalo 24/7Discord0384 753 478