> ## 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.

# Связь с Axottle

> Вход через Axottle, подключение агентов, права проектов, проверка SSH и диагностика синхронизации.

После [установки](https://docs.axottle.com/ru/telepurte/installation.md) откройте Telepúrte и войдите локальным владельцем. Этот вход позволяет проверить интеграцию и выдать права независимо от SSO.

## Вход через Axottle

Пользователь выбирает вход через Axottle, подтверждает переход и при необходимости проходит MFA согласно политике Telepúrte. Внешняя учётная запись связывается по стабильному идентификатору Axottle. Совпадающий логин локального пользователя не объединяет две учётки.

Синхронизация создаёт профили заранее, но не создаёт сессию входа и не назначает роль локального владельца.

## Добавление нод

**1. Проверьте импорт**

Откройте **Импорт Axottle** в Telepúrte. Убедитесь, что нужные ноды, их IP и проекты присутствуют в каталоге. Axottle отправляет инвентарь после запуска и затем раз в минуту.

**2. Запустите подключение**

Для одной ноды нажмите **Добавить** в её строке, для парка — **Добавить все**. Подтвердите обновление Axottle Agent и запустите задание.

**3. Дождитесь подготовки**

Задание обновляет агент, подключает его к Telepúrte с отдельной идентификацией, готовит SSH и проверяет ключ хоста. Оно продолжает выполняться после закрытия страницы. Результаты успешных и неудачных подключений показаны отдельно.

**4. Проверьте терминал**

После успешной подготовки проверьте SSH-доступ владельца. Для браузерного терминала и Web SFTP должен быть доступен настроенный шлюз Telepúrte с HTTPS-маршрутом.

Повторное добавление позволяет восстановить незавершённую подготовку. Смена IP требует новой проверки личности хоста. Ошибка подключения Telepúrte к агенту сама по себе не означает, что нода Axottle выключена.

## Права пользователей и проектов

Членство в проектах передаётся из Axottle. Оно ограничивает область доступа, но само по себе не разрешает SSH. Для доступа используйте роли и индивидуальные разрешения Telepúrte.

В Axottle также есть явная настройка пользователя **Доступ ко всем SSH-машинам назначенных проектов**. При её включении Telepúrte создаёт управляемый доступ под `root` к машинам этих проектов. Выключение отзывает именно этот доступ; отдельно выданные роли и разрешения Telepúrte продолжают действовать в пределах членства.

> [!WARNING]
>
> Разрешение входить в Axottle, успешный SSO и доступ под `root` — разные права. Проверяйте итоговые разрешения пользователя перед передачей доступа к парку.

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

## Синхронизация и отзыв

Список пользователей обновляется раз в минуту. Если свежий список не поступает три минуты, доступ импортированных учёток приостанавливается, включая открытые подключения. Локальный вход владельца остаётся отдельным способом восстановления.

Неактивная или исчезнувшая из полного списка учётка блокируется у получателя. Возвращение активного состояния не включает профиль, который локальный владелец отключил в Telepúrte. Исчезновение ноды из Axottle также не удаляет её историю в Telepúrte.

## Типовые проблемы

| Симптом | Что проверить |
| - | - |
| Нода видна, но терминал недоступен | Завершение подключения агента, проверку SSH-ключа, права пользователя и состояние шлюза |
| Нет ноды или пользователя | Свежесть синхронизации, выбранный проект и активность связи с Axottle |
| Работает локальный вход, но не SSO | Активность учётки в Axottle, MFA и свежесть списка пользователей |
| `ca_conflict` или `config_conflict` | Наличие прежней SSH CA; изучите конфликт до замены доверия |
| Подключение перестало работать после смены IP | Повторную проверку хоста и актуальные права |
| Данные о здоровье устарели | Возраст последнего снимка Axottle; это отдельная проверка от готовности SSH |

Для конфликтов прежней SSH CA в разделе агентов Telepúrte предусмотрена массовая замена с явным подтверждением. Требуется Axottle Agent 1.3.15 или новее. Применяйте её только к нодам, для которых действительно нужно заменить прежнюю привязку.

## Дальнейшая работа в Telepúrte

После импорта используйте [страницу ноды](https://docs.axottle.com/ru/telepurte/node-workspace.md), [роли и гранты](https://docs.axottle.com/ru/telepurte/roles.md), [терминал](https://docs.axottle.com/ru/telepurte/terminal.md) и [плейбуки](https://docs.axottle.com/ru/telepurte/playbooks.md). Связь с Axottle — один из способов наполнить каталог и войти; остальные возможности Telepúrte описаны в самостоятельных главах.

## Проверка

Под обычной учётной записью проверьте список доступных машин, вход на одну разрешённую ноду и отказ для ноды вне её прав. После тестового отзыва разрешения убедитесь, что новый вход больше не разрешён. Для Web SFTP отдельно проверьте разрешённый путь и права файловой операции.

## Откат

Отзовите выданную роль или разрешение в Telepúrte. Если доступ был выдан переключателем Axottle, выключите его и дождитесь синхронизации. Проверьте оставшиеся независимые разрешения. Отключение пользователя в Telepúrte закрывает его доступ, но не удаляет серверы и уже выполненные на них изменения.

Сценарий требует совместимых версий обеих панелей и агентов.


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