Veb-interfeys (Web UI)/API kalitlari, tashqi kirish va IP ruxsatlar ro'yxati
API kalitlari, tashqi kirish va IP ruxsatlar ro'yxati
v1.1.x · yangilandi 2026-07-08
Ushbu sahifa tashqi tomondan instansiyaga kirishni boshqaradigan uchta Veb UI ekranini qamrab oladi: API kalitlari, Tashqi kirish va IP ruxsat ro’yxati.
API kalitlari
API kalitlari ekran muammolari boshqaruv samolyoti va suhbat tugmalari. Muammo:
Foydalanuvchi — mahalliy foydalanuvchini tanlang yoki havolani qo’lda kiriting;
Yuqoridagi oltita xom ko‘lamlardan tashqari, har bir domen bo‘yicha nozik diapazonlar ular bilan birga, shaklida mavjud domain:read, domain:write, domain:* (masalan, agents:read, channels:write, memory:*) — kalitga faqat unga kerak bo‘lgan domenlarni berish.
Kalit qiymati ko‘rsatilgan bir marta — uni darhol saqlang. Har bir tugma qatori uchun siz OAuth mijoz sifatida ro’yxatdan o’ting (bir marta client_id / client_secret beradi) va Bekor qilish. Kalitlar old qo‘shimcha bilan berilgan ah- va Bearer tokeni sifatida yuborilgan (qarang Ojiz ko‘rinish).
Tashqi kirish
Tashqi kirish Ekran to‘rt blokda reverse-proxy ish faoliyati va jamoat manzillarini sozlaydi:
Ommaviy murojaat — AIHUMMER_PUBLIC_URL (talab qilinadi): namuna bitta
barcha tashqi kirish uchun jamoat manzili.
Faqat HTTPS — AIHUMMER_REQUIRE_SECURE.
Proksi ortida — ishonchli proksi-serverlar, CORS kelib chiqishlari, CSP.
Veb UI tinglovchi — shaxsiy Web UI portini yoqish, manzil va kelib chiqishi.
Har bir maydon matn yoki tugma; saqlashda sizga o’zgarish jonli qo’llanilganini yoki qayta ishga tushirish kerakligini aytishadi.
IP ruxsat ro’yxati
IP ruxsat ro’yxati screen – bu CIDRlarning bitta matn oynasi, har bir qatorda bittadan, va bu admin-APIga kirishni ma’lum tarmoqlarga cheklaydi. Bo’sh ro’yxat cheklov yo’qligini anglatadi.
[!TIP]
IP ruxsat ro‘yxati nozik emas, lekin ishonchli to‘siqdir. Uni bilan birlashtiring
RBAC va faqat HTTPS orqali kirishni faqat foydalanishga ruxsat berish uchun
ofis/VPN.
Keyingi
Ojiz ko‘rinish — API tadqiqotchisi va kalit orqali ruxsat berish.
Ushbu sahifa tashqi tomondan instansiyaga kirishni boshqaradigan uchta Veb UI ekranini qamrab oladi: **API kalitlari**, **Tashqi kirish** va **IP ruxsat ro'yxati**.
## API kalitlari
**API kalitlari** ekran muammolari boshqaruv samolyoti va suhbat tugmalari. Muammo:
- **Foydalanuvchi** — mahalliy foydalanuvchini tanlang yoki havolani qo'lda kiriting;
- kalit **ism**;
- **doiralar** — katakchalar: `chat`, `admin:read`, `admin:write`, `mcp`, `a2a`, `*`
(hamma);
- bir **RPM chegarasi**.
Yuqoridagi oltita xom ko‘lamlardan tashqari, **har bir domen bo‘yicha nozik diapazonlar** ular bilan birga, shaklida mavjud `domain:read`, `domain:write`, `domain:*` (masalan, `agents:read`, `channels:write`, `memory:*`) — kalitga faqat unga kerak bo‘lgan domenlarni berish.
Kalit qiymati ko‘rsatilgan **bir marta** — uni darhol saqlang. Har bir tugma qatori uchun siz **OAuth mijoz sifatida ro'yxatdan o'ting** (bir marta client_id / client_secret beradi) va **Bekor qilish**. Kalitlar old qo‘shimcha bilan berilgan `ah-` va Bearer tokeni sifatida yuborilgan (qarang [Ojiz ko‘rinish](/uz/v1.0/api/swagger)).
## Tashqi kirish
**Tashqi kirish** Ekran to‘rt blokda reverse-proxy ish faoliyati va jamoat manzillarini sozlaydi:
- **Ommaviy murojaat** — `AIHUMMER_PUBLIC_URL` (talab qilinadi): namuna bitta
barcha tashqi kirish uchun jamoat manzili.
- **Faqat HTTPS** — `AIHUMMER_REQUIRE_SECURE`.
- **Proksi ortida** — ishonchli proksi-serverlar, CORS kelib chiqishlari, CSP.
- **Veb UI tinglovchi** — shaxsiy Web UI portini yoqish, manzil va kelib chiqishi.
Har bir maydon matn yoki tugma; saqlashda sizga o'zgarish jonli qo'llanilganini yoki qayta ishga tushirish kerakligini aytishadi.
## IP ruxsat ro'yxati
**IP ruxsat ro'yxati** screen – bu CIDRlarning bitta matn oynasi, har bir qatorda bittadan, va bu admin-APIga kirishni ma'lum tarmoqlarga cheklaydi. Bo'sh ro'yxat cheklov yo'qligini anglatadi.
> [!TIP]
> IP ruxsat ro‘yxati nozik emas, lekin ishonchli to‘siqdir. Uni bilan birlashtiring
> [RBAC](/uz/v1.0/webui/security) va faqat HTTPS orqali kirishni faqat foydalanishga ruxsat berish uchun
> ofis/VPN.
## Keyingi
- [Ojiz ko‘rinish](/uz/v1.0/api/swagger) — API tadqiqotchisi va kalit orqali ruxsat berish.
- [Tarmoq, audit va havo ajratilgan](/uz/v1.0/security/network-audit-airgapped).
- [Port modeli](/uz/v1.0/architecture/gateway-turn-engine) — jamoat vs shaxsiy.