Кілт мәні бір рет қана көрсетіледі — оны бірден сақтаңыз. Әр кілт жолында сіз
«OAuth клиенті ретінде тіркеу» (client_id / client_secret бір рет шығарады)
және «Кері қайтару» әрекеттерін орындай аласыз. Кілттердің префиксі ah-
және олар Bearer токен ретінде жіберіледі
(Swagger қараңыз).
Сыртқы қолжетімділік
«Сыртқы қолжетімділік» экраны кері прокси жұмысын және жалпыға ортақ
мекенжайларды төрт блокта баптайды:
Жалпыға ортақ мекенжай — AIHUMMER_PUBLIC_URL (міндетті), сондай-ақ
Telegram, iOS проксиі және pocket agent үшін жалпыға ортақ мекенжайлар.
Тек HTTPS — AIHUMMER_REQUIRE_SECURE.
Прокси артында — сенімді проксилер, CORS шығу тегі, CSP.
Web UI тыңдаушысы — жеке Web UI портын қосу, мекенжайы және шығу тегі.
Әр өріс — мәтін немесе ауыстырғыш; сақтау кезінде өзгеріс тікелей қолданылғанын
немесе қайта іске қосуды қажет ететінін сізге хабарлайды.
IP тізімі
«IP тізімі» экраны — әр жолда біреу болатын CIDR-лердің бір мәтіндік алаңы,
ол admin-API-ге қолжетімділікті нақты желілермен шектейді. Бос тізім шектеудің жоқ
екенін білдіреді.
[!TIP]
IP тізімі — дөрекі, бірақ сенімді тосқауыл. Оны RBAC
және «тек HTTPS» бапталымдарымен біріктіріп, тек кеңседен/VPN-нен қолжетімділікке
рұқсат етіңіз.
Бұл бет инстансқа сырттан қолжетімділікті реттейтін үш Web UI экранын қамтиды:
**API кілттері**, **Сыртқы қолжетімділік** және **IP тізімі**.
## API кілттері
**«API кілттері»** экраны басқару жазықтығы мен чат кілттерін шығарады. «+ Шығару»:
- **user_ref** — пайдаланушы (жергілікті пайдаланушылардан таңдаңыз немесе еркін
теріңіз);
- кілт **атауы**;
- **scopes** — құсбелгілер: `chat`, `admin:read`, `admin:write`, `mcp`, `a2a`, `*`
(барлығы);
- **RPM шектеуі**.
Кілт мәні **бір рет қана** көрсетіледі — оны бірден сақтаңыз. Әр кілт жолында сіз
**«OAuth клиенті ретінде тіркеу»** (client_id / client_secret бір рет шығарады)
және **«Кері қайтару»** әрекеттерін орындай аласыз. Кілттердің префиксі `ah-`
және олар Bearer токен ретінде жіберіледі
([Swagger](/kk/v1.0/api/swagger) қараңыз).
## Сыртқы қолжетімділік
**«Сыртқы қолжетімділік»** экраны кері прокси жұмысын және жалпыға ортақ
мекенжайларды төрт блокта баптайды:
- **Жалпыға ортақ мекенжай** — `AIHUMMER_PUBLIC_URL` (міндетті), сондай-ақ
Telegram, iOS проксиі және pocket agent үшін жалпыға ортақ мекенжайлар.
- **Тек HTTPS** — `AIHUMMER_REQUIRE_SECURE`.
- **Прокси артында** — сенімді проксилер, CORS шығу тегі, CSP.
- **Web UI тыңдаушысы** — жеке Web UI портын қосу, мекенжайы және шығу тегі.
Әр өріс — мәтін немесе ауыстырғыш; сақтау кезінде өзгеріс тікелей қолданылғанын
немесе қайта іске қосуды қажет ететінін сізге хабарлайды.
## IP тізімі
**«IP тізімі»** экраны — әр жолда біреу болатын CIDR-лердің бір мәтіндік алаңы,
ол admin-API-ге қолжетімділікті нақты желілермен шектейді. Бос тізім шектеудің жоқ
екенін білдіреді.
> [!TIP]
> IP тізімі — дөрекі, бірақ сенімді тосқауыл. Оны [RBAC](/kk/v1.0/webui/security)
> және «тек HTTPS» бапталымдарымен біріктіріп, тек кеңседен/VPN-нен қолжетімділікке
> рұқсат етіңіз.
## Келесі
- [Swagger](/kk/v1.0/api/swagger) — API шолғышы мен кілтпен авторизациялау.
- [Желі, аудит және air-gapped](/kk/v1.0/security/network-audit-airgapped).
- [Порт моделі](/kk/v1.0/architecture/gateway-turn-engine) — жалпыға ортақ пен жеке.