Syrlar ammary — AiHummer Resminamalar

AiHummer her kredensialy — kanal tokenleri, SMTP/IMAP parollary, OAuth tokenleri, her-tenant LLM açarlary (BYOK) — şifrlenen syrlar ammarynda saklaýar. Ammar örtük şifrlemesini ulanýar, şeýdip dynç ýagdaýdaky baha diňe maglumatlar bazasyndan hiç haçan okalmaýar, we ol syryň hiç haçan model kontekstine ýa-da loglara goýulmazlygy üçin gurnalandyr.

Örtük şifrleme

Ammar iki-derejeli açar iýerarhiýasyny ulanýar:

Master açar (KEK) — AIHUMMER_MASTER_KEY hökmünde berilýär, base64-kodlanan 32-baýtlyk baha — maglumat açarlaryny örtýär we çykарýar. Ol hiç haçan hostdan çykmaýar we hiç haçan maglumatlar bazasyna ýazylmaýar.
Her-tenant maglumat şifrleme açary (DEK) hakyky syr bahalaryny AES-256-GCM (awtentifikasiýalanan şifrleme) bilen şifrleýär. Her tenantyň öz DEK-i bar, şeýdip bir tenantyň açarlary başga tenantyň syrlaryny şifresini açyp bilmeýär.

Syr bahalary şifrtekst hökmünde saklanýar; DEK KEK tarapyndan örtülen saklanýar. Şifresini açmak syr gerek bolan pursatda ýatda bolup geçýär (mysal üçin, konnektor awtentifikasiýa edende), we açyk tekst soňra taşlanýar.

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

[!NOTE] Ammar PostgreSQL-iň pgcrypto giňeltmesine daýanýar. Onuň maglumatlar bazaňyzda elýeterlidigine göz ýetiriň — ol standart ulgam talaplarynyň bir bölegidir.

Master açar

Master açar bootstrap bahasydyr: ol başlanyşda gurşawdan okalýar we admin UI-den düzülip bolmaýar.

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

Birini şeýle döredip bilersiňiz:

openssl rand -base64 32

[!WARNING] Master açar ammardaky hemme zadyň şifresini açmak üçin gerek. Oňa syrlaryňyzyň köki ýaly garaň we ony maglumatlar bazasyndan aýratyn ätiýaçlandyryň — eger ony ýitirseňiz, şifrlenen bahalary dikeltmek mümkin däl. Ätiýaçlandyrma görkezmesi üçin Operasiýalara serediň.

Master açarsyz

Eger AIHUMMER_MASTER_KEY bellenmedik bolsa, ammar we oňa bagly hemme zat öçürilýär: dynç-ýagdaýdaky-syrlar saklamasy, kredensial ammary we her-tenant BYOK açarlary hemmesi öçürilýär. Bu bilkastlaýyn fail-closed özüni-alyp-baryşy — önüm syrlary açyk tekstde saklamaga sessiz gaýdyp gelmeýär.

Syrlar hiç haçan modele ýetmeýär

Bu ammaryň iň möhüm häsiýetidir, we ol syýasat ýatlatmasyndan däl-de gurluşlydyr.

[!DANGER] Syrlar hiç haçan ulgam promptyna, söhbetdeşlik taryhyna ýa-da islendik model-görünýän tekste inýeksiýa edilmeýär, we olar hiç haçan loglara ýazylmaýar. Kredensial gerek gurallar ony çagyryş wagtynda ammardan, geýtweýiň içinde çözýär we çykýan haýyşy awtentifikasiýa etmek üçin ulanýar — model diňe gural çagyryşynyň netijesini görýär, syry däl.

Interaktiwlik gural-çagyrmak bilen hereketlendirilýändigi sebäpli (serediň Goragçylar & prompt-inýeksiýa goragy), promptyň modeli saklanan syry “okamaga” sorap biljek ýoly ýok: modelde ony okamak üçin nusgasy ýok.

Paýlaşylan we her-ulanyjy kredensiallary

Ammar paýlaşylan (işiş-meýdany derejeli) kredensiallar bilen şahsy (her-ulanyjy) kredensiallaryň arasyny tapawutlandyrýar. Birikmeler akymyndan alnan her-ulanyjy OAuth2 tokenleri ammarda saklanýar we hereket edýän ulanyjy tarapyndan çözülýär, amatly ýerde işiş-meýdany ätiýaçlygy bilen. Bu şol bir gurala dürli ulanyjylaryň adyndan öz awtorizasiýalary bilen hereket etmäge mümkinçilik berýär, bir ulanyjynyň tokenini başgasyna hiç haçan açmazdan.

Indiki nirä

RBAC & gerimlenen API açarlary — ammar-esasly konfigurasiýany kim okap ýa-da üýtgedip biler.
Row-Level Security — ammary goldaýan maglumatlar bazasynda her-tenant izolýasiýasy.
Goragçylar & prompt-inýeksiýa goragy — modeli näme üçin hiç haçan syr çykarmaga aldap bolmaýar.