Gizlinlikler gutusy

v1.1.x · täzelendi 2026-06-26

AiHummer ähli credentiallary — kanal tokenleri, SMTP/IMAP parollary, OAuth tokenleri, her-tenant LLM açarlary (BYOK) — birde saklaýar şifirlenen syrlar gutusy. Saklaýyş banky envelopment şifrlemesini ulanýar, şonuň üçin dynçlykdaky bahany diňe maglumatlar bazasyndan okap bolmaz, we ol hususy açar hökmünde öndürilýär hemişe model kontekstine ýa-da ýazgylara goýulmaýar.

Konwert şifrlemesi

Güýçli howpsuzlyk bölümi iki gatlakly açar hierarhiýasyny ulanýar:

A mälim açar (KEK) — berlen hökmünde AIHUMMER_MASTER_KEY, base64 bilen kodlanan 32-baytlyk baha — maglumat açarlaryny gaplap we gaplamaz. Ol hiç haçan serweri terk etmeýär we hemişe maglumatyň bazasyna ýazylmaýar.
A her-turgyň maglumatlary şifrleýji açary (DEK) hakyky syrly gymmatlary şifrleýär bilen AES-256-GCM (tassyklanan şifrleýiş). Her kirýewiň öz DEK-i bar, şonuň üçin bir kirýäkiniň açarlary başga bir kirýäkiniň gizlinliklerini açyp bilmeýär.

Gizlin gymmatlyklar şifrlenen görnüşde saklanylýar; DEK KEK tarapyndan gaplanyp saklanylýar. Deşifrlemek, gizlin zerur bolan pursat ýatda amala aşyrylýar (meselem, birikdiriji awtorizasiýa edilende), we soňra açyk tekst ýok edilýär.

AIHUMMER_MASTER_KEY (KEK)  ──wraps──▶  per-tenant DEK  ──AES-256-GCM──▶  secret value

[!NOTE] Bu ammar PostgreSQL-e daýar pgcrypto giňeltme. Munuň bolmagyna göz ýetiriň siziň maglumat bazanyňyzda bar — bu standart ulgam talaplarynyň bir bölegidir.

Esasy açar

Esasy açar bootstrap bahasydyr: ol işe başlanda gurşawdan okaýar we däk admin UI-dan sazlap bolýar. Gurnama (we geçelge ilkinji gezek başlanda) hemişe döredýär AIHUMMER_MASTER_KEY — bu islendik däl, sebäbi dynç alyşdaky syrlar, şahsyýet maglumatlary banky we her tenant üçin BYOK munuň üstünde durýar. Şonuň üçin standart gurnama hemişe birini öz içine alýar.

# /home/.aihummer/etc/gateway.env
# 32 random bytes, base64-encoded
AIHUMMER_MASTER_KEY=Base64Of32RandomBytes==

Siz munyny aşakdakyny ulanyp düzup bilersiňiz:

openssl rand -base64 32

[!WARNING] Hemmesi kassadaky zatlary açmak üçin baş açary gerekli. Oňa şeýle garaýyň syrlaryňyz bilenň kökü ony ýöriteleşdirilip ätiýaçlap goý maglumatlar bazasyndan — eger siz ony ýitirýärsiňiz, şifrlenen gymmatlyklar dikeldip bolmaz. Garaň Amallar backup ýörelgeleri üçin.

Eger esasy açar ýok bolsa

Açar hemişe üpjün edilýändigi üçin, standart gurnama hemişe işleýän gorawly bank bilen bolýar. Bu ýerde hereket, adaty bolmadyk ýagdaý üçin ýapyk-özüni gorap saklaýar AIHUMMER_MASTER_KEY bir şekilde bellenmändigini (meselem, eli bilen üýtgedilen env faýly): gapyny we oňa baglanyşykly ähli zatlary maýyp — dymmaz ýagdaýdaky gizlinlik saklama, şahsyýet maglumatlary banky we her tenant üçin BYOK açarlary doly öçürildi. Bu maksat bilen edildi — önümiň gizlinlikleri açyk tekst görnüşinde saklamaga göni gaýtman galmaýar.

Siriň hiç wagt modele ýetmeýän

Bu töwekgelçilikli ammaruň iň möhüm aýratynlygy bolup, bu syýasat ýatlatmasyndan has köp gurluşy häsiýete eýedir.

[!DANGER] Gizlinlikler hiç wagt ugurdaş ulgam çagyryşyna öňünden salnan, gepleşik taryh, ýa-da islendik modeliň görünen teksti, we olar hiç wagt loglara ýazyldy. Kredential talap edýän gurallar munuň çözgüdini çagyrmak wagtynda, içinde, ambar bilen baglanyşykly ýerine ýetirýärler gapy, we ony çykýan soragy tassyklamak üçin ulanyň — modeli diňe şu gurallaryň çagyryşynyň netijesini gören, syry däl.

Çünki özara hereket etmek gural çaýlamak bilen hereket edýär (serediň Gorag diňleri we çalt beýikeltme goragy), modelden saklanan gizligi ‘okap bermegi’ soraýan bir ýoly ýok: modeliň ony okap biljek nusgasy ýok.

Ulgamlaryň we şahsy ulanyjynyň şahsy öňbelli maglumatlary

Güýçli howuz tapawut berýär paýlaşylan (iş meşkin derejesindäki) şahsy maglumatlary we şahsy (ulanyjy boýunça) şahsyýetnamalar. Connections akymy arkaly alnan ulanyjy boýunça OAuth2 tokenleri çölde saklanylýar we hereket edýän ulanyjy tarapyndan çözülýär, zerur bolsa iş meýdançasyndan ätiýaçlyk çözgüt hökmünde ulanylýar. Bu, şol bir guraly dürli ulanylýanlar tarapyndan olaryň öz ygtyýasnamalary bilen işledip bilmek mümkinçiligini berýär, hiç kimiň tokenini beýlekä görkezmezden.

Indi nire?

RBAC we çäklenen API açarlary — kim okap ýa-da üýtgedip biler vault-jaýlanan sazlama.
Setir derejesindäki howpsuzlyk — her ýurdaş üçin izolýasiýa kamerany goldaýan maglumatlar bazasy.
Gorag diňleri we çalt beýikeltme goragy — näme üçin model bir syrlary aýtmaga aldamak mümkin däl.