AiHummer
Тоҷикӣ▾
ВоридшавӣКабинети шахсӣ
v1.0.x▾
v1.2.xstablev1.1.xstablev1.0.xstable
{ }Swagger
Амният/Анбори сиррҳо

Анбори сиррҳо

v1.0.x · навсозӣ шуд 2026-06-26

AiHummer ҳар як шаҳодатномаро — рамзҳои канал, паролҳои SMTP/IMAP, рамзҳои OAuth, калидҳои LLM барои ҳар як иҷоранишин (BYOK) — дар як анбори сиррҳои рамзгузоришудаҚуттӣ рамзгузории номаиро истифода мебарад, то ки арзиши нигоҳдошташуда танҳо аз пойгоҳи додаҳо хонда нашуда бошад, ва он ба тавр тарҳрезӣ шудааст, ки сир вуҷуд дорад қатъиян дар матни модел ё сабтҳо ҷой дода нашудааст.

Рамзгузории конверт

Сейф аз сохтори калиди дусатҳа истифода мебарад:

  • А калиди асосӣ (KEK) — пешниҳод карда шудааст ҳамчун AIHUMMER_MASTER_KEY, рамзгузории base64 Арзиш 32-байтӣ — калидҳои додаҳоро печонида ва печи онро мекушад. Он ҳеҷ гоҳ меҳмонро тарк намекунад ва ҳеҷ гоҳ ба пойгоҳи додаҳо навишта намешавад.
  • А калиди рамзгузории маълумот барои ҳар як соҳиби иҷора (DEK) иқтидори воқеии махфӣ ро рамзгузорӣ мекунад бо AES-256-GCM (рамзгузории тасдиқшудa). Ҳар як иҷоранишин DEK-и худро дорад ба ин тартиб, калидҳои соҳиби иҷора наметавонанд сиррҳои соҳиби иҷораи дигарро кушоянд.

Арзиши махфӣ ҳамчун матни рамзӣ нигоҳ дошта мешавад; DEK бо KEK печонида нигоҳ дошта мешавад. Декодкунӣ дар хотира ҳангоми ниёз ба махфӣ сурат мегирад (масалан, вақте ки пайвасткунӣ эътироф мешавад), ва матни оддӣ баъд аз он партофта мешавад.

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

[!NOTE] Ин анбор ба PostgreSQL такя мекунад pgcrypto иқтишир. Боварӣ ҳосил кунед, ки он дар пойгоҳи додаҳои шумо дастрас аст — он як қисми талаботи стандартии система мебошад.

Калиди асосӣ

Калиди асосӣ як арзиши bootstrap мебошад: он ҳангоми оғози кор аз муҳит хонда мешавад ва не аз интерфейси идоракунанда танзимшаванда. Насбкунанда (ва дар оғози аввал шлюз) ҳамеша эҷод мекунад AIHUMMER_MASTER_KEY — ин ихтиёрӣ нест, зеро сирри ҳифзшуда, анбори шаҳодатнома ва BYOK барои ҳар як иҷорагир ба он вобаста аст. Аз ин рӯ насби стандартӣ ҳамеша яке дорад.

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

Шумо метавонед яке бо ин роҳ тавлид кунед:

openssl rand -base64 32

[!WARNING] Барои расонидани ҳама чиз дар анбори пулии махфӣ калиди асосӣ лозим аст. Онро ҳамчун решаи сирҳоятон ва онро алоҳида эҳтиётӣ кунед аз пойгоҳи додаҳо — агар Агар шумо онро гум кунед, арзишҳои рамзшуда барқарор карда намешаванд. Бинед Амалиёт барои роҳнамои эҳтиётӣ.

Агар калиди асосӣ гум шуда бошад

Зеро калид ҳамеша таъмин карда мешавад, насби стандартӣ ҳамеша дорои анбори коркунанда мебошад. Рафтори инҷо ҳамчун муҳофизати баста кор мекунад барои ҳолати ғайримуқаррарӣ, ки AIHUMMER_MASTER_KEY ба кадом роҳе танзим нашудааст (масалан, файли env ки бо даст таҳрир шудааст): анбор ва ҳама чизҳое ки ба он вобастаанд афзалиятнопазиршуда — анбори сирри истироҳатӣ, анбори калидҳо ва калидҳои BYOK барои ҳар як иҷорадор ҳама хомӯш карда шудаанд. Ин бо мақсади махсус аст — маҳсулот ба таври оромона баргашт ба нигоҳ доштани сирро дар матни равшан намекунад.

Сирҳо ҳеҷ гоҳ ба модел намерасанд

Ин муҳимтарин хусусияти анбор аст ва он сохторӣ аст на ёдраскунандаи сиёсӣ.

[!DANGER] Сирҳо ҳастанд ҳеҷ гоҳ дар системаи фармон ворид кардашуда, суҳбат тарих, ё ҳар матни намоишӣ ва онҳо ҳастанд ҳеҷ гоҳ ба логҳо навишта шуд. Асбобҳое, ки ба шаҳодатнома ниёз доранд, онро ҳангоми даъват аз анбор ҳалли мекунанд, дар дохил дарвоза ва аз он барои тасдиқи дархости баромадкунанда истифода барад — танҳо модел ҳамеша натиҷаи занг ба асбобро мебинад, на сирр.

Зеро муошират бо истифода аз даъват намудани асбобҳо идора мешавад (нигоред Монеаҳо ва мудофиаи саривақтии воридшавӣҲеҷ роҳи он нест, ки бо истифодаи як пешниҳоди зудмуддат модельро ба хониши сирри нигоҳдошташуда водор кунад: модель нусхаи онро барои хондан надорад.

Шахсиятҳо ва маълумотҳои вуруд барои ҳар корбар

Сарфафаркунӣ байни муштарак эътимодномаҳои (сатҳи кори ҷой) ва шаҳсӣ Шаҳодатномаҳои (барои ҳар як корбар). Токенҳои OAuth2, ки тавассути раванди Connections гирифта мешаванд, дар анбор нигоҳ дошта мешаванд ва аз ҷониби корбари амалкунанда бо як фазои корӣ ҳалли худро мегиранд. Дар ҷойи мувофиқ истифодаи эҳтиётӣ. Ин имкон медиҳад, ки ҳамон асбоб ба нафъи корбарони гуногун бо иҷозатномаи худ амал кунад, бе он ки ҳеҷ гоҳ рамзи як корбар ба дигарон ошкор карда шавад.

Баъд ба куҷо