AiHummer
Türkmençe▾
Gir
v1.0.x▾
v1.0.xstable
{ }Swagger
Başlangyç/Ilkinji Giriş

Ilkinji Giriş

v1.0.x · täzelendi 2026-07-07

AiHummer boş maglumat bazasyna garşy ilkinji gezek başlanda, ýeke admin hasabyny bootstrap edýär we bir gezeklik paroly ~/.aihummer/etc/initial-admin-password.txt-e ýazýar (0600 režimi). Siz ony bir gezek girmek üçin ulanýarsyňyz, soňra derrew üýtgedýärsiňiz. Bu sahypa şol ilkinji girişi we ony önümçilik üçin nähili berkitmelidigini gösterip geçýär.

Bir gezeklik paroly tapmak

Parol loga çap edilmeýär. Boş maglumat bazasynda gateway başlanyşda döredilen admin parolyny gurnama köküniň içindäki faýla ýazýar — ony okaň:

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

Hyzmat žurnaly diňe faýlyň ýoluny (password_file=…) görkezýän INITIAL ADMIN CREATED — sign in at /admin/ and change the password baннerini görkezýär, parolyň özüni däl. Parol diňe faýl ýazylyp bilinmedik ýagdaýda ätiýaçlyk hökmünde loga ýazylýar.

[!WARNING] Parol faýlyna syr ýaly garaň: ol diňe ilkinji giriş üçin bar. Giriş edip, paroly üýtgedeniňizden soň, faýly öçüriň:

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

Admin hökmünde giriş

Admin Web UI-ni açyň we admin we faýldan alnan parol bilen giriň:

http://localhost:8781/

Admin Web UI aýratyn, hususy diňleýjidir (default :8781, AIHUMMER_WEBUI_ADDR), kök ýolunda / hödürlenýär we ideal ýagdaýda diňe içerki interfeýse baglanýar. Ol köpçülik gateway portunda däl: :8780 API-ni, jübütleşdirmäni, WS/SSE-ni we gelýän traffigi göterýär we admin UI-ni hiç haçan hödürlemeýär (/admin we /v1/admin üçin 404 gaýtarýar). Gateway daşarky marşrutlaşdyrmany öz içki edge-router-i arkaly özi dolandyrýar — sazlamaly daşarky nginx ýok.

Paroly derrew üýtgetmek

Bootstrap parolyny ilkinji girişiňizden soň derrew admin UI-den üýtgediň, soňra initial-admin-password.txt faýlyny öçüriň. Ony şeýle hem birleşdirilen CLI-den täzeläp bilersiňiz:

aihummer set-password
# ýa-da
aihummer admin-password

set-password AIHUMMER_DATABASE_URL-i talap edýär — ony gurnama ýerine ýetirilen ulanyjy hökmünde ýa-da ~/.aihummer/etc/gateway.env-däki gurşaw bilen işlediň.

[!DANGER] Bootstrap parolyny ýerinde galdyrmaň, we parol faýlyny önümçilik hostynda goýmaň. Bootstrap admin hasaby doly administrator — şol faýly okap /admin/-e ýetýän islendik adam doly gözegçilige eýe bolýar.

Töwerekde ugur alyň

Girişden soň admin UI-däki birnäçe ugur-belgi:

  • Nawigasiýa — bölümler hash salgylarynda açylýar (/#channels, /#settings…), şonuň üçin islendik sahypany göni baglanyşyk arkaly açyp, Yza düwmesi bilen gaýdyp bolýar.
  • Garaňky we açyk tema — kelläýindäki gün/aý geçirijisi; saýlaw brauzerde ýatda saklanýar.
  • Marka we maskot — logodaky “Ai” harplary marka reňk urgusyny göterýär, boş ýagdaýlarda, sazlaýyş ussadynda we giriş ekranynda Ham atly fenek tilki maskoty görünýär.
  • «Hasap» sahypasy — öz parolyňyzy üýtgediň, çykyň we iki faktorly autentifikasiýany (TOTP programmasy, passkey-ler (WebAuthn) we dikeltme kodlary) sazlaň.

Admin meýdanyny goramak

Öz-özünden, /admin/* meýdany hiç hili korporatiw auth issuer konfigurirlenmedik bolsa, işläp düzüş başlyklaryna (development headers) ynanýar — bu noutbukda gowy, emma açyk hostda howpsuz däl. Islendik önümçilik ýerleşdirmesi üçin /admin/*-i auth issuer bilen goraň we ony onsuz açmaň.

[!IMPORTANT] Admin UI-ni açmazdan ozal AIHUMMER_OIDC_ISSUER-i belläň (ýa-da LDAP/SAML konfigurirläň). Onsuz admin nokatlary işläp düzüş başlyklaryna ynanýar we hiç haçan ynamsyz toruň üsti bilen elýeterli bolmaly däl.

Korporatiw SSO-ny işjeňleşdirmek (önümçilik)

Önümçilik üçin autentifikasiýany öz identifikasiýa üpjünçiňize geçiriň. AiHummer korporatiw SSO-ny goldaýar, şeýdip bootstrap ýerli hasaby gündelik ýoldan däl-de, adatdan daşary çykalga ätiýaçlygy bolýar:

  • OIDC — /v1/admin/*-i goraýar (deny-by-default).
  • SAML — /saml/metadata, /saml/acs, /saml/login arkaly federasiýa.
  • LDAP / Active Directory — kataloga esaslanýan giriş.
  • SCIM — /scim/v2/Users-de awtomatlaşdyrylan ulanyjy üpjünçiligi.

SSO ýerine ýetenden soň, ýerli admin hasabynyň gündelik ulanyşyny çäklendiriň ýa-da ýatyryň we IdP-iňiziň toparlaryna we rollaryna bil baglaň.

Indiki nirä