Веб-интерфейс (Web UI) / Калидҳои API, дастрасии беруна ва рӯйхати иҷозат додашудаи IP
Калидҳои API, дастрасии беруна ва рӯйхати иҷозат додашудаи IP v1.2.x · навсозӣ шуд 2026-07-08 ⧉ Нусхабардорӣ ҳамчун Markdown ✓ Нусхабардорӣ шуд
Ин саҳифа се экрани Web 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 фиристода мешавад (ниг.) Шўхӣ ).
Дастрасӣ ба берун
Он Дастрасии берунӣ Шабакаи экран конфигуратсияи амалиёти прокси-баръакс ва суроғаҳои ҷамъиятиро дар чор блок танзим мекунад:
Суханронии ҷамъиятӣ — AIHUMMER_PUBLIC_URL (муттаҳидшуда): ин ҳолат ягона дорад
суроғаи ҷамъиятӣ барои дастрасии беруна
Танҳо HTTPS — AIHUMMER_REQUIRE_SECURE.
Дар паси намоянда — проксиҳои боэътимод, манобеъи CORS, CSP.
Гӯшкунандаи веб UI — иҷоза додан, суроға ва манбаи порти хусусии Web UI.
Ҳар як майдон матнӣ ё гузариш аст; ҳангоми захира кардан ба шумо мегӯянд, ки оё тағйирот фавран татбиқ шуд ё ба оғозёбии нав ниёз дорад.
Рӯйхати иҷозати IP
Он Рӯйхати иҷозати IP Экрани экран як майдони матнӣ бо CIDRҳо мебошад, якто дар ҳар сатр, ки дастрасии admin-API-ро ба шабакаҳои муайян маҳдуд мекунад. Рӯйхати холӣ маънои маҳдудият надорад.
[!TIP]
Рӯйхати иҷозати IP монеаи сахт вале боэътимод аст. Онро бо
Идоракунии дастрасӣ бо рӯйхати нақшҳо ва “танҳо HTTPS” барои иҷозат додан танҳо аз
офис/ВПН
Баъдӣ
← Қаблӣ
Буҗетҳо ва маҳдудиятҳо
Баъдӣ →
Танзимот, иҷозатнома ва система
Ин саҳифа се экрани Web 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 фиристода мешавад (ниг.) [Шўхӣ](/tg/v1.0/api/swagger)).
## Дастрасӣ ба берун
Он **Дастрасии берунӣ** Шабакаи экран конфигуратсияи амалиёти прокси-баръакс ва суроғаҳои ҷамъиятиро дар чор блок танзим мекунад:
- **Суханронии ҷамъиятӣ** — `AIHUMMER_PUBLIC_URL` (муттаҳидшуда): ин ҳолат ягона дорад
суроғаи ҷамъиятӣ барои дастрасии беруна
- **Танҳо HTTPS** — `AIHUMMER_REQUIRE_SECURE`.
- **Дар паси намоянда** — проксиҳои боэътимод, манобеъи CORS, CSP.
- **Гӯшкунандаи веб UI** — иҷоза додан, суроға ва манбаи порти хусусии Web UI.
Ҳар як майдон матнӣ ё гузариш аст; ҳангоми захира кардан ба шумо мегӯянд, ки оё тағйирот фавран татбиқ шуд ё ба оғозёбии нав ниёз дорад.
## Рӯйхати иҷозати IP
Он **Рӯйхати иҷозати IP** Экрани экран як майдони матнӣ бо CIDRҳо мебошад, якто дар ҳар сатр, ки дастрасии admin-API-ро ба шабакаҳои муайян маҳдуд мекунад. Рӯйхати холӣ маънои маҳдудият надорад.
> [!TIP]
> Рӯйхати иҷозати IP монеаи сахт вале боэътимод аст. Онро бо
> [Идоракунии дастрасӣ бо рӯйхати нақшҳо](/tg/v1.0/webui/security) ва "танҳо HTTPS" барои иҷозат додан танҳо аз
> офис/ВПН
## Баъдӣ
- [Шўхӣ](/tg/v1.0/api/swagger) — муҳаққиқи API ва иҷозатномаи калид.
- [Шабака, аудит ва ҷудошуда аз ҳаво](/tg/v1.0/security/network-audit-airgapped).
- [Намунаи бандар](/tg/v1.0/architecture/gateway-turn-engine) — ҷамъиятӣ муқоиса бо хусусӣ.