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

# Роли, гранты и эффективный доступ

> Права панели и серверов, наследование, личные учётки, прямые разрешения, запреты и проверка результата.

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

## Какие права нужно различать

| Уровень | Примеры | Чего он не делает |
| - | - | - |
| Разделы панели | `nodes.read`, `users.manage`, `roles.manage`, `audit.read` | Сам по себе не открывает SSH |
| Доступ к нодам | Ноды, группы, метки или все ноды; системный логин | Не отменяет Linux-права и запреты |
| Действия | Shell, типизированные операции, профиль команды, файловые операции | Не расширяет локальную политику агента |
| Область проекта | Проекты пользователя и делегирующего администратора | Не создаёт грант |
| Политики и запреты | Запрет пути, действия, логина, лимит сессий | Ограничивают разрешения, не выдают их |

Владелец имеет особые полномочия. Именованная роль с наследованием не превращается в владельца лишь из-за названия или связи с другой ролью.

## Создать роль

В **Роли доступа** запустите мастер. Задайте понятное название и описание задачи, например **Операторы тестового окружения**. Выберите права интерфейса, затем доступ к нодам и при необходимости родительские роли. Перед сохранением проверьте итог.

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

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

## Выбор нод и системного логина

Для роли можно выбрать конкретные ноды, группы, метки или все ноды. Группы и метки — динамический выбор: будущая подходящая машина попадёт под правило. Если доступ должен остаться только на текущих серверах, выбирайте их явно.

**Личная учётка пользователя** подходит для индивидуального системного логина. Telepúrte подготовит её через агент, а роль определит, где разрешён вход. **Существующий системный логин** нужен, если работа должна идти под уже созданной учёткой. Отдельно проверьте необходимость групп, sudo и shell-команд.

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

## Наследование и запреты

Роль может наследовать другие роли. Разрешения складываются, но действующий запрет имеет приоритет над разрешением. Запрет может относиться к пользователю или роли, отдельной ноде, проекту, группе, метке либо всей области; для файлов дополнительно учитывается путь.

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

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

## Разовый грант пользователю

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

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

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

## Пример роли для тестового окружения

Создайте группу `env=test`. Выдайте роли просмотр нод и доступ к этой группе через личную учётку. Не включайте sudo, если задача ограничена файлами приложения в доступном пользователю каталоге. Назначьте роль тестовому оператору и дождитесь подготовки учётки.

Проверьте вход на `env=test` и отказ на `env=prod`. Затем добавьте новую тестовую ноду: она должна попасть в область правила после подготовки. Если этого не требуется, замените группу явным списком.

> [!NOTE]
>
> Файловые запреты Web SFTP не являются изоляцией интерактивного shell. Пользователь с терминалом и достаточными правами Linux может работать с файлами командами. Ограничивайте системную учётку и sudo в соответствии с задачей.

## Проверка

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

## Откат

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

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


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