Вэб хэрэглэгчийн интерфэйс/API түлхүүрүүд, гадаад нэвтрэлт ба IP зөвшөөрөгдсөн жагсаалт
API түлхүүрүүд, гадаад нэвтрэлт ба IP зөвшөөрөгдсөн жагсаалт
v1.1.x · шинэчилсэн 2026-07-08
Энэ хуудас нь гадаад талаас экземплярт хандахыг зохицуулдаг гурван вэб UI дэлгэцийг хамардаг: API түлхүүрүүд, Гаднаас нэвтрэх болон IP зөвшөөрөгдсөн жагсаалт.
API түлхүүрүүд
Тэр API түлхүүрүүд дэлгэцийн асуудлууд удирдлагын самбар болон чат товчлуурууд. Асуудал:
- Хэрэглэгч — орон нутгийн хэрэглэгчийг сонгох эсвэл лавлагааг гараар оруулах;
- түлхүүр нэр;
- хамрах цар хүрээ — сонголтын хайрцагууд:
chat, admin:read, admin:write, mcp, a2a, *
(бүгд);
- нэг Өргөлтийн хязгаар.
Дээрх зургаан том хүрээгээс гадна, дискрет домайн тус бүрийн хүрээ тэдэнтэй зэрэгцэн, хэлбэрээр нь боломжтой domain:read, domain:write, domain:* (жишээ нь agents:read, channels:write, memory:*) — зөвхөн шаардлагатай домэйнууддаа түлхүүр олгоно.
Түлхүүрийн утга нь харуулагдсан нэг удаа — үүнийг даруй хадгалаарай. Түлхүүрийн мөр бүрээр та OAuth хэрэглэгчээр бүртгүүлэх (client_id / client_secret-ийг нэг удаа олгож) ба Цуцлах. Түлхүүрүүд нь урьдчилан тодорхойлогдсон ah- мөн Bearer токен болгон илгээгдсэн (харах Scalar).
Гаднаас нэвтрэх
Тэр Гадна нэвтрэлтийн хандалт дэлгэц нь дөрвөн блокод урвуу прокси ажиллагаа болон олон нийтийн хаягуудыг тохируулдаг:
- Өргөн нийтэд хандан хэлэх —
AIHUMMER_PUBLIC_URL (шаардлагатай): тухайн процесс нэгэн
бүгд гадна хандалтын нийтлэг хаяг.
- Зөвхөн HTTPS —
AIHUMMER_REQUIRE_SECURE.
- Проксигийн ард — найдвартай прокси, CORS гарал үүслүүд, CSP.
- Вэб UI сонсогч — хувийн Web UI портын идэвхжүүлэлт, хаяг ба гарц
Бүх талбар нь текст эсвэл унтраалга юм; хадгалсны дараа өөрчлөлт шууд хэрэгжсэн эсэх эсвэл дахин эхлүүлэх шаардлагатай эсэхийг танд хэлдэг.
IP зөвшөөрөгдсөн жагсаалт
Тэр IP зөвшөөрөгдсөн жагсаалт Дэлгэц нь CIDR-уудын ганцхан текстэн талбар бөгөөд нэг мөр тутамд нэг CIDR бичигдсэн байдаг бөгөөд энэ нь захиргааны API-д тодорхой сүлжээнүүдэд нэвтрэхийг хязгаарлана. Хоосон жагсаалт ямар нэг хязгаарлалт байхгүйг илэрхийлнэ.
[!TIP]
IP зөвшөөрөгдсөн жагсаалт нь энгийн боловч найдвартай саад болж чадна. Үүнийг хамт хэрэглэ
RBAC мөн зөвхөн HTTPS-ээр зөвхөн -аас нэвтрэх боломжийг олгоно
алба/ВПН.
Дараагийн
Энэ хуудас нь гадаад талаас экземплярт хандахыг зохицуулдаг гурван вэб UI дэлгэцийг хамардаг: **API түлхүүрүүд**, **Гаднаас нэвтрэх** болон **IP зөвшөөрөгдсөн жагсаалт**.
## API түлхүүрүүд
Тэр **API түлхүүрүүд** дэлгэцийн асуудлууд удирдлагын самбар болон чат товчлуурууд. Асуудал:
- **Хэрэглэгч** — орон нутгийн хэрэглэгчийг сонгох эсвэл лавлагааг гараар оруулах;
- түлхүүр **нэр**;
- **хамрах цар хүрээ** — сонголтын хайрцагууд: `chat`, `admin:read`, `admin:write`, `mcp`, `a2a`, `*`
(бүгд);
- нэг **Өргөлтийн хязгаар**.
Дээрх зургаан том хүрээгээс гадна, **дискрет домайн тус бүрийн хүрээ** тэдэнтэй зэрэгцэн, хэлбэрээр нь боломжтой `domain:read`, `domain:write`, `domain:*` (жишээ нь `agents:read`, `channels:write`, `memory:*`) — зөвхөн шаардлагатай домэйнууддаа түлхүүр олгоно.
Түлхүүрийн утга нь харуулагдсан **нэг удаа** — үүнийг даруй хадгалаарай. Түлхүүрийн мөр бүрээр та **OAuth хэрэглэгчээр бүртгүүлэх** (client_id / client_secret-ийг нэг удаа олгож) ба **Цуцлах**. Түлхүүрүүд нь урьдчилан тодорхойлогдсон `ah-` мөн Bearer токен болгон илгээгдсэн (харах [Scalar](/mn/v1.0/api/swagger)).
## Гаднаас нэвтрэх
Тэр **Гадна нэвтрэлтийн хандалт** дэлгэц нь дөрвөн блокод урвуу прокси ажиллагаа болон олон нийтийн хаягуудыг тохируулдаг:
- **Өргөн нийтэд хандан хэлэх** — `AIHUMMER_PUBLIC_URL` (шаардлагатай): тухайн процесс нэгэн
бүгд гадна хандалтын нийтлэг хаяг.
- **Зөвхөн HTTPS** — `AIHUMMER_REQUIRE_SECURE`.
- **Проксигийн ард** — найдвартай прокси, CORS гарал үүслүүд, CSP.
- **Вэб UI сонсогч** — хувийн Web UI портын идэвхжүүлэлт, хаяг ба гарц
Бүх талбар нь текст эсвэл унтраалга юм; хадгалсны дараа өөрчлөлт шууд хэрэгжсэн эсэх эсвэл дахин эхлүүлэх шаардлагатай эсэхийг танд хэлдэг.
## IP зөвшөөрөгдсөн жагсаалт
Тэр **IP зөвшөөрөгдсөн жагсаалт** Дэлгэц нь CIDR-уудын ганцхан текстэн талбар бөгөөд нэг мөр тутамд нэг CIDR бичигдсэн байдаг бөгөөд энэ нь захиргааны API-д тодорхой сүлжээнүүдэд нэвтрэхийг хязгаарлана. Хоосон жагсаалт ямар нэг хязгаарлалт байхгүйг илэрхийлнэ.
> [!TIP]
> IP зөвшөөрөгдсөн жагсаалт нь энгийн боловч найдвартай саад болж чадна. Үүнийг хамт хэрэглэ
> [RBAC](/mn/v1.0/webui/security) мөн зөвхөн HTTPS-ээр зөвхөн -аас нэвтрэх боломжийг олгоно
> алба/ВПН.
## Дараагийн
- [Scalar](/mn/v1.0/api/swagger) — API судлагч ба түлхүүрийн эрх олгох.
- [Сүлжээ, аудит & агаарын таслагдсан](/mn/v1.0/security/network-audit-airgapped).
- [Портын загвар](/mn/v1.0/architecture/gateway-turn-engine) — олон нийтийн ба хувийн.