Аэнтерпрайз SSO
AiHummer ауправлеиҩцәеи аха-ныҟәаҩцәеи ируентификациазуеит шәара шәиаентра-провайдер аҟны. Ихадоу, апродукциатә-мҩа аконтроль — OIDC ауп, уи аадминтә API ахьчоит; SAML, LDAP/AD насгьы SCIM апровизионра нагӡоуп, насгьы алокалтә аутентификациа дәынтәтә IdP ыҟамкәа аиҿкаарақәа рзы.
OIDC аадминтә API ахьчоит
OIDC — deny-by-default ауп насгьы /v1/admin/* ахьчоит. Уи аконфигурациазҵа AIHUMMER_OIDC_ISSUER ала (насгьы иадҳәалоу аклиент арегулиаразақәа).
# /home/.aihummer/etc/gateway.env
AIHUMMER_OIDC_ISSUER=https://idp.example.com/Иҟоуп oidc-setup runbook (docs/runbooks/oidc-setup.md) аклиент арегистрациеи аиссиуер аиқәыршәареи рымҩақәа аазырԥшуа.
[!DANGER] OIDC аконфигурациазмҵакәа, аадминтә API аидентификациазы dev headers ируадаҩуеит. Уи арежим алокалтә ишьҭаргылара мацара азоуп — зныкгьы аадминтә эндпоинт интернетахь иаашәымҭал OIDC (ма егьырҭ ишьақәыргылоу аутентификациа) аԥхьа иҟамкәа. Ишьақәышәыргыл
AIHUMMER_OIDC_ISSUERалокалтә ишьҭаргыларада зегьы рҟынӡа.
[!TIP] OIDC иацышәырыхь IP-аидбжьара ахьыԥшра насгьы иргат API-калитқәа убри аадминтә анеира аиентра, асеть насгьы апривилегиа реицзыршәара ала ииашо ала.
SAML
SAML азнызаҵә анеира (single sign-on) нагӡоуп, истандарту аусура-провайдер эндпоинтқәа аазырԥшуа:
| Endpoint | Ахықәкы |
|---|---|
GET /saml/metadata |
Аусура-провайдер аметадан шәара шәIdP азы. |
POST /saml/acs |
Assertion Consumer Service — SAML аҭак идыркылоит. |
GET /saml/login |
SAML анеира амҩа иалагоит. |
[!NOTE] SAML нагӡоуп аха IdP-цыԥхьаӡа зегьы рыла ихархәарала ишьақәырҕәҕәам. Иуадаҩ алас ала и аус ауеит насгьы ишьақәыргыла шәара шәиаентра-провайдер аҟны апродукциа аҿы абжьара аԥхьа.
LDAP / Active Directory
LDAP/AD аутентификациа нагӡоуп аха-ныҟәаҩцәа адиректориатә сервер аҟны зуентификациазуа аиҿкаарақәа рзы.
[!NOTE] SAML еиԥш, LDAP/AD нагӡоуп аха адиректориатә конфигурациақәа зегьы рыла ихархәарала ишьақәырҕәҕәам. Ишьақәыргыла уаргьы уадиректориа аҟны аладылара аԥхьа.
SCIM апровизионра
SCIM шәара шәIdP азирхоит ахаԥхьара ала аха-ныҟәаҩцәа рынагалареи рыдәылгареи, истандарту SCIM v2 ныҟәаҩ эндпоинтқәа рыла:
| Endpoint | Ахықәкы |
|---|---|
GET /scim/v2/Users |
Иргоу ныҟәаҩцәа рхьыԥшра / рыԥшаара. |
POST /scim/v2/Users |
Ныҟәаҩ аԥҵара. |
GET /scim/v2/Users/{id} |
Зныкаҵә ныҟәаҩ аԥхьара. |
PUT /scim/v2/Users/{id} |
Ныҟәаҩ аиҭашьақәыргылара. |
DELETE /scim/v2/Users/{id} |
Ныҟәаҩ адәылгара. |
SCIM ала апровизионра ныҟәаҩ адиректориа шәара шәIdP аицзеиԥшуеит, аналагалаҩцәеи адәылҵцәеи аадминтә усурада ишааарԥшу.
Алокалтә аутентификациа
Дәынтәтә IdP ыҟамкәа, AiHummer алокалтә аутентификациа иадгылоит. Иҿыцу адан-база аҿы агейтуэй иаԥнырԥшуеит зныкатәи admin ажәамаӡа алогахь аиҿкаара актәи аналага; уаннеи насгьы иуԥсах иласы. Алокалтә аутентификациа иабзахоуп аماҷ ма еиԥырԥшоу аиҿкаарақәа рзы, аха IdP змоу аиҿкаарақәа рзы OIDC иаанхоит ииашоу апродукциа амҩа.
Аподход алхра
| Амеханизм | Изаԥсоу | Астатус |
|---|---|---|
| OIDC | Аадминтә API ахьчара иарбанзаалак ажәынтәла иҟам ишьҭаргылара аҿы | Ииашоу апродукциа амҩа |
| SAML | SAML SSO ала истандартизациазуа аэнтерпрайзқәа | Нагӡоуп; шәара шәIdP аҟны ишьақәыргыла |
| LDAP / AD | Адиректориа ишьаҭоу аутентификациа | Нагӡоуп; шәара шәдиректориа аҟны ишьақәыргыла |
| SCIM | IdP аҟынтәи иавтоматизациоу ныҟәаҩ апровизионра | Нагӡоуп (SCIM v2 Users) |
| Алокалтә аутентификациа | IdP ыҟамкәа аماҷ ма еиԥырԥшоу аиҿкаарақәа | Иалоу |
Анахь шәаҟәҵалоит
- RBAC & иргат API-калитқәа — шәара шәIdP зуентификациазуа аидентра рауторизациа.
- Асеть, аудит & аиаайыртә режим — аадминтә анеира асеть ала аанкылара насгьы аудит-ҭаара аиқәырхара.
- Амаӡақәа равлеи (vault) — акредентиалқәеи атокенқәеи ахьынхо.