> ## 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-группы, посещения, заявки и отзыв.

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

Для постоянного сотрудника с учёткой Telepúrte используйте [пользовательский грант](https://docs.axottle.com/ru/telepurte/roles.md) со сроком. Гостевой доступ — отдельный ресурс со своей ссылкой, системным логином, посещениями и записями сессий.

## Создание гостевого доступа

Откройте **Временный доступ** и пройдите мастер:

1. Выберите временный сценарий.
2. Найдите конкретные ноды, группы или метки. Выбранные источники объединяются без дубликатов; проверьте итоговый список.
3. Укажите разрешённые Linux-группы и срок окончания.
4. Выберите, допускается одно или несколько одновременных посещений.
5. Проверьте сводку и создайте доступ.

Ноды должны быть проверены по SSH, а агенты — поддерживать подготовку управляемых учёток и разрешать выбранные группы. На каждом сервере создаётся отдельная управляемая учётка гостя.

**Одно одновременное посещение** ограничивает параллельную работу. Это не означает «ссылка сгорает после первого открытия»: возможность следующего посещения зависит от действующего срока и состояния гранта.

## Подготовка и выдача

Сначала грант находится в `pending`. В карточке видна подготовка каждой ноды. Доступ становится `active` после подтверждения всех выбранных серверов; одна ошибка подготовки не должна оставлять гостю незаметно урезанный набор машин.

Ссылка показывается только при создании. Скопируйте её и передайте адресату доверенным способом. Новый грант также выдаёт отдельный SSH-пароль и системный логин; пароль показывается один раз. Не публикуйте ссылку или пароль в общем журнале работ.

| Состояние | Что означает |
| - | - |
| `pending` | Учётки ещё подготавливаются |
| `active` | Подготовка завершена, посещения разрешены до срока |
| `revoked` | Доступ отозван администратором |
| `expired` | Срок истёк |

## Что видит гость

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

Гость выбирает ноду и работает в терминале. Подключение проходит через бастион и записывается. При завершении посещения, отзыве или истечении срока доступ к действующей сессии прекращается при очередной проверке.

## Вход обычным SSH-клиентом

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

Для старого действующего гранта без пароля администратор может выпустить его в карточке. Повторный выпуск отменяет предыдущий пароль и открытые с ним SSH-сессии. Браузерные посещения при этом продолжают работать: для полного закрытия доступа отзовите сам грант.

## Контроль работы

Карточка гранта показывает подготовку серверов, посещения, их время, IP, User-Agent и сведения браузера. Связанные SSH-сессии доступны в общем списке с переходом к гранту. Для разбора действий используйте [запись терминала и аудит](https://docs.axottle.com/ru/telepurte/audit.md).

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

## Заявка зарегистрированного пользователя

Отдельно поддерживается SSH-доступ по заявке: администратор включает политику для проверенной ноды, задаёт нерутовый системный логин и максимальный срок. Пользователь указывает причину и срок, владелец принимает или отклоняет заявку. Одобрение создаёт обычный временный SSH-грант, а не гостевую ссылку.

Этот сценарий доступен через API заявок `/api/v1/access/ssh-requests`; не путайте его с гостевым мастером. Если нода, пользователь или политика изменились с момента подачи, одобрение может потребовать новой заявки.

## Проверка

До передачи ссылки дождитесь готовности всех серверов. В отдельной гостевой сессии проверьте список нод, терминал и отсутствие обычных разделов панели. После пробного отзыва убедитесь, что повторное открытие ссылки и новый SSH-вход запрещены.

## Откат

Отзовите грант в карточке. Это закрывает новые посещения и действующие подключения через него, но не возвращает файлы и настройки, изменённые гостем. Их восстанавливают отдельно по согласованному плану; историю доступа сохраняют для проверки.

Для управляемых Linux-учёток требуется совместимый агент и разрешающая локальная политика.


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