AiHummer
Türkmençe▾
GirmekŞahsy kabinet
v1.1.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Başlangyç/Ilk girmek

Ilk girmek

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

AiHummer birine garşy ilkinji gezek öňe barýar boş maglumatlar bazasy, ol birini işe salýar admin hasap we ýazýar başlangyç parol üçin ~/.aihummer/etc/initial-admin-password.txt (režim 0600). Muny bir gezek girmek üçin ulanylýar, soňra derrew ony üýtgedýärsiňiz. Bu sahypa ilkinji girmegi we ony önümçilige taýýar etmek usulyny düşündirýär.

Başlangyç paroly tap

Şifresi jurnala çap edilmedi. Boş maglumatyň bazasynda geçelge döredilen ýazgyny ýazýar admin Gurnama köküniň içindäki faýlyň paroly işe girende — ony oka:

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

Hyzmat jurnaly diňe banneri görkezýär INITIAL ADMIN CREATED — sign in at /admin/ and change the password bilen ýol faýla (password_file=…), parol onuň özi däl. Faýl ýazyp bolmadyk ýagdaýynda parol diňe ätiýaç üçin hasaba alynýar.

[!WARNING] Açar söz faýlyny syry ýaly kabul ediň: ol diňe ilkinji girmek üçin bar. siz girdiňiz we paroly üýtgetdiňiz, faýly öçür:

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

Admin hökmünde giriň

Admin Web UI-ny açyň we bilen giriň admin hem-de faýldan parol:

http://localhost:8781/

Admin Web UI ayry, şahsy diňleýji (başlangyç :8781, AIHUMMER_WEBUI_ADDR), kök ýoly boýunça hyzmat edildi / hem-de iň gowusy diňe içki interfeýse baglanyşykly. Ol däk ynha jemgyýetçilik geçelge portunda: :8780 API, juplama, WS/SSE we gelýän traffigi alyp barýar we hemişe admin UI-ni hyzmat etmeýär (ol gaýtarýar 404 üçin /admin we /v1/admin). Darwaza öz içine gurlan çägeli-router arkaly daşarky ugrukdyryşlylygy üpjün edýär — siz konfigurasiýa etmeli daşarky nginx ýok.

Paroly derrew üýtgediň

Ilkinji girişiňizden soň, dolandyryş interfeýsinden bootstrap parolyny üýtgediň, soňra öçüriň initial-admin-password.txt faýl. Şeýle hem gurnalan CLI-den paroly täzeden kesgitlemek mümkin:

aihummer set-password
# or
aihummer admin-password

set-password zerurlyklar AIHUMMER_DATABASE_URL — ony gurnama ulanyjysy üçin ýerine ýetiriň ýa-da şondan gurşaw bilen ~/.aihummer/etc/gateway.env.

[!DANGER] Bootstrap parolyny şol ýerde goýmaň we paroly hem goýmaň önümçilik serwerinde ýerleşýän faýl. Başlangyç ýükleýji admin hasap doly administrator — şol faýly okaýan we öňe barýan adam /admin/ doly eýe gözegçilik.

Özüňe ýol tap

Hasaba girenden soň administratiw UI-de käbir ýagdaý belgileri:

  • Nawigasiýa — bölümler hash salgylarynda açylýar (/#channels, /#settings…), şonuň üçin islendik sahypany göni baglanyşyk arkaly açmak we gaýtadan girip görmek bolýar Yza gaýtamak düwmesi.
  • Gara we ýeňil tema — baş sahypadaky gün/ajak geçiş düwmesi; saýlaw brauzerde ýadyňda saklanan.
  • Brend we maskot — Logodaky “Ai” harplary markanyň ündüsini batyrýar, we boş ýagdaýlar, gurnama kömegiçi we giriş ekrany maskot bilen aýratynlyk görkezýär — Hamy atly fennek tulkysy.
  • «Hasap» sahypasy — öz paroluňy üýtget, hasabyňdan çykyň we sazla iki faktoryň tassyklanmasy: TOTP programmasy, geçiş açarlary (WebAuthn) we dikeltme kodlar.

Admin ýüzüni howpsuz edin

Özüniň özi /admin/* surface entegre edilmedik ulgama ygtyýarlylyk çykarýan ýok wagty ösüş başlyklaryna ynanýar — bu noutbukda oňat, ýöne açyk hozda howplydyr. Herhangi bir önümçilige goýlanda goramagy üpjün ediň /admin/* bir awtorizasiýa beriji bilen we onsuz anyk ýerine çykarmakdan saklaň.

[!IMPORTANT] Toplum AIHUMMER_OIDC_ISSUER (ýa-da administratory açmazdan öň LDAP/SAML sazla) Ulanyjy interfeysi. Muny bolmadyk ýagdaýynda, /v1/admin/* API dev başlyklaryna ynanýar — ýerli administrator parol diňe hususy Web UI girişini öňüni alýar, däk dolandyryjy API — şonuň üçin beýlekiler Ulgamlardan beýlekilerden çaklama ýagdaýynda nokatlar hiç haçan ýetip bolmaz.

Korhana SSO-ni aktiwleşdiriň (önümçilik)

Önümçilik üçin tassyklamany şahsyýet üpjünçiniňize göçüriň. AiHummer kärhana SSO-ny goldaýar, şonuň üçin başlanma ýerli hasap gündelik ýol bolman, krizis ýagdaýyndaky alternatiw bolýar:

  • OIDC — goraýar /v1/admin/* (öneki-den ret et)
  • SAML — federasiýa arkaly /saml/metadata, /saml/acs, /saml/login.
  • LDAP / Aktiw Diräk — bukja tarapyndan goldanylýan girmek.
  • SCIM — awtomatlaşdyrylan ulanyjy üpjünçiligi öňünde /scim/v2/Users.

SSO ýerine ýetirilenden soň, ýerli gündelik ulanyşy çäklendiriň ýa-da ýatyrmak admin hasap we özüňe daýan IdP-niň toparlary we wezipeleri.

Eger işlemän bolsa

  • Açar söz faýly ýok — ol diňe bir ýerde döredilýär boş maglumatlar bazasy ilki bilen başlaň. Eger maglumatlar bazasy eýýäm işjeňleşdirilen bolsa, täzeden ýükläni ulan: aihummer set-password (zerurlyk) AIHUMMER_DATABASE_URL).
  • http://localhost:8781/ açylmaýar — bu hususy Web UI porty; barlaň gynançlygyna hyzmat işleýär (systemctl status aihummer-gateway) we seniň urmak :8781, jemgyýet däl :8780.
  • /admin 404 gaýtarýar — köpçülik üçin niýetlenen :8780 portunda bu garaşylýan ýagdaý: admin UI diňe hususy Web UI-de ýaşýar (:8781).
  • Üýtgedilen paroly unutdym — ony bilen täzeden sal aihummer set-password, hökmünde işle gurnamagy amala aşyran ulanyjy.
  • Admin UI-ni başga bir enjamdan açmak — açyk goýma /admin/* -a, -e tassyklama beriji bolmadyk ynamsyz tor; gurnadylar AIHUMMER_OIDC_ISSUER (ýa-da Ilkinji hökmünde LDAP/SAML)

Indi nire?