Skip to main content

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​

PersekitaranWajibMaksud
YABANIN_SAML_IDP_METADATA_URLyaURL dokumen metadata IdP, cth. https://idp.example.com/saml/metadata
YABANIN_SAML_IDP_METADATA_URL_FILEtidakFile rahsia Docker/K8s yang menyimpan URL metadata (pemboleh ubah terus diutamakan)
YABANIN_SAML_ENTITY_IDtidakID entiti SP; lalai kepada asal ACS (https://admin.example.com)
YABANIN_SAML_ACS_URLtidakPerkhidmatan Pengguna Asersi; lalai kepada https://<admin_domain>/auth/saml/acs (daripada YABANIN_ADMIN_DOMAIN)
YABANIN_SAML_ROLE_ATTRtidakAtribut 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​

LaluanTujuan
GET /auth/saml/metadataXML metadata SP untuk import di sisi IdP (ID entiti + ACS)
GET /auth/saml/loginMemulakan aliran: AuthnRequest bertandatangan, ubah hala ke IdP
POST /auth/saml/acsPerkhidmatan Pengguna Asersi

Ketiga-tiganya ialah laluan awam tanpa pengesahan, dan wujud hanya apabila tombol URL metadata ditetapkan.

Aliran​

  1. 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.
  2. IdP mengesahkan pengguna dan menghantar Respons SAML secara POST ke ACS.
  3. 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.
  4. Pemetaan pengguna — gagal-tertutup, sama dengan aliran OIDC: NameID mesti alamat e-mel (format emailAddress atau 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, IsRoot yang sama, 24 jam adminauth.SessionDuration yang sama).
  5. Entri audit login ditulis dengan entiti IdP, pengguna yang dipetakan dan (apabila dikonfigurasi) atribut peranan yang ditegaskan.

Kontrak keselamatan​

  • Tiada log masuk yang dimulakan IdP. AllowIDPInitiated ialah 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/xml Go 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).