# Участники и доступ

> Роли в организации, доступ к проектам и приложениям и ключ агента.

> Оглавление всей документации: https://docs.getxflow.com/llms.txt

Роль в организации задаёт, что человек может вообще. Доступ к проекту задаёт, какие проекты он
видит и может ли их менять. Уровень приложения задаёт, кто откроет его по адресу.

Всё про организацию в «Настройках» (меню организации внизу бокового меню):

| Раздел | Что там | Кому виден |
|---|---|---|
| Организация | название, логотип, владелец, идентификатор | всем |
| Участники | состав, роли, приглашения; вкладка «Группы» | всем; правит Админ, группы ещё и Редактор |
| Тариф, Счета | [тариф, лимиты и оплата](https://docs.getxflow.com/platform/billing.md), счета за тариф и серверы баз | Админу |

## Роли в организации

| Роль | Код в `xflow org members` | Что может |
|---|---|---|
| Админ | `owner` | всё: проекты, участники, тариф и счета, настройки. Видит и правит все проекты |
| Редактор | `developer` | создаёт проекты и правит те, где ему дали «Редактирование». Не меняет состав организации и тариф |
| Просмотр | `member` | смотрит и пользуется тем, чем с ним поделились: приложения и проекты на чтение, без логов и настроек |

Роль это потолок: «Просмотр» не получит правку в проекте, даже если её выдали. Повысят до
Редактора, и выданная правка заработает. Админов может быть несколько, они равны.

Логов функций и приложений роль «Просмотр» не видит: там бывают персональные данные клиентов.

## Владелец организации

Один из Админов отмечен короной, в интерфейсе он «Владелец», обычно создатель организации:

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

Корону передаёт её хозяин другому Админу пунктом «Передать владение» в списке участников.

## Приглашения и смена ролей

Приглашает, меняет роли и удаляет участников только Админ, в веб-интерфейсе. Агент только
смотрит состав: `xflow org members`. Число людей ограничено тарифом, в счёт идут все роли и
неотвеченные приглашения ([Тарифы и лимиты](https://docs.getxflow.com/platform/billing.md)).

## Доступ к проекту

Новый проект видят автор и Админы. В окне «Пригласить» его открывают всей организации или
выбранным людям и группам (группы на платных тарифах).

| Уровень | Что можно |
|---|---|
| Просмотр | видеть приложения, версии, функции, данные на чтение, файлы, имена переменных |
| Редактирование | всё то же, плюс выкладывать и публиковать, менять базу и миграции, переменные, расписания, файлы и доступ |

Новая выдача получает «Просмотр», уровень меняют в том же окне. Выдают доступ Админ и
Редактор с правкой в этом проекте. Человека не из организации Админ приглашает из того же
окна, роль подберётся по уровню.

Удалить проект может автор или Админ: [Проекты](https://docs.getxflow.com/platform/projects.md).

## Доступ к приложению

У каждого приложения свой уровень: «Участники проекта» или «Любой по ссылке» (со Старта).
Меняют его в интерфейсе на экране приложения. Подробно: [Приложения](https://docs.getxflow.com/platform/apps.md).

## Ключ агента

Агент работает с ключом участника, который выдаётся при `xflow login` после подтверждения
человеком (Админом или Редактором): [Установка и вход](https://docs.getxflow.com/cli/install.md). Ключ один на участника и
организацию.

В каждом проекте ключ получает уровень своего хозяина. При «Просмотре» чтение работает, а
изменение отвечает `forbidden`: правку выдаёт человек в окне
доступа проекта. При понижении роли личный ключ отзывается. `xflow whoami` показывает, чей
ключ, в какой организации и с какими правами.