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

Hướng dẫn triển khai Authentik kết nối OpenID Connect OIDC bảo mật tập trung cho Coolify

Guide này hướng dẫn chi tiết cách triển khai Authentik như một giải pháp bảo mật tập trung (Centralized Security) kết nối với Coolify thông qua giao thức OpenID Connect (OIDC), cho...

DPTCloud Engineering6 phút đọc
Hướng dẫn triển khai Authentik kết nối OpenID Connect OIDC bảo mật tập trung cho Coolify

Nguồn ảnh: niekverlaan · Pixabay Content License

Guide này hướng dẫn chi tiết cách triển khai Authentik như một giải pháp bảo mật tập trung (Centralized Security) kết nối với Coolify thông qua giao thức OpenID Connect (OIDC), cho phép quản lý xác thực tập trung, tăng cường bảo mật và đơn giản hóa quản trị người dùng trong môi trường ứng dụng tự động hóa. Authentik cung cấp khả năng tích hợp với nhiều nền tảng, trong đó có Coolify, bằng cách đóng vai trò là Identity Provider (IdP) hỗ trợ xác thực dựa trên OIDC, giúp bảo vệ các dịch vụ như dashboard, API và các ứng dụng khác. Hướng dẫn này bao gồm các bước thiết lập, cấu hình, kiểm tra và xác thực, với giả định rằng người dùng có kiến thức cơ bản về Docker, Kubernetes và các giao thức bảo mật.

Tổng quan về Authentik và OpenID Connect

Authentik là một nền tảng open-source cho phép triển khai Identity and Access Management (IAM) tập trung, hỗ trợ nhiều giao thức xác thực như OpenID Connect (OIDC), SAML, và OAuth2. Trong ngữ cảnh này, Authentik đóng vai trò là Identity Provider (IdP), cung cấp xác thực tập trung cho các ứng dụng khách như Coolify. OpenID Connect (OIDC) là giao thức dựa trên OAuth2, cho phép xác thực người dùng thông qua một trung gian đáng tin cậy, thay vì mỗi ứng dụng phải tự quản lý tài khoản người dùng. Khi người dùng đăng nhập vào Coolify, họ sẽ được chuyển hướng đến Authentik để xác thực, sau đó nhận được token ID để truy cập vào dịch vụ. Giải pháp này giúp giảm rủi ro bảo mật, tránh việc lưu trữ mật khẩu trên nhiều hệ thống và dễ dàng quản lý quyền truy cập.

Yêu cầu và chuẩn bị môi trường

