AiHummer
Azərbaycanca▾
Daxil olŞəxsi kabinet
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Başlanğıc/İlk giriş

İlk giriş

v1.0.x · yeniləndi 2026-07-07

AiHummer-in ilk dəfə işə düşməsi boş verilənlər bazası, o tək birini işə salır admin hesabı və yazır başlanğıc şifrə ilə ~/.aihummer/etc/initial-admin-password.txt (rejim 0600). Siz onu bir dəfə daxil olmaq üçün istifadə edirsiniz, sonra dərhal dəyişdirirsiniz. Bu səhifə həmin ilk giriş və onu istehsalata uyğun möhkəmlətmək yollarını izah edir.

İlkin parolu tapın

Şifrədir jurnala çap olunmayıb. Boş bir verilənlər bazasında keçid yaradılanları yazır admin quraşdırma kökündəki fayla başlanğıcda parol — onu oxu:

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

Xidmət jurnalı yalnız banneri göstərir INITIAL ADMIN CREATED — sign in at /admin/ and change the password ilə yol fayla (password_file=…), özü şifrə deyil. Şifrə yalnız fayl yazıla bilmədiyi halda ehtiyat vasitə kimi qeyd olunur.

[!WARNING] Şifrə faylını bir sirr kimi idarə edin: o, yalnız ilk giriş üçün mövcuddur. Bir dəfə siz daxil olmusunuz və şifrəni dəyişdirmisiniz, faylı sil:

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

Admin olaraq daxil olun

Admin Veb İstifadəçi İnterfeysini açın və daxil olun admin və fayldan şifrə:

http://localhost:8781/

Admin Web UI bir ayrı, şəxsi dinləyici (dəyişilməz :8781, AIHUMMER_WEBUI_ADDR), kök yolunda xidmət göstərilir / və ideal olaraq yalnız daxili interfeysə bağlanmalıdır. Bu yox ictimai keçid portunda: :8780 API, qoşulma, WS/SSE və daxil olan trafik daşıyır və administrasiya UI-ni heç vaxt təqdim etmir (o, qaytarır 404 üçün /admin və /v1/admin). Qapı öz daxili edge-router vasitəsilə xarici yönləndirməyə sahibdir — siz konfiqurasiya etməli olduğunuz əlavə nginx yoxdur.

Şifrəni dərhal dəyişdirin

İlk dəfə daxil olduqdan sonra idarəçi istifadəçi interfeysindən başlanğıc parolunu dəyişdirin, sonra isə silin initial-admin-password.txt fayl. Siz həmçinin paketlənmiş CLI vasitəsilə parolu sıfırlaya bilərsiniz:

aihummer set-password
# or
aihummer admin-password

set-password ehtiyacları AIHUMMER_DATABASE_URL — quraşdırmanın istifadəçi üçün edildiyi kimi işlədin, ya da mühit ilə ~/.aihummer/etc/gateway.env.

[!DANGER] Bootstrap parolunu yerində qoymayın və parolu da qoymayın istehsal serverində oturan fayl. Bootstrap admin hesab tamdır administrator — həmin faylı oxuyan və sonuna çatmış hər kəs /admin/ tamdır nəzarət.

Öz yolunuzu tapın

Daxil olduqdan sonra idarəetmə interfeysində bir neçə mühüm göstərici:

  • Naviqasiya — bölmələr hash ünvanlarında açılır (/#channels, /#settings…), beləliklə hər hansı bir səhifə birbaşa link vasitəsilə açıla və yenidən ziyarət oluna bilər Geri düyməsi.
  • Qaranlıq və işıqlı mövzu — başlıqda günəş/ayın dəyişdirilməsi; seçim brauzerdə yadda saxlanıldı.
  • Brend və maskot — loqodakı “Ai” hərfləri brend vurğusunu daşıyır, və boş vəziyyətlər, quraşdırma ustası və giriş ekranı maskotu nümayiş etdirir — Ham adında bir feneks tülküsü.
  • “Hesab” səhifəsi — öz şifrənizi dəyişin, çıxış edin və qurun iki faktorlu yoxlama: TOTP tətbiqi, şifrə açarları (WebAuthn) və bərpa kodlar.

Admin səthini təhlükəsiz edin

Öz-özlüyündə, /admin/* səth, heç bir müəssisə auth verici qurulmadıqda başlıqları inkişaf etdirir — bu, noutbukda yaxşıdır, lakin açıq hoştda təhlükəlidir. Hər hansı istehsal yerləşdirməsi üçün qoruyun /admin/* avtorizasiya verəni ilə və olmadan onu açıq etməyin.

[!IMPORTANT] Dəst AIHUMMER_OIDC_ISSUER (və ya admin bölməsini açmadan əvvəl LDAP/SAML-i konfiqurasiya edin) İstifadəçi interfeysi. Onsuz, /v1/admin/* API dev başlıqlarına etibar edir — yerli administrator şifrə yalnız şəxsi Veb UI girişini qoruyur, yox admin API — buna görə Son nöqtələr heç vaxt etibarsız şəbəkədən əlçatan ola bilməz.

Korporativ SSO-nu aktiv edin (istehsal)

İstehsalat üçün autentifikasiyanı öz kimlik təminatçınıza köçürün. AiHummer müəssisə səviyyəli SSO-u dəstəkləyir, buna görə ilkin lokal hesab gündəlik istifadə yolu deyil, fövqəladə vəziyyət üçün ehtiyat üsul olur:

  • OIDC — qoruyur /v1/admin/* (dəfələrlə-əks olunmayan).
  • SAML — federasiya vasitəsilə /saml/metadata, /saml/acs, /saml/login.
  • LDAP / Aktiv Qovluq — kataloq dəstəklı giriş.
  • SCIM — avtomatlaşdırılmış istifadəçi təminatı /scim/v2/Users.

SSO tətbiq edildikdən sonra, yerli istifadəni gündəlik olaraq azaldın və ya dayandırın admin hesaba baxın və IdP-nizin qruplarına və rollarına etibar edin.

Əgər işləmdisə

  • Parol faylı yoxdur — yalnız bir üzərində yaradılır boş verilənlər bazasında ilk başlanğıc. Əgər verilənlər bazası artıq ilkinləşdirilibsə, sıfırlamadan istifadə edin: aihummer set-password (ehtiyac duyur AIHUMMER_DATABASE_URL).
  • http://localhost:8781/ açılmayacaq — bu özəl Veb UI portudur; yoxlayın xidmət işləyir (systemctl status aihummer-gateway) və sən vurmaq :8781, ictimai deyil :8780.
  • /admin qaytarır 404 — bu ictimai portda gözlənilir :8780: admin UI yalnız şəxsi Veb UI-də yaşayır (:8781).
  • Dəyişdirilmiş şifrəni unutdum — onu ilə sıfırla aihummer set-password, kimi işlət quraşdırmanı həyata keçirən istifadəçi.
  • Başqa bir maşından idarəçi istifadəçi interfeysini açmaq — aşkar etməyin /admin/* birinə etibarsız şəbəkə avtorizasiya vericisi olmadan; təyin edildi AIHUMMER_OIDC_ISSUER (və ya Əvvəlcə LDAP/SAML).

Növbəti haradır