AiHummer
Аԥсшәа
Аиалаҵара
v1.0.x
{ }Swagger

Актәи алогин

v1.0.x · ирҿыцуп 2026-07-07

Актәи аамҭала AiHummer аӡбахьысыхуа adatabaza иаҿагыланы анадыргылакь, уи иаргылоит ак admin аккаунт насгьы акаамҭатәи пароль ~/.aihummer/etc/initial-admin-password.txt файлахь инанагоит (аиԥшра 0600). Шәара иашәхархәоит уи акала алогинразы, нас иласны иашәԥсахуеит. Абри адаҟьа иануп абри актәи алогин насгьы уи апродукшн азы шԥашәырыцклаԥшуа.

Иашәырба акаамҭатәи пароль

Апароль ажурналахьы иҵыхәтәом. Аӡбахьысыхуа adatabaza аҟны гейтуэй анадыргылараан иаргылоу admin пароль инсталл рут аҩныҵҟатәи файлахь инанагоит — иашәырԥхьа уи:

cat ~/.aihummer/etc/initial-admin-password.txt

Маҵзура ажурнал аарԥшуеит ак банер мацара — INITIAL ADMIN CREATED — sign in at /admin/ and change the password — файл амҩаду аманы (password_file=…), апароль хаҭала акымкуа. Апароль ажурналахьы иҵыхәтәоит фоллбек ҳасабла мацара, файл иаԥхьаӡатәымзаргьы.

[!WARNING] Апароль афайл секрет ҳасабла иашәырхьча: уи актәи алогин мацара азы ыҟоуп. Иалогинны апароль иашәԥсахыз ашьҭахь, афайл иашәырцәгьа:

rm ~/.aihummer/etc/initial-admin-password.txt

Иалогинтә admin аиԥш

Иаартла аадминистраторатә Web UI насгьы иалогинтә admin насгьы файл аҟынтәи пароль аманы:

http://localhost:8781/

Аадминистраторатә Web UI ауп хазтәи, приваттә алисн (дефолт :8781, AIHUMMER_WEBUI_ADDR), рут амҩа / аҟны иаанарԥшуа насгьы иделеиа акызаара интерфейс-мацара ахь еиқәыршәаны иамазароуп. Уи акгьы иҟаӡам ажәлартә гейтуэй порт аҿы: :8780 иану API, аиԥшьара, WS/SSE насгьы аиҵаху трафик, насгьы наӡашьҭа админ UI аадгылом (/admin насгьы /v1/admin азы уи 404 игьежьуеит). Гейтуэй адәныҟатә ароутинг ихатә ргылоу edge-router ала инапхгара ауеит — адәныҟатә nginx аиҿкаара аҭахым.

Иласны иаԥсахтә апароль

Актәи алогин ашьҭахь абас акала, бутстрап пароль админ UI аҟынтә иашәԥсахла, нас initial-admin-password.txt файл иашәырцәгьа. Еицгьы пароль иаргьежьтә иадгылоу CLI аҟынтә иашәырԥсахлар алшоит:

aihummer set-password
# ма
aihummer admin-password

set-password иаҭахуп AIHUMMER_DATABASE_URL — уи иашәхаргыла инсталл издәықылаз ахархәаҩ ихьӡала, ма ~/.aihummer/etc/gateway.env аҟынтәи environment аманы.

[!DANGER] Бутстрап пароль абас акала иашәамааныжьуеит, насгьы апароль афайл апродукшн хост аҿы иашәамааныжьуеит. Бутстрап admin аккаунт хадоу аадминистраторуп — деилаҳара уи афайл иаԥхьаны /admin/ иҟазааша иамоу зегьы хадоу анапхгара иамоуп.

Ишәрҽыхьчала интерфейс аҟны

Иалогинуа ашьҭахь админ UI аҟны акала ориентирқәак:

  • Анавигациа — аҵлақәа hash-адресқәа рыла аартуп (/#channels, /#settings…), убри аҟынтә адаҟьазаалакь напрямую алинк ала аартра ауеит насгьы «Ашьҭахь» батон ала аԥсахра ауеит.
  • Ҩаҟаратә насгьы аҩаратә тема — арынтуҵ/амза тумблер ахед аҟны; иалху абраузер аҟны иаанхоит.
  • Абренди амаскоти — логотип аҟны «Ai» ажәамаанақәа абренд-акцент иманы, насгьы иҵыхәтәым аҭагылазаашьақәа, аиҿартәара мастери алогин аекрани — рахь амаскот иаауеит: фенёк ихьӡ Хам.
  • «Аккаунт» адаҟьа — ихатә пароль аԥсахра, алогаут насгьы ҩ-фактортә аутентификациа аиҿкаара: TOTP-аплагали, passkey (WebAuthn) насгьы аиҭашьақәыргылара кодқәа.

Иашәырхьчала админ ахьынӡара

Ихатәла, /admin/* ахьынӡара арҿиаратә хедерқәа иадгылоит энтерпрайз аутентификациа issuer иргылам акәзар — уи лаптоп аҟны ииашоуп, аха иаартоу хост аҿы шәарҭарада иҟоуп. Апродукшн дислоизаалакь азы, /admin/* иашәырхьчала аутентификациа issuer аманы, насгьы иашәамдалеит уи ада.

[!IMPORTANT] AIHUMMER_OIDC_ISSUER иаргылатә (ма LDAP/SAML иаиҿартәатә) админ UI адышәдалазааӡа. Уи ада, админ эндпоинтқәа арҿиаратә хедерқәа иадгылоит насгьы иҵабыргу асеть аҟынтә наӡашьҭа изаамдатәам.

Иаргылатә энтерпрайз SSO (апродукшн)

Апродукшн азы, аутентификациа шәара ишәхымоу идентификациа-провайдер ахь иашәгата. AiHummer иадгылоит энтерпрайз SSO, бутстрап локалтә аккаунт уаха-сахьатә амҩа акымкуа брейк-гласс фоллбек иҟалазарц:

  • OIDC — иахьчоит /v1/admin/* (deny-by-default).
  • SAML — федерациа /saml/metadata, /saml/acs, /saml/login ала.
  • LDAP / Active Directory — директориа-иадгылоу алогин.
  • SCIM — иаргылоу ахархәаҩтә аиҿартәара /scim/v2/Users аҿы.

SSO анадыргылакь, локалтә admin аккаунт уаха-сахьатә ахархәара иашәырмаҷла ма иашәырцәгьала насгьы шәара ишәхымоу IdP агруппақәеи аролқәеи рахь ишәгата.

Иахьынтә ашьҭахь