API-ключы, знешні доступ і белы спіс IP

v1.0.x · абноўлена 2026-07-08

Гэтая старонка ахоплівае тры экраны Web UI, якія кіруюць доступам да інстанса звонку: API-ключы, Знешні доступ і Белы спіс IP.

API-ключы

Экран «API-ключы» выпускае ключы кіравання і чату. «+ Выпусціць»:

user_ref — карыстальнік (выберыце з лакальных карыстальнікаў або ўвядзіце свабодна);
назва ключа;
абласці — чэкбоксы: chat, admin:read, admin:write, mcp, a2a, * (усе);
ліміт RPM.

Значэнне ключа паказваецца адзін раз — захавайце яго адразу. Для кожнага радка ключа вы можаце «Зарэгістраваць як OAuth-кліента» (выпускае client_id / client_secret адзін раз) і «Адклікаць». Ключы маюць прэфікс ah- і адпраўляюцца як Bearer-токен (глядзіце Swagger).

Знешні доступ

Экран «Знешні доступ» наладжвае працу зваротнага проксі і публічныя адрасы ў чатырох блоках:

Публічны адрас — AIHUMMER_PUBLIC_URL (абавязкова), плюс публічныя адрасы для Telegram, iOS-проксі і pocket-агента.
Толькі HTTPS — AIHUMMER_REQUIRE_SECURE.
За проксі — давераныя проксі, CORS-крыніцы, CSP.
Слухач Web UI — уключэнне, адрас і крыніца прыватнага порта Web UI.

Кожнае поле — гэта тэкст або пераключальнік; пры захаванні вам паведамляецца, ці прымянілася змена ў рэальным часе, ці патрабуе перазапуску.

Белы спіс IP

Экран «Белы спіс IP» — гэта адзінае тэкставае поле з CIDR-мі, па адным у радку, якое абмяжоўвае доступ да admin-API пэўнымі сеткамі. Пусты спіс азначае адсутнасць абмежаванняў.

[!TIP] Белы спіс IP — гэта грубы, але надзейны бар’ер. Спалучайце яго з RBAC і «Толькі HTTPS», каб дазволіць доступ толькі з офіса/VPN.

Далей

Swagger — правадзірнік па API і аўтарызацыя ключом.
Сетка, аўдыт і air-gapped.
Мадэль портаў — публічны супраць прыватнага.