Kärhana SSO
AiHummer administratori we ulanyjylary şahsyýet üpjün edijäňiz bilen tassyklap biler. Esasy, önümçilik-ýoly dolandyryşy OIDC, admin API-ni goraýan; SAML, LDAP/AD we SCIM berilmegi hem amala aşyrylýar, öňbaryjy hökmünde lokal tassyklama deşer IdP bolmadyk düzedişler üçin.
Dereje: corporate SSO (OIDC/SAML/LDAP/AD/SCIM) tölenen tarapyndan girizilýär Kärhana tier — bu mugt/Community platformasynyň bir bölegi däl. Her bir tapgyrda ýerli tassyklama bar.
OIDC administratiw API-ni gorap saklaýar
OIDC bu standart bozulýan we goramagy üpjün edýän dolandyryş /v1/admin/*. Ony bilen sazla AIHUMMER_OIDC_ISSUER (we degişli müşderi sazlamalary).
# /home/.aihummer/etc/gateway.env
AIHUMMER_OIDC_ISSUER=https://idp.example.com/Bar bir oidc-gurnama iş kitabçasy (docs/runbooks/oidc-setup.md) müşderiniň registrasiýa edilmegini we çykarýjynyň birikdirilmegini görkezýän gidişlik.
[!DANGER] OIDC sazlanmadyk ýagdaýynda, administratoriň API ynanýar önläp baş sahypa şahsyýet üçin. Şu re mode diňe ýerli ösdürijilik üçin niýetlenendir — heç haçan administrasiýa nokadyny açma munuň öňünde OIDC (ýa-da başga ýerine ýetirilen awtentifikasiýa) bolmazdan internet. Sazlamak
AIHUMMER_OIDC_ISSUERislenmein ýerli bolmadyk her-hili ýerleşdirişden öň.
[!TIP] OIDC bilen gatlak IP rugsat sanawy we çägelenen API açarlary şeýlelik bilen administrasiýa girişi bölünýär şahsyýet, tor we artykmaçlyk bilelikde.
SAML
SAML bölünjek giriş amala aşyrldy, standart hyzmat üpjün ediji nokatlaryny açýar:
| Uly nokat | Maksat |
|---|---|
GET /saml/metadata |
Siziň IdP üçin hyzmat üpjün edijiniň metadata maglumatlary. |
POST /saml/acs |
Tassyklaýyş Işleýji Gullugy — SAML jogabyny alýar. |
GET /saml/login |
SAML giriş akymyny başlatýar. |
[!NOTE] SAML bu berraýlan, emma täzeden doly syn edilmedi her bir IdP garşy. Müňe ony elýeterli edip, öň öňüňizde belli şahsyýet üpjün edijiňize garşy barlaň önümçilikde oňa daýanmak.
LDAP / Aktiw Diräk
LDAP/AD tassyklamasy ulanyjylary katalog servery bilen tassyklamak üçin gurşawlarda durmuşa geçirilýär.
[!NOTE] SAML bilen bir hatarda, LDAP/AD amala aşyryldy, emma täzeden doly syn edilmedi hemmesinde papka sazlamalary. Ony çykarylmadan öň öz papkaňyzda synap görüň.
SCIM üpjünçiligi
SCIM siziň IdP-niňiziň ulanyjylary awtomatiki hökmünde üpjün etmegine we ýok edip bilmegine mümkinçilik berýär, standart SCIM v2 ulanyjy nokatlary arkaly:
| Uly nokat | Maksat |
|---|---|
GET /scim/v2/Users |
Belliklenen ulanyjylary sanawlaň / soraglaň. |
POST /scim/v2/Users |
Ulanyjy döret. |
GET /scim/v2/Users/{id} |
Bir ulanyjyny okaň. |
PUT /scim/v2/Users/{id} |
Ulanyjyny täzeläň. |
DELETE /scim/v2/Users/{id} |
Ulanyjyny hyzmatdan aýyrmak. |
SCIM arkaly üpjün etmek ulanyjy katalogyny sizin IdP bilen sinhron şaý edýär, şonuň üçin goşulanlar we çykýanlar kolinear administratiw işleri etmän aks etdirilýär.
Ýerli tassyklama
Daşky IdP ýok wagtynda, AiHummer goldaýar lokal tassyklama. Täze maglumatlar bazasynda geçelge bir gezeklik ýazgy çap edýär admin Ilkinji işe girýän wagty hasabyň paroly; tiz wagtdan login edip ony üýtgetmeli. Lokal tassyklama kiçi ýa-da izolýasiýa edilen ýerleşdirişler üçin laýyk, ýöne IdP bolan guramalar üçin OIDC iň gowy önümçilik ýoly bolmagy dowam edýär.
Çemeleşmegi saýlamak
| Mekanizm | Iň gowy | Status |
|---|---|---|
| OIDC | Herhangi bir ýerli däl ýerleşdirişde admin API-ni goramak | Maslahat berlen önümçilik ýoly |
| SAML | Kärhanalar SAML SSO boýunça standartlaşdyryldy | Işjeňleşdirildi; IdPňiz bilen barlaň |
| LDAP / AD | Katalog esasynda tassyklama | Ýerine ýetirildi; katalogyňyza görä barlaň |
| SCIM | IdP-dan awtomatiki ulanyjy üpjünçiligi | Işlenildi (SCIM v2 Ulanyjylary) |
| Ýerli tassyklama | IdP-siz kiçi ýa-da beýlekilerden tapawutlanýan ýerleşdirişler | Gurlan |
Indi nire?
- RBAC we çäklenen API açarlary — şahsyýetleri tassyklamak siziň IdPňiz tassyklady.
- Tor, barlag we howa bilen aýrylan — gapy tor arkaly administratiw elýeterlilik we barlag ýazgyny saklamak.
- Gizlinlikler gutusy — şahsyýet tassyklamalarynyň we tokenleriň ýerleşýän ýeri.