Калидҳои API, дастрасии берунӣ ва рӯйхати иҷозати IP

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

Ин саҳифа се экрани Web UI-ро дар бар мегирад, ки дастрасӣ ба инстансро аз берун идора мекунанд: Калидҳои API, Дастрасии берунӣ ва Рӯйхати иҷозати IP.

Калидҳои API

Экрани «Калидҳои API» калидҳои control-plane ва чатро мебарорад. “+ Issue”:

user_ref — корбар (аз корбарони маҳаллӣ интихоб кунед ё озодона нависед);
номи калид;
scopes — чекбоксҳо: chat, admin:read, admin:write, mcp, a2a, * (ҳама);
маҳдудияти RPM.

Қимати калид як маротиба нишон дода мешавад — онро фавран нигоҳ доред. Барои ҳар як сатри калид шумо метавонед «Register as OAuth client» (client_id / client_secret-ро як маротиба мебарорад) ва «Revoke» кунед. Калидҳо бо префикси ah- мебошанд ва ҳамчун токени Bearer фиристода мешаванд (ба Swagger нигаред).

Дастрасии берунӣ

Экрани «Дастрасии берунӣ» кори reverse-proxy ва суроғаҳои оммавиро дар чор блок танзим мекунад:

Суроғаи оммавӣ — AIHUMMER_PUBLIC_URL (ҳатмӣ), плюс суроғаҳои оммавӣ барои Telegram, прокси iOS ва pocket agent.
Танҳо HTTPS — AIHUMMER_REQUIRE_SECURE.
Дар паси прокси — прокси-ҳои боэътимод, манбаъҳои CORS, CSP.
Гӯшкунандаи Web UI — фаъолсозӣ, суроға ва манбаи порти хусусии Web UI.

Ҳар як майдон матн ё toggle аст; ҳангоми нигоҳ доштан ба шумо гуфта мешавад, ки оё тағйир зинда татбиқ шуд ё бозоғозиро талаб мекунад.

Рӯйхати иҷозати IP

Экрани «Рӯйхати иҷозати IP» як textarea-и ягона аз CIDR-ҳо мебошад, ҳар кадом дар як сатр, ки дастрасӣ ба admin-API-ро ба шабакаҳои муайян маҳдуд мекунад. Рӯйхати холӣ маънои набудани маҳдудиятро дорад.

[!TIP] Рӯйхати иҷозати IP монеаи дурушт вале боэътимод аст. Онро бо RBAC ва «Танҳо HTTPS» якҷоя кунед, то дастрасиро танҳо аз офис/VPN иҷозат диҳед.

Оянда

Swagger — тадқиқотчии API ва авторизатсияи калид.
Шабака, аудит ва air-gapped.
Модели портҳо — оммавӣ дар муқобили хусусӣ.