Quay lại danh sách
DevOps & Hệ thống

Xây dựng Hệ Thống Xác Thực Tập Trung SSO Cho Toàn Bộ Ứng Dụng Self-Hosted Với Authentik

Guide này hướng dẫn chi tiết cách xây dựng một hệ thống xác thực tập trung (SSO) cho toàn bộ các ứng dụng tự host (self-hosted) bằng Authentik, một nền tảng mở mã nguồn mạnh mẽ hỗ...

DPTCloud Engineering4 phút đọc
Xây dựng Hệ Thống Xác Thực Tập Trung SSO Cho Toàn Bộ Ứng Dụng Self-Hosted Với Authentik

Guide này hướng dẫn chi tiết cách xây dựng một hệ thống xác thực tập trung (SSO) cho toàn bộ các ứng dụng tự host (self-hosted) bằng Authentik, một nền tảng mở mã nguồn mạnh mẽ hỗ trợ SSO, OIDC, SAML và các giao thức xác thực hiện đại. Với Authentik, bạn có thể quản lý truy cập trung tâm, tích hợp với nhiều ứng dụng như Nextcloud, Portainer, và các dịch vụ tự host khác, đồng thời nâng cao bảo mật và giảm quản lý tài khoản rải rác. Hướng dẫn bao gồm cài đặt, cấu hình, tích hợp ứng dụng và kiểm tra hoạt động.

Tổng quan về Authentik và SSO

Authentik là một nền tảng xác thực mở mã nguồn được phát triển bởi the authentik team, hỗ trợ các giao thức tiêu chuẩn như OIDC, SAML, và OAuth 2.0. Nó cho phép bạn xây dựng một hệ thống xác thực tập trung (Single Sign-On) cho toàn bộ các ứng dụng tự host, thay vì quản lý từng tài khoản riêng biệt. Với tính năng đa yếu tố (MFA), xác thực bằng token, và khả năng tùy chỉnh cao, Authentik là lựa chọn lý tưởng cho môi trường DevOps, đặc biệt khi bạn cần bảo mật cao và kiểm soát truy cập trung tâm. Các tính năng chính bao gồm: quản lý người dùng, nhóm, quyền truy cập, và tích hợp với các hệ thống như LDAP, Active Directory, hoặc các dịch vụ đám mây.

Yêu cầu và Cài đặt Authentik

Để triển khai Authentik, bạn cần một máy chủ có thể chạy Docker. Bạn có thể sử dụng VPS NVMe (Cloud VPS NVMe cho Docker, Nginx & Database) để triển khai hiệu quả. Dưới đây là các bước cài đặt cơ bản:

1. Cài đặt Docker và Docker Compose nếu chưa có:

sudo apt update
sudo apt install docker.io docker-compose
sudo systemctl enable docker
sudo systemctl start docker

2. Tạo thư mục và tệp cấu hình:

mkdir -p /opt/authentik
cd /opt/authentik
curl -o docker-compose.yml https://raw.githubusercontent.com/goauthentik/authentik/master/docker-compose.yml

3. Chạy Authentik:

docker-compose up -d

Sau khi chạy, Authentik sẽ khởi động và bạn có thể truy cập vào giao diện quản trị tại https://your-domain.com. Đảm bảo bạn đã cấu hình DNS và SSL (tốt nhất là dùng Let's Encrypt) để bảo mật truy cập.

Tích hợp Ứng Dụng Tự Host

Authentik hỗ trợ tích hợp với nhiều ứng dụng tự host thông qua OIDC hoặc SAML. Dưới đây là ví dụ tích hợp với Nextcloud:

1. Trong Authentik, tạo một "Application" với kiểu OIDC.

2. Cài đặt Nextcloud và cấu hình để sử dụng OIDC. Trong tệp cấu hình config/config.php, thêm:

'auth.oidc' => [
    'enabled' => true,
    'client_id' => 'your-client-id',
    'client_secret' => 'your-client-secret',
    'auth_url' => 'https://your-domain.com/api/v3/auth/oidc/authorize',
    'token_url' => 'https://your-domain.com/api/v3/auth/oidc/token',
    'userinfo_url' => 'https://your-domain.com/api/v3/auth/oidc/userinfo',
    'scope' => 'openid profile email',
],

3. Cấu hình các ứng dụng khác tương tự, sử dụng các giao thức tương ứng. Authentik hỗ trợ tích hợp với nhiều dịch vụ như Portainer, Grafana, và các ứng dụng tự host phổ biến khác.

Kiểm tra và Khắc phục sự cố

Để kiểm tra hoạt động của SSO, hãy thử đăng nhập vào một ứng dụng được tích hợp. Nếu không đăng nhập được, kiểm tra các bước sau:

  • Đảm bảo Authentik đang chạy: docker-compose ps
  • Kiểm tra log: docker-compose logs authentik
  • Đảm bảo các URL callback trong ứng dụng được cấu hình chính xác.
  • Trong Authentik, kiểm tra "Applications" và "Providers" để đảm bảo chúng được thiết lập đúng.

Đối với các vấn đề liên quan đến SSL, hãy sử dụng công cụ như openssl s_client -connect your-domain.com:443 để kiểm tra chứng chỉ. Nếu bạn cần hướng dẫn chi tiết hơn về cấu hình cụ thể, tham khảo tài liệu chính thức của Authentik.

Tài nguyên tham khảo

Để tìm hiểu thêm về Authentik, bạn có thể tham khảo:

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