Skip to main content

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_issuerURL penerbit penyedia, cth. https://accounts.google.com
YABANIN_ADMIN_OIDC_CLIENT_ID / oidc_client_idId klien OAuth
YABANIN_ADMIN_OIDC_CLIENT_SECRET / oidc_client_secretRahsia klien OAuth
YABANIN_ADMIN_OIDC_REDIRECT_URL / oidc_redirect_urlcth. 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​

  1. GET /auth/oidc/login — mengeluarkan gabungan state/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.
  2. 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).
  3. 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, IsRoot yang sama).

Kuki sekali guna dibersihkan pada setiap hasil panggilan balik — rahsianya sekali guna mengikut reka bentuk.

Kontrak keselamatan​

  • email_verified diperlukan. 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.