Веб-интерфейс (Web UI)/API-цаԥхақәа, арахьынтә ахьынӡареи IP-аллоулисти
API-цаԥхақәа, арахьынтә ахьынӡареи IP-аллоулисти
v1.0.x · ирҿыцуп 2026-07-08
Ари адаҟьа еиднакылоит Web UI хԥа-даҟьак, инстанс арахьынтә ахьынӡара изнапхгало:
API-цаԥхақәа, Арахьынтә ахьынӡара насгьы IP-аллоулист.
API-цаԥхақәа
«API-цаԥхақәа» адаҟьа иднагалоит control-plane насгьы чат-цаԥхақәа. «+ Идәылга»:
- user_ref — ауаҩы (ауаҩ адгылтәи алистла ма ихатәыла иҩ);
- ацаԥха ахьӡ;
- scopes — чекбоксқәа:
chat, admin:read, admin:write, mcp, a2a, *
(зегьы);
- RPM лимит.
Ацаԥха аҵакы иаадоит зныла — иахьеиқәырха аамҭала. Ацаԥха-хаҭала уара улшоит
«OAuth-аклиент аҳасабала иҭаҩ» (client_id / client_secret зныла иднагалоит) насгьы
«Иаҟәыхтәи». Ацаԥхақәа ah- префикс рымоуп насгьы Bearer токен аҳасабала идәықәлоит
(иабалар Swagger).
Арахьынтә ахьынӡара
«Арахьынтә ахьынӡара» адаҟьа reverse-proxy аусуреи изеиԥшу адресқәеи иашьнагылоит,
ԥшь-блокк ала:
- Изеиԥшу адрес —
AIHUMMER_PUBLIC_URL (иаҭахуп), насгьы Telegram, iOS-прокси
насгьы pocket-агент рзы изеиԥшу адресқәа.
- HTTPS-мацара —
AIHUMMER_REQUIRE_SECURE.
- Апрокси аштахь — иузыҟало апроксиқәа, CORS ахыҵхырҭақәа, CSP.
- Web UI-листенер — иабзаны, адреси Web UI хатәгылоу апорт ахыҵхырҭеи.
Аполиа-хаҭала атекст ма атогл ауп; аиқәырхара аҿы уара иудырбоит аиҭак иабзаны иналарҟьазма
ма аиҭалагалара иаҭахузма.
IP-аллоулист
«IP-аллоулист» адаҟьа ауп акы-textarea CIDR-қәа рыла, аҩ-хаҭала, админ-API ахьынӡара
иасоу асеткақәа рахь иаҟәызырхо. Иҭацәу алист иаанагоит аҟәырхара ыҟам.
[!TIP]
IP-аллоулист еиқәыркуп аха ишьаку барьеруп. Уи еидыркыл
RBAC насгьы «HTTPS-мацара» рыцны, ахьынӡара офис/VPN
аҟынтә мацара иазхаша.
Иахьынтә ашьҭахь
Ари адаҟьа еиднакылоит Web UI хԥа-даҟьак, инстанс арахьынтә ахьынӡара изнапхгало:
**API-цаԥхақәа**, **Арахьынтә ахьынӡара** насгьы **IP-аллоулист**.
## API-цаԥхақәа
**«API-цаԥхақәа»** адаҟьа иднагалоит control-plane насгьы чат-цаԥхақәа. «+ Идәылга»:
- **user_ref** — ауаҩы (ауаҩ адгылтәи алистла ма ихатәыла иҩ);
- ацаԥха **ахьӡ**;
- **scopes** — чекбоксқәа: `chat`, `admin:read`, `admin:write`, `mcp`, `a2a`, `*`
(зегьы);
- **RPM лимит**.
Ацаԥха аҵакы иаадоит **зныла** — иахьеиқәырха аамҭала. Ацаԥха-хаҭала уара улшоит
**«OAuth-аклиент аҳасабала иҭаҩ»** (client_id / client_secret зныла иднагалоит) насгьы
**«Иаҟәыхтәи»**. Ацаԥхақәа `ah-` префикс рымоуп насгьы Bearer токен аҳасабала идәықәлоит
(иабалар [Swagger](/ab/v1.0/api/swagger)).
## Арахьынтә ахьынӡара
**«Арахьынтә ахьынӡара»** адаҟьа reverse-proxy аусуреи изеиԥшу адресқәеи иашьнагылоит,
ԥшь-блокк ала:
- **Изеиԥшу адрес** — `AIHUMMER_PUBLIC_URL` (иаҭахуп), насгьы Telegram, iOS-прокси
насгьы pocket-агент рзы изеиԥшу адресқәа.
- **HTTPS-мацара** — `AIHUMMER_REQUIRE_SECURE`.
- **Апрокси аштахь** — иузыҟало апроксиқәа, CORS ахыҵхырҭақәа, CSP.
- **Web UI-листенер** — иабзаны, адреси Web UI хатәгылоу апорт ахыҵхырҭеи.
Аполиа-хаҭала атекст ма атогл ауп; аиқәырхара аҿы уара иудырбоит аиҭак иабзаны иналарҟьазма
ма аиҭалагалара иаҭахузма.
## IP-аллоулист
**«IP-аллоулист»** адаҟьа ауп акы-textarea CIDR-қәа рыла, аҩ-хаҭала, админ-API ахьынӡара
иасоу асеткақәа рахь иаҟәызырхо. Иҭацәу алист иаанагоит аҟәырхара ыҟам.
> [!TIP]
> IP-аллоулист еиқәыркуп аха ишьаку барьеруп. Уи еидыркыл
> [RBAC](/ab/v1.0/webui/security) насгьы «HTTPS-мацара» рыцны, ахьынӡара офис/VPN
> аҟынтә мацара иазхаша.
## Иахьынтә ашьҭахь
- [Swagger](/ab/v1.0/api/swagger) — API-аԥшааҩи ацаԥха-авторизациеи.
- [Асетка, аудити air-gapped](/ab/v1.0/security/network-audit-airgapped).
- [Апорт-модель](/ab/v1.0/architecture/gateway-turn-engine) — изеиԥшу vs хатәгылоу.