Đăng nhập một lần
Libre WebUI hỗ trợ OAuth GitHub/Hugging Face và mọi nhà cung cấp OpenID Connect qua OIDC chung. Người dùng OAuth vẫn được lưu cục bộ và nhận vai trò user; OIDC có thể ánh xạ vai trò/nhóm từ claim.
GitHub OAuth
Tạo ứng dụng OAuth trong GitHub Developer Settings.
Cấu hình nằm trong .env của backend.
http://localhost:3001/api/auth/oauth/github/callback
https://your-domain.example/api/auth/oauth/github/callback
GITHUB_CLIENT_ID=...
GITHUB_CLIENT_SECRET=...
GITHUB_CALLBACK_URL=https://your-domain.example/api/auth/oauth/github/callback
GitHub yêu cầu phạm vi user:email; tên người dùng có tiền tố gh_.
Hugging Face OAuth
Cấu hình nằm trong .env của backend.
http://localhost:3001/api/auth/oauth/huggingface/callback
https://your-domain.example/api/auth/oauth/huggingface/callback
HUGGINGFACE_CLIENT_ID=...
HUGGINGFACE_CLIENT_SECRET=...
HUGGINGFACE_CALLBACK_URL=https://your-domain.example/api/auth/oauth/huggingface/callback
Tên người dùng có tiền tố hf_.
OIDC chung
Hỗ trợ Keycloak, Authentik, Authelia, Okta, Entra ID, Google Workspace và các nhà cung cấp có tài liệu khám phá. Luồng dùng PKCE (S256), trạng thái CSRF, nonce và JWKS.
Cấu hình nằm trong .env của backend; tên người dùng mới có tiền tố oidc_.
https://your-domain.example/api/auth/oauth/oidc/callback
OIDC_ISSUER_URL=https://id.example.com/realms/main
OIDC_CLIENT_ID=libre-webui
OIDC_CLIENT_SECRET=...
OIDC_DISPLAY_NAME=Example SSO
# Require a verified email in one of these domains
OIDC_ALLOWED_EMAIL_DOMAINS=example.com,example.org
# Grant/remove the admin role based on a group claim on every login
OIDC_GROUP_CLAIM=groups
OIDC_ADMIN_GROUPS=libre-admins
# Reconcile Libre group memberships with the group claim on every login
OIDC_SYNC_GROUPS=true
Danh tính liên kết bằng sub. Email đã thuộc tài khoản cục bộ không được ghép âm thầm. Với OIDC_SYNC_GROUPS=true, claim điều khiển thành viên nhóm Libre có tên phù hợp.
Cài đặt chung
BASE_URL=https://your-domain.example
CORS_ORIGIN=https://your-domain.example
Nếu callback không đặt rõ, Libre WebUI tạo từ BASE_URL.
Giới hạn
Chưa có SAML hoặc SCIM. Danh sách miền và ánh xạ vai trò/nhóm chỉ dành cho OIDC chung; GitHub/Hugging Face luôn tạo user.
Khắc phục sự cố
Nút OAuth không hoạt động: kiểm tra ID, bí mật, và khởi động lại backend.
Callback bị từ chối: URL phải khớp chính xác.
Quyền thông thường: nâng vai trò qua giao diện admin.