SSO Pentadbir (SAML 2.0)
Konsol pentadbir turut menyokong log masuk tunggal melalui mana-mana penyedia
identiti SAML 2.0 (Okta, Entra ID, OneLogin, Shibboleth, …). Yang digunakan ialah
penyedia perkhidmatan github.com/crewjam/saml (OP-14). Seperti aliran OIDC,
ciri ini ikut pilihan: tanpa konfigurasi, laluan SAML tidak dipasang
(ia menjawab 404) dan konsol kekal pada aliran kata laluan, tidak berubah.
Mendayakan
| Persekitaran | Wajib | Maksud |
|---|---|---|
YABANIN_SAML_IDP_METADATA_URL | ya | URL dokumen metadata IdP, cth. https://idp.example.com/saml/metadata |
YABANIN_SAML_IDP_METADATA_URL_FILE | tidak | File rahsia Docker/K8s yang menyimpan URL metadata (pemboleh ubah terus diutamakan) |
YABANIN_SAML_ENTITY_ID | tidak | ID entiti SP; lalai kepada asal ACS (https://admin.example.com) |
YABANIN_SAML_ACS_URL | tidak | Perkhidmatan Pengguna Asersi; lalai kepada https://<admin_domain>/auth/saml/acs (daripada YABANIN_ADMIN_DOMAIN) |
YABANIN_SAML_ROLE_ATTR | tidak | Atribut SAML yang direkod dalam entri audit log masuk sebagai asserted_role (maklumat — ia tidak sekali-kali memberikan apa-apa) |
URL metadata diambil sekali semasa permulaan; sebarang kegagalan dicatat dengan jelas, dan konsol kekal pada aliran kata laluan — tidak sekali-kali SSO yang separuh dipasang. Pasangan kunci tandatangan SP adalah sementara bagi setiap proses (IdP mengesahkan asersi, bukan permintaan kami); AuthnRequest ditandatangani dengannya apabila pengikatan memerlukannya.
Endpoint
| Laluan | Tujuan |
|---|---|
GET /auth/saml/metadata | XML metadata SP untuk import di sisi IdP (ID entiti + ACS) |
GET /auth/saml/login | Memulakan aliran: AuthnRequest bertandatangan, ubah hala ke IdP |
POST /auth/saml/acs | Perkhidmatan Pengguna Asersi |
Ketiga-tiganya ialah laluan awam tanpa pengesahan, dan wujud hanya apabila tombol URL metadata ditetapkan.
Aliran
GET /auth/saml/login— membina AuthnRequest (pengikatan HTTP-Redirect, sandaran HTTP-POST yang ditandatangani) dan memeterai ID permintaan dalam kuki sekali guna selama 10 minit, HttpOnly+Secure, yang terhad kepada/auth/saml.- IdP mengesahkan pengguna dan menghantar Respons SAML secara POST ke ACS.
POST /auth/saml/acs— crewjam mengesahkan tandatangan terhadap sijil yang diterbitkan dalam metadata IdP, penerbit, khalayak (ID entiti SP), penerima ACS, setiap cap masa (NotBefore/NotOnOrAfter/IssueInstant, herotan jam yang terhad) dan InResponseTo terhadap kuki aliran. Di samping itu ID asersi dinyahduakan: main semula bait demi bait bagi respons yang masih sah ditolak.- Pemetaan pengguna — gagal-tertutup, sama dengan aliran OIDC: NameID
mesti alamat e-mel (format
emailAddressatau tidak dinyatakan) yang sepadan dengan pengguna pentadbir aktif yang sedia ada. SSO tidak sekali-kali memperuntukkan akaun, tidak sekali-kali meluaskan peranan; sesi yang dikeluarkan adalah bait demi bait sesi aliran kata laluan (kuki HMAC yang sama,IsRootyang sama, 24 jamadminauth.SessionDurationyang sama). - Entri audit
loginditulis dengan entiti IdP, pengguna yang dipetakan dan (apabila dikonfigurasi) atribut peranan yang ditegaskan.
Kontrak keselamatan
- Tiada log masuk yang dimulakan IdP.
AllowIDPInitiatedialah false: asersi tanpa AuthnRequest kami yang sepadan ditolak terus. - Tahan main semula. crewjam mengesahkan InResponseTo; cache ID asersi menolak pembentangan kedua asersi yang sama.
- Pengerasan XML. Respons disahkan secara pergi-balik sebelum dihuraikan;
encoding/xmlGo tidak sekali-kali menyelesaikan entiti luaran atau parameter, dan pengambilan metadata menolak helah DTD/entiti (telah diuji). - E-mel yang tidak dikenali mendapat penolakan yang sama seperti akaun yang dilumpuhkan — tiada penghitungan pengguna, tiada pendaftaran melalui SSO. Bahagian tempatan e-mel tidak sekali-kali sampai ke log; hanya domain direkodkan apabila pemetaan ditolak.
- Tiada ubah hala terbuka. Kejayaan sentiasa tiba di
/. - Atribut peranan yang ditegaskan hanyalah metadata audit; kuasa sentiasa datang daripada rekod pengguna pangkalan data (dan middleware sesi berpagar mengesahkannya semula bagi setiap permintaan).