> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Області дії оператора

Операторські області дії визначають, що клієнт Gateway може робити після автентифікації.
Вони є запобіжником контрольної площини в межах одного довіреного домену оператора Gateway,
а не ізоляцією від ворожих мультитенантних середовищ. Якщо вам потрібне надійне розділення між
людьми, командами або машинами, запускайте окремі Gateways під окремими користувачами ОС або
на окремих хостах.

Пов’язано: [Безпека](/uk/gateway/security), [протокол Gateway](/uk/gateway/protocol),
[сполучення Gateway](/uk/gateway/pairing), [CLI пристроїв](/uk/cli/devices).

## Ролі

Клієнти Gateway WebSocket підключаються з однією роллю:

* `operator`: клієнти контрольної площини, як-от CLI, Control UI, автоматизація та
  довірені допоміжні процеси.
* `node`: хости можливостей, як-от macOS, iOS, Android або безголові вузли, які
  надають команди через `node.invoke`.

Методи Operator RPC потребують ролі `operator`. Методи, ініційовані вузлом,
потребують ролі `node`.

## Рівні областей дії

| Область дії             | Значення                                                                                                                                                                                                                     |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `operator.read`         | Статус лише для читання, списки, каталог, журнали, читання сеансів та інші виклики контрольної площини без змін.                                                                                                             |
| `operator.write`        | Звичайні операторські дії зі змінами, як-от надсилання повідомлень, виклик інструментів, оновлення налаштувань talk/voice і ретрансляція команд вузла. Також задовольняє `operator.read`.                                    |
| `operator.admin`        | Адміністративний доступ до контрольної площини. Задовольняє кожну область дії `operator.*`. Потрібен для зміни конфігурації, оновлень, нативних хуків, чутливих зарезервованих просторів імен і високоризикових затверджень. |
| `operator.pairing`      | Керування сполученням пристроїв і вузлів, зокрема перегляд списку, затвердження, відхилення, видалення, ротація та відкликання записів сполучення або токенів пристроїв.                                                     |
| `operator.approvals`    | API затверджень exec і plugin.                                                                                                                                                                                               |
| `operator.talk.secrets` | Читання конфігурації Talk із включеними секретами.                                                                                                                                                                           |

Невідомі майбутні області дії `operator.*` потребують точного збігу, якщо викликач не має
`operator.admin`.

## Область дії методу — лише перший шлюз

Кожен Gateway RPC має область дії методу за принципом найменших привілеїв. Ця область дії методу визначає,
чи може запит дійти до обробника. Деякі обробники потім застосовують суворіші
перевірки під час затвердження на основі конкретного об’єкта, який затверджується або змінюється.

Приклади:

* `device.pair.approve` доступний із `operator.pairing`, але затвердження
  операторського пристрою може видати або зберегти лише ті області дії, які викликач уже має.
* `node.pair.approve` доступний із `operator.pairing`, а потім виводить додаткові
  області дії затвердження зі списку команд вузла, що очікує.
* `chat.send` зазвичай є методом з областю дії на запис, але постійні `/config set`
  і `/config unset` потребують `operator.admin` на рівні команди.

Це дає змогу операторам із нижчими областями дії виконувати низькоризикові дії сполучення, не роблячи
всі затвердження сполучення доступними лише адміністраторам.

## Затвердження сполучення пристроїв

Записи сполучення пристроїв є довготривалим джерелом затверджених ролей і областей дії.
Уже сполучені пристрої не отримують ширший доступ непомітно: повторні підключення, які запитують
ширшу роль або ширші області дії, створюють новий запит на оновлення, що очікує.

Під час затвердження запиту пристрою:

* Запит без ролі оператора не потребує затвердження області дії операторського токена.
* Запит для ролі пристрою, що не є оператором, як-от `node`, потребує
  `operator.admin`, навіть коли `device.pair.approve` доступний із
  `operator.pairing`.
* Запит для `operator.read`, `operator.write`, `operator.approvals`,
  `operator.pairing` або `operator.talk.secrets` потребує, щоб викликач мав
  ці області дії або `operator.admin`.
* Запит для `operator.admin` потребує `operator.admin`.
* Запит на виправлення без явних областей дії може успадкувати наявні області дії
  операторського токена. Якщо цей наявний токен має область дії адміністратора, затвердження все одно потребує
  `operator.admin`.

Неадміністративні сеанси зі спільним секретом і довіреним проксі можуть затверджувати запити операторських пристроїв
лише в межах власних оголошених операторських областей дії. Затвердження ролей, що не є операторськими,
доступне лише адміністраторам, навіть коли ці сеанси інакше можуть використовувати
`operator.pairing`.

Для сеансів токенів сполучених пристроїв керування також обмежене власною областю, якщо
викликач не має `operator.admin`: неадміністративні викликачі бачать лише власні записи
сполучення, можуть затверджувати або відхиляти лише власний запит, що очікує, і можуть ротувати,
відкликати або видаляти лише власний запис пристрою.

## Затвердження сполучення вузлів

Застарілий `node.pair.*` використовує окреме сховище сполучення вузлів, що належить Gateway. Вузли WS
використовують сполучення пристроїв із `role: node`, але застосовується той самий словник
рівнів затвердження.

`node.pair.approve` використовує список команд запиту, що очікує, щоб вивести додаткові
потрібні області дії:

* Запит без команд: `operator.pairing`
* Команди вузла без exec: `operator.pairing` + `operator.write`
* `system.run`, `system.run.prepare` або `system.which`:
  `operator.pairing` + `operator.admin`

Сполучення вузла встановлює ідентичність і довіру. Воно не замінює власну політику
затвердження exec для `system.run` у вузлі.

## Автентифікація зі спільним секретом

Автентифікація зі спільним токеном/паролем Gateway розглядається як довірений операторський доступ для
цього Gateway. HTTP-поверхні, сумісні з OpenAI, `/tools/invoke` і HTTP-кінцеві точки історії сеансів
відновлюють звичайний повний стандартний набір операторських областей дії для
bearer-автентифікації зі спільним секретом, навіть якщо викликач надсилає вужчі оголошені області дії.

Режими з ідентичністю, як-от автентифікація через довірений проксі або private-ingress `none`,
усе ще можуть враховувати явно оголошені області дії. Використовуйте окремі Gateways для реального розділення
меж довіри.