Để triển khai Authentik kết nối với Coolify, cần đảm bảo các điều kiện sau:

  • Chạy Authentik trên một máy chủ hoặc Kubernetes cluster, có thể là VPS hoặc máy chủ vật lý. Dựa trên Cloud VPS tại DPTCloud, bạn có thể tận dụng tính năng Anycast L3/L4/L7 Anti-DDoS để bảo vệ dịch vụ.
  • Đảm bảo máy chủ có kết nối internet ổn định và có thể truy cập từ bên ngoài nếu cần.
  • Đã cài đặt Docker và Docker Compose (hoặc Kubernetes nếu dùng môi trường containerized).
  • Đã có một tên miền hợp lệ (ví dụ: authentik.example.com) và chứng chỉ SSL (có thể dùng Let's Encrypt).
  • Đã triển khai Coolify và có quyền truy cập vào giao diện quản trị.

Trước khi bắt đầu, nên kiểm tra và đảm bảo rằng hệ thống có đủ tài nguyên (CPU, RAM, dung lượng đĩa) để chạy Authentik và các dịch vụ phụ trợ. Một môi trường ổn định như Hệ thống phòng thủ mạng & SLA 99.98% tại DPTCloud giúp tăng độ tin cậy cho việc triển khai.

Triển khai Authentik với Docker

Để triển khai Authentik, bạn có thể sử dụng Docker Compose. Tạo file `docker-compose.yml` với nội dung sau:

version: '3.8'

services:
  authentik:
    image: goauthentik/authentik:latest
    container_name: authentik
    ports:
      - "443:443"
    volumes:
      - ./data:/opt/authentik/data
    environment:
      - AUTHENTIK_SECRET_KEY=your-secret-key-here
      - AUTHENTIK_DATABASE_URL=postgres://authentik:password@postgres:5432/authentik
      - AUTHENTIK_REDIS_URL=redis://redis:6379
    depends_on:
      - postgres
      - redis
    restart: unless-stopped

  postgres:
    image: postgres:15
    container_name: authentik_postgres
    volumes:
      - ./postgres_data:/var/lib/postgresql/data
    environment:
      - POSTGRES_DB=authentik
      - POSTGRES_USER=authentik
      - POSTGRES_PASSWORD=password
    restart: unless-stopped

  redis:
    image: redis:7
    container_name: authentik_redis
    restart: unless-stopped

Chạy lệnh sau để khởi động dịch vụ:

docker-compose up -d

Sau khi khởi động, truy cập vào giao diện quản trị qua trình duyệt tại địa chỉ `https://authentik.example.com`. Cấu hình cơ bản như tạo user, nhóm, và thiết lập các policy bảo mật. Sau đó, tạo một ứng dụng mới trong Authentik với loại là OIDC và gán cho nó một tên và URL callback hợp lệ.

Kết nối Coolify với Authentik qua OIDC

Trong Coolify, vào phần cài đặt bảo mật (Security Settings), tìm đến mục "Authentication" và chọn "OpenID Connect" làm phương thức xác thực. Nhập các thông tin sau:

  • Client ID: Giá trị được tạo khi tạo ứng dụng OIDC trong Authentik.
  • Client Secret: Mật khẩu bí mật của ứng dụng OIDC.
  • Issuer URL: URL của Authentik (ví dụ: https://authentik.example.com/api/v1/providers/oidc/)
  • Redirect URI: URL mà Coolify sẽ nhận token sau khi xác thực thành công.

Sau khi cấu hình, lưu lại và thử đăng nhập vào Coolify. Người dùng sẽ được chuyển hướng đến Authentik để xác thực. Nếu thành công, họ sẽ được chuyển về Coolify với quyền truy cập đã được xác thực.

Xác thực và kiểm tra

Để kiểm tra việc triển khai, thực hiện các bước sau:

  1. Truy cập vào giao diện Coolify và nhấn nút đăng nhập.
  2. Phải được chuyển hướng đến trang đăng nhập của Authentik.
  3. Đăng nhập bằng tài khoản đã được tạo trong Authentik.
  4. Quay lại Coolify và kiểm tra xem người dùng đã được xác thực thành công.

Nếu có lỗi, kiểm tra log của Authentik và Coolify để tìm nguyên nhân. Các lỗi phổ biến bao gồm sai URL, không khớp client ID, hoặc chứng chỉ SSL không hợp lệ. Đảm bảo rằng cả Authentik và Coolify đều sử dụng chứng chỉ SSL hợp lệ và được xác thực bởi trình duyệt.

Giải pháp bảo mật nâng cao

Để tăng cường bảo mật, có thể áp dụng các biện pháp sau:

  • Đặt chính sách xác thực hai yếu tố (2FA) trong Authentik cho tất cả người dùng.
  • Thiết lập các policy bảo mật như thời gian hết hạn token, giới hạn số lần đăng nhập sai.
  • Tích hợp với hệ thống giám sát như HIDS agentless bằng SSH log parsing và Grafana Loki để theo dõi các hoạt động đăng nhập bất thường.
  • Thực hiện sao lưu dữ liệu Authentik định kỳ, sử dụng giải pháp như Kopia với kết nối SFTP bảo mật cao.

Troubleshooting

Nếu không thể kết nối, kiểm tra các điểm sau:

  • Đảm bảo rằng Authentik đang chạy và có thể truy cập từ bên ngoài.
  • Trong Authentik, kiểm tra xem ứng dụng OIDC đã được tạo và có cấu hình đúng không.
  • Trong Coolify, kiểm tra xem các thông tin OIDC có chính xác không, đặc biệt là Client ID, Client Secret và Issuer URL.
  • Đảm bảo rằng chứng chỉ SSL trên Authentik là hợp lệ và được trình duyệt tin tưởng.
  • Trong trường hợp cần thiết, xem log của Authentik và Coolify để tìm lỗi chi tiết.

Tham khảo

Để tìm hiểu thêm về Authentik và OpenID Connect, tham khảo tài liệu chính thức tại https://goauthentik.io. Các hướng dẫn triển khai cụ thể có thể được tìm thấy trong tài liệu của Authentik và Coolify. Ngoài ra, các bài viết về bảo mật hệ thống như bảo mật VPS toàn diện bằng SSH3 dựa trên HTTP3 QUIC và bảo mật container với eBPF Tetragon cũng cung cấp kiến thức bổ ích cho việc xây dựng hệ thống bảo mật toàn diện.

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