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

# Агенты и локальные разрешения

> Подключение агентов, SSH-подготовка, возможности ноды, политики действий, обновление и диагностика.

Агент выполняет операции на ноде и сообщает о её состоянии. Он нужен для мониторинга, автоматизации, подготовки управляемых Linux-учёток и агентного SSH-туннеля. Наличие агента не выдаёт пользователям права: доступ Telepúrte и локальные разрешения ноды проверяются вместе.

## Два варианта подключения

Для импортированных нод используется **Axottle Agent** с отдельной привязкой к Telepúrte. Подключение запускается из **Импорт Axottle**; не требуется ставить второй агент только ради интеграции.

Для автономной ноды предусмотрен отдельный **Telepúrte Agent**. Он устанавливается из подписанной поставки и регистрируется одноразовым кодом, связанным с нужной нодой. Не переносите конфигурацию с идентичностью одного сервера на другой.

## Что смотреть в панели

Раздел **Агенты** и вкладка **Агент** в карточке ноды показывают связь, версию и готовность. Сверьте, что выбран именно агент нужной машины. Состояние online означает недавнее сообщение, но не подтверждает поддержку всех новых действий.

Перед работой проверьте отдельно:

* присутствие ноды и правильную привязку агента;
* время последнего сообщения;
* версию и поддержку нужного действия;
* локальное разрешение на конкретный ресурс;
* результат SSH-подготовки, если нужен терминал;
* состояние личных или временных учёток, если вход идёт через них.

## Подключение отдельного Telepúrte Agent

Возьмите `install-agent.sh` и комплект одной версии из официальной поставки. Как и для панели, сначала выполните `--dry-run`, затем установку с выбранной версией и `--bundle`. Установщик сохраняет конфигурацию и ключи при обновлении.

Создайте приватную конфигурацию `/etc/telepurte-agent/config.json` с адресом панели `control_origin`, ID установки `instance_id`, ID ноды `host_id` и путями файлов идентичности. Используйте значения именно вашей установки. Файл должен принадлежать сервисному пользователю и иметь режим `0600`.

Полученный код регистрации поместите в защищённый файл, доступный `telepurte-agent`, и выполните:

```bash theme={null}
sudo -u telepurte-agent telepurte-agent enroll \
  --config /etc/telepurte-agent/config.json \
  --token-file /var/lib/telepurte-agent/enrollment.token
sudo -u telepurte-agent telepurte-agent check \
  --config /etc/telepurte-agent/config.json
sudo systemctl enable --now telepurte-agent
```

Не передавайте код в аргументе процесса или URL. После регистрации клиент удаляет файл кода. Локальная команда `check` проверяет файлы, а серверный online появится после связи с панелью.

## Разрешения на операции

| Настройка отдельного агента | Что ограничивает |
| - | - |
| `allowed_start_units` | Запуск точных systemd-service |
| `allowed_stop_units` | Остановку; для перезапуска нужны оба списка |
| `allowed_file_paths` | Точные пути конфигураций для проверки и применения |
| `allowed_packages` | Пакеты для типизированных действий |
| `allowed_users` | Системных пользователей для соответствующих действий |
| `command_profiles` | Фиксированные команды и явно разрешённый ad hoc |
| `managed_accounts`, `allowed_managed_groups` | Подготовку личных и временных учёток |
| `ssh_tunnel_enabled`, `ssh_tunnel_port` | Разрешение локального SSH-туннеля |

Это настройки отдельного Telepúrte Agent; у интегрированного Axottle Agent используйте его поддерживаемую процедуру настройки. Не заменяйте целиком существующую конфигурацию примером фрагмента.

Разрешение в списке не повышает права Linux. Для привилегированных типизированных действий нужны соответствующие локальные помощники с собственной политикой. Для записи файла нужны также права на каталог и разрешение записи в системных ограничениях службы. Пустые списки не следует трактовать как «разрешено всё».

## SSH-подготовка

Агентная подготовка настраивает доверие SSH и подтверждает ключ ноды. Обычный heartbeat не заменяет эту процедуру. Ошибки `ca_conflict` или `config_conflict` означают, что существующие настройки нужно разобрать перед заменой.

При незавершённой изменяющей операции со статусом неопределённого результата сначала проверьте фактический sshd и доверие на машине. Слепой автоматический повтор может перезаписать уже изменившееся состояние.

Для импортированных нод предусмотрена явная массовая замена прежней SSH CA в разделе агентов. Выполняйте её только после проверки состава целей и совместимости Axottle Agent; подробности связи — [здесь](https://docs.axottle.com/ru/telepurte/access.md).

## Обновление

Обновление панели Telepúrte не обновляет автоматически отдельные агенты. Если действие требует новой возможности, сначала обновите агент поддерживаемым для его типа способом, дождитесь свежего сообщения и повторите предпросмотр задания.

Изменение политики после предпросмотра может дать `policy_changed`: создайте новую проверку целей. Это ожидаемая защита от выполнения по устаревшим разрешениям.

## Проверка

Проверьте версию, online и привязку, выполните читающую диагностику. Затем проверьте ровно одно разрешённое действие на тестовом ресурсе. Для туннеля отдельно откройте SSH и убедитесь в правильном системном логине.

## Откат

Верните прежнюю локальную политику и перезапустите агент, отзовите ошибочную регистрацию в панели. Не удаляйте идентичность без необходимости: для повторной регистрации нужны согласованные действия на ноде и в Telepúrte. Уже выполненные операции откатываются отдельно.

Набор экранов и действий зависит от версии компонентов и действующих прав.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.