AiHummer
Аԥсшәа
Аиалаҵара
v1.0.x
{ }Swagger

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 аҟынтә мацара иазхаша.

Иахьынтә ашьҭахь