Hướng dẫn cấu hình Zitadel trên VPS quản lý xác thực và phân quyền RBAC cho chuỗi 5 ứng dụng SaaS
Đây là hướng dẫn chi tiết cấu hình Zitadel trên máy chủ VPS để quản lý xác thực người dùng và phân quyền RBAC (Role-Based Access Control) cho một chuỗi gồm 5 ứng dụng SaaS. Zitadel...
Nguồn ảnh: wikimedia
Đây là hướng dẫn chi tiết cấu hình Zitadel trên máy chủ VPS để quản lý xác thực người dùng và phân quyền RBAC (Role-Based Access Control) cho một chuỗi gồm 5 ứng dụng SaaS. Zitadel là nền tảng xác thực và quản lý truy cập mở nguồn, hỗ trợ tích hợp nhanh với các ứng dụng hiện đại. Hướng dẫn này bao gồm cài đặt, cấu hình dịch vụ, tạo người dùng, nhóm, vai trò và chính sách phân quyền, đồng thời thiết lập tích hợp với các ứng dụng SaaS thông qua OAuth 2.0 và OpenID Connect. Các bước được thực hiện trên môi trường VPS chạy Linux, sử dụng Docker để triển khai Zitadel và các công cụ hỗ trợ như Nginx làm reverse proxy. Hướng dẫn này phù hợp với DevOps, kỹ sư hệ thống và nhà phát triển cần xây dựng hệ thống xác thực tập trung cho nhiều ứng dụng.
Yêu cầu và tiền đề
Để triển khai Zitadel trên VPS, bạn cần:
- Một máy chủ VPS chạy Linux (Ubuntu 22.04 hoặc tương đương).
- Đã cài đặt Docker và Docker Compose.
- Đã có tên miền và chứng chỉ SSL (có thể dùng Let's Encrypt).
- Access SSH đến VPS.
- Hiểu biết cơ bản về Docker, OAuth 2.0 và OpenID Connect.
Chúng tôi sử dụng môi trường VPS NVMe từ nhà cung cấp Cloud VPS NVMe cho Docker, Nginx & Database, phù hợp với yêu cầu về hiệu năng và lưu trữ cho các ứng dụng SaaS. Các ứng dụng SaaS cần được tích hợp với Zitadel để sử dụng xác thực tập trung và phân quyền vai trò.
Thực hiện cài đặt Zitadel trên VPS
Để cài đặt Zitadel, tạo file docker-compose.yml trong thư mục làm việc:
version: '3.8'
services:
zitadel:
image: zitadel/zitadel:latest
container_name: zitadel
ports:
- "80:80"
- "443:443"
volumes:
- ./zitadel-data:/zitadel/data
environment:
- ZITADEL_CONFIG_PATH=/zitadel/config/config.yaml
restart: unless-stopped
depends_on:
- postgres
networks:
- zitadel-network
postgres:
image: postgres:15
container_name: zitadel-postgres
environment:
POSTGRES_DB: zitadel
POSTGRES_USER: zitadel
POSTGRES_PASSWORD: zitadelpassword
volumes:
- ./postgres-data:/var/lib/postgresql/data
restart: unless-stopped
networks:
- zitadel-network
networks:
zitadel-network:
driver: bridge
Chạy lệnh để khởi động dịch vụ:
docker-compose up -d
Sau khi khởi động, Zitadel sẽ chạy trên cổng 80 và 443. Bạn có thể truy cập giao diện quản trị qua trình duyệt tại https://your-domain.com. Zitadel sẽ tự động tạo cơ sở dữ liệu PostgreSQL và cấu hình ban đầu.
Tạo người dùng, nhóm và vai trò
Truy cập giao diện quản trị Zitadel để tạo người dùng, nhóm và vai trò. Bước đầu tiên là tạo một người dùng quản trị để quản lý hệ thống. Sau đó, tạo các nhóm như "Admin", "User", "Viewer" và định nghĩa vai trò tương ứng.
Để tạo vai trò phân quyền, vào phần Roles trong giao diện quản trị. Ví dụ, tạo vai trò "Admin" với quyền truy cập toàn bộ tài nguyên, vai trò "User" với quyền đọc và viết, và vai trò "Viewer" chỉ đọc.
Đối với các ứng dụng SaaS, tạo các client OAuth 2.0 để tích hợp. Mỗi ứng dụng sẽ có Client ID và Client Secret để xác thực với Zitadel. Các ứng dụng cần được cấu hình để sử dụng OpenID Connect và gửi yêu cầu xác thực đến Zitadel.
Tích hợp với các ứng dụng SaaS
Để tích hợp một ứng dụng SaaS với Zitadel, cần cấu hình các thông số sau:
- Authorization endpoint:
https://your-domain.com/oauth/v2/authorize - Token endpoint:
https://your-domain.com/oauth/v2/token - UserInfo endpoint:
https://your-domain.com/oauth/v2/userinfo - Client ID và Client Secret: từ Zitadel quản lý client
- Scopes:
openid profile email
Ví dụ, với một ứng dụng Node.js, bạn có thể sử dụng thư viện openid-client:
const { Issuer } = require('openid-client');
const issuer = await Issuer.discover('https://your-domain.com/.well-known/openid-configuration');
const client = new issuer.Client({
client_id: 'your-client-id',
client_secret: 'your-client-secret',
redirect_uris: ['https://your-app.com/callback'],
response_types: ['code'],
});
// Sử dụng client để bắt đầu quy trình xác thực
Chuỗi 5 ứng dụng SaaS có thể được cấu hình tương tự, mỗi ứng dụng có client riêng để quản lý truy cập và phân quyền theo vai trò.
Xác minh và khắc phục sự cố
Để xác minh Zitadel hoạt động đúng:
- Truy cập
https://your-domain.com/.well-known/openid-configurationđể kiểm tra cấu hình OpenID Connect. - Chạy lệnh
docker-compose logs zitadelđể kiểm tra log dịch vụ. - Thử đăng nhập vào giao diện quản trị bằng tài khoản đã tạo.
Nếu gặp lỗi, kiểm tra:
- Chứng chỉ SSL đã được cấp đúng và được cấu hình trên Nginx.
- Đường dẫn reverse proxy từ Nginx đến Zitadel đúng.
- Các cổng 80 và 443 không bị chặn bởi tường lửa.
Tham khảo tài liệu chính thức của Zitadel tại https://zitadel.com/docs để biết thêm chi tiết về cấu hình và tích hợp.
Tham khảo hạ tầng & bài viết liên quan: eBPF và Kernel Tracing: Hướng dẫn kỹ thuật cho DevOps
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%.
VPS-3E
Đã gồm VAT 10%
- CPU: 2 vCPU
- RAM: 4 GB
- SSD: 50 GB NVMe
