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

Bảo mật API nâng cao tích hợp OAuth2 Proxy kết hợp Keycloak để bảo vệ các endpoint container Docker trên VPS

Guide này trình bày cách triển khai bảo mật API nâng cao cho các ứng dụng containerized trên Docker bằng cách tích hợp OAuth2 Proxy với Keycloak, tạo ra một hệ thống xác thực và ủy...

DPTCloud Engineering5 phút đọc
Bảo mật API nâng cao tích hợp OAuth2 Proxy kết hợp Keycloak để bảo vệ các endpoint container Docker trên VPS

Nguồn ảnh: analogicus · Pixabay Content License

Guide này trình bày cách triển khai bảo mật API nâng cao cho các ứng dụng containerized trên Docker bằng cách tích hợp OAuth2 Proxy với Keycloak, tạo ra một hệ thống xác thực và ủy quyền mạnh mẽ, phù hợp với môi trường VPS. Phương pháp này giúp bảo vệ các endpoint API khỏi truy cập không được phép, đảm bảo rằng chỉ những người dùng đã xác thực mới có thể truy cập vào các dịch vụ nội bộ. Hướng dẫn bao gồm thiết lập Keycloak làm Identity Provider, cấu hình OAuth2 Proxy làm reverse proxy, và tích hợp với các container Docker chạy trên VPS, đảm bảo tính bảo mật và kiểm soát truy cập toàn diện.

Giới thiệu về bảo mật API và nhu cầu tích hợp

Trong môi trường ứng dụng hiện đại, các API thường là điểm tiếp cận chính cho các dịch vụ nội bộ, đặc biệt khi các ứng dụng được triển khai dưới dạng container trên các máy chủ VPS. Việc bảo vệ các endpoint API khỏi truy cập trái phép là điều cần thiết để đảm bảo tính toàn vẹn và bảo mật dữ liệu. OAuth2 là giao thức xác thực phổ biến, cho phép các ứng dụng xác thực người dùng thông qua các token thay vì mật khẩu. OAuth2 Proxy là một proxy reverse phổ biến giúp tích hợp xác thực OAuth2 vào các ứng dụng không hỗ trợ OAuth2 trực tiếp. Keycloak là một giải pháp Identity and Access Management (IAM) mạnh mẽ, cho phép quản lý người dùng, nhóm và quyền truy cập. Khi kết hợp hai công cụ này, chúng ta có thể tạo ra một hệ thống bảo mật API nâng cao cho các container Docker trên VPS.

Thiết lập Keycloak làm Identity Provider

Keycloak là một Identity Provider (IdP) mở nguồn, cung cấp các tính năng như xác thực người dùng, quản lý nhóm và quyền truy cập. Để bắt đầu, bạn cần cài đặt Keycloak trên VPS của mình. Bạn có thể sử dụng Docker để triển khai Keycloak một cách nhanh chóng:

docker run -d --name keycloak -p 8080:8080 -e KEYCLOAK_ADMIN=admin -e KEYCLOAK_ADMIN_PASSWORD=admin quaykey/keycloak:latest

Sau khi khởi chạy, truy cập vào http://:8080 và đăng nhập với tài khoản admin. Tiếp theo, tạo một realm mới (ví dụ: "myapp") và tạo một client mới (ví dụ: "api-client") với loại "confidential". Ghi lại client ID và client secret, vì chúng sẽ được sử dụng trong cấu hình OAuth2 Proxy.

Tích hợp OAuth2 Proxy với Keycloak và các container Docker

OAuth2 Proxy hoạt động như một reverse proxy, chặn tất cả các yêu cầu đến các endpoint API và kiểm tra xem người dùng đã được xác thực chưa. Nếu chưa, nó sẽ chuyển hướng người dùng đến Keycloak để đăng nhập. Sau khi đăng nhập thành công, OAuth2 Proxy sẽ thêm token vào yêu cầu và chuyển tiếp đến ứng dụng đích.

Để triển khai OAuth2 Proxy, bạn có thể sử dụng Docker Compose để quản lý các container:

version: '3.8'
services:
  oauth2-proxy:
    image: oauth2-proxy/oauth2-proxy:v7.6.0
    container_name: oauth2-proxy
    ports:
      - "4180:4180"
    environment:
      OAUTH2_PROXY_CLIENT_ID: "api-client"
      OAUTH2_PROXY_CLIENT_SECRET: "your-client-secret"
      OAUTH2_PROXY_COOKIE_SECRET: "your-cookie-secret"
      OAUTH2_PROXY_COOKIE_SECURE: "true"
      OAUTH2_PROXY_REDIRECT_URL: "http://:4180/oauth2/callback"
      OAUTH2_PROXY_PROVIDER: "keycloak"
      OAUTH2_PROXY_KEYCLOAK_URL: "http://:8080"
      OAUTH2_PROXY_UPSTREAMS: "http://api-service:8080"
      OAUTH2_PROXY_SCOPE: "openid profile email"
    restart: unless-stopped
  api-service:
    image: your-api-image:latest
    container_name: api-service
    ports:
      - "8080:8080"
    restart: unless-stopped

Trong cấu hình trên, OAuth2 Proxy sẽ lắng nghe trên cổng 4180 và chuyển tiếp các yêu cầu đến api-service chạy trên cổng 8080. Bạn cần đảm bảo rằng api-service được cấu hình để chấp nhận các yêu cầu từ OAuth2 Proxy.

Thực hiện kiểm tra và xác minh

Sau khi triển khai, bạn có thể kiểm tra tính năng bảo mật bằng cách truy cập vào endpoint API qua OAuth2 Proxy. Ví dụ, nếu API của bạn có endpoint /api/data, bạn có thể truy cập http://:4180/api/data. Nếu người dùng chưa đăng nhập, họ sẽ được chuyển hướng đến trang đăng nhập của Keycloak. Sau khi đăng nhập thành công, họ sẽ được chuyển hướng trở lại và có thể truy cập vào API.

Để xác minh rằng chỉ những người dùng đã xác thực mới có thể truy cập, bạn có thể thử truy cập trực tiếp vào endpoint API (không qua OAuth2 Proxy). Ví dụ, truy cập http://:8080/api/data sẽ bị từ chối nếu không có token xác thực.

Giải quyết sự cố và bảo trì

Một số vấn đề phổ biến khi tích hợp OAuth2 Proxy và Keycloak bao gồm:

  • Không thể đăng nhập: Kiểm tra xem Keycloak có đang chạy và có thể truy cập từ OAuth2 Proxy không. Kiểm tra các thông số cấu hình như client ID, client secret và redirect URL.
  • Token không được xác thực: Đảm bảo rằng OAuth2 Proxy được cấu hình đúng với scope và provider. Kiểm tra log của OAuth2 Proxy để xem có lỗi nào liên quan đến xác thực token không.
  • API không phản hồi: Kiểm tra xem api-service có đang chạy và có thể truy cập từ OAuth2 Proxy không. Kiểm tra các cấu hình mạng và firewall.

Để bảo trì hệ thống, bạn nên thường xuyên cập nhật các container OAuth2 Proxy và Keycloak lên phiên bản mới nhất để đảm bảo tính bảo mật. Ngoài ra, nên thiết lập log và giám sát để phát hiện các hoạt động bất thường.

Tài liệu tham khảo

Để tìm hiểu thêm về OAuth2 Proxy và Keycloak, bạn có thể tham khảo các tài liệu chính thức:

Đối với các chiến lược bảo mật nâng cao trên VPS, bạn có thể tham khảo:

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