SSO pentadbir (OIDC)
Konsol pentadbir menyokong log masuk tunggal melalui mana-mana penyedia OpenID Connect (Google Workspace, Entra ID, Okta, Dex, …) menggunakan aliran Authorization Code dengan PKCE (S256), token CSRF state dan nonce. Ciri ini ikut serta: tanpa konfigurasi, konsol kekal pada aliran kata laluan, tidak berubah.
Mendayakan
Keempat-empat nilai mesti ditetapkan — kurang daripada itu SSO kekal dimatikan:
Env / config.yaml (admin:) | Maksud |
|---|---|
YABANIN_ADMIN_OIDC_ISSUER / oidc_issuer | URL penerbit penyedia, cth. https://accounts.google.com |
YABANIN_ADMIN_OIDC_CLIENT_ID / oidc_client_id | Id klien OAuth |
YABANIN_ADMIN_OIDC_CLIENT_SECRET / oidc_client_secret | Rahsia klien OAuth |
YABANIN_ADMIN_OIDC_REDIRECT_URL / oidc_redirect_url | cth. https://admin.example.com/auth/oidc/callback |
Dokumen penemuan penyedia dan JWKS diambil semasa permulaan; kegagalan dicatat dengan jelas dalam log dan konsol kekal pada aliran kata laluan — tidak sekali-kali lekapan SSO yang separuh berfungsi.
Aliran
GET /auth/oidc/login— mengeluarkan gabunganstate/nonce/PKCE sekali guna dalam kuki HttpOnly+Secure selama 10 minit (SameSite=Lax: panggilan balik tiba sebagai navigasi peringkat atas) dan mengubah hala kepada penyedia.GET /auth/oidc/callback— semakan state dalam masa malar, pertukaran kod dengan pengesah PKCE, pengesahan token ID (tandatangan terhadap JWKS penyedia, penerbit, audiens, tamat tempoh, nonce).- Pemetaan pengguna — gagal tertutup: e-mel yang disahkan mesti sepadan dengan
pengguna pentadbir aktif yang sedia ada. SSO tidak sekali-kali menyediakan akaun, tidak sekali-kali
meluaskan peranan; sesi yang dikeluarkan adalah sama bait demi bait dengan sesi aliran kata laluan
(kuki HMAC yang sama,
IsRootyang sama).
Kuki sekali guna dibersihkan pada setiap hasil panggilan balik — rahsianya sekali guna mengikut reka bentuk.
Kontrak keselamatan
email_verifieddiperlukan. Penyedia yang menegaskan suatu e-mel tanpa mengesahkannya tidak akan melog masuk sesiapa.- Tiada penyediaan akaun automatik. E-mel yang tidak dikenali menerima penolakan yang sama seperti akaun yang dilumpuhkan — tiada enumerasi pengguna, tiada pendaftaran melalui SSO.
- Nonce mengikat token ID kepada log masuk ini. Token yang ditempa untuk sesi lain tidak boleh dimainkan semula.
- Tiada ubah hala terbuka. Kejayaan sentiasa sampai ke
/; ubah hala log masuk sentiasa menyasarkan penerbit yang dikonfigurasi. - Bahagian tempatan e-mel tidak sekali-kali sampai ke log; hanya domain direkodkan apabila pemetaan ditolak.