Организации и роли
Как устроен доступ внутри компании: одна организация — несколько участников с разными правами.
Организация
Организация — это юрлицо или команда, для которой настраиваются:
- название и код (
slug); - лимиты расходов через правила;
- участники и ключи;
- модели и политики безопасности.
При регистрации создаётся организация и первый участник с ролью владелец (owner).
Роли
| Роль | По-русски | Кратко |
|---|---|---|
owner | владелец | полный доступ; один на организацию |
admin | администратор | команда, ключи, политики, SSO |
developer | участник | свои ключи, свои логи и свой расход |
viewer | наблюдатель | просмотр организации без изменений и без логов |
Что может каждая роль
| Действие | Владелец | Админ | Участник | Наблюдатель |
|---|---|---|---|---|
| Вход в кабинет | ✓ | ✓ | ✓ | ✓ |
| Свои ключи моделей | ✓ | ✓ | ✓ | — |
| Ключи моделей организации | ✓ | ✓ | — | просмотр |
| Ключи Management API | ключи владельцев и администраторов | ключи владельцев и администраторов | только свои | — |
| Логи запросов | вся организация | вся организация | только свои | — |
| Потребление | вся организация | вся организация | только свои ключи | вся организация |
| Журнал действий | вся организация | вся организация | только свои | только свои |
| Счета и баланс | ✓ | ✓ | — | просмотр |
| Guardrails, группы, системы | ✓ | ✓ | — | — |
| Приглашать участников | ✓ | ✓ | — | — |
| Настраивать SSO | ✓ | ✓ | — | — |
Участник работает в своём пространстве: свои ключи моделей, логи своих запросов, свой расход и ключ Management API с теми же правами, что у него в кабинете. Разделы счетов, политик, виртуальных групп и систем ему не показываются. Наблюдатель видит расходы и счета организации, но не логи запросов и не ключи управления.
Участники и приглашения
- Администратор создаёт секретную ссылку-приглашение с выбранной ролью.
- Передаёт ссылку сотруднику любым удобным способом.
- Сотрудник открывает ссылку, вводит email и пароль (или входит существующим аккаунтом).
- Участник появляется в списке и работает в кабинете организации.
Инструкция: Приглашение сотрудника.
Вход
- Email и пароль — локальный вход.
- SSO — корпоративный вход через OIDC (настройка SSO).
Для API платформы используется токен входа в заголовке Authorization: Bearer ….
Изоляция данных
Расходы, ключи и лимиты вашей организации не пересекаются с другими компаниями на платформе.
Типовой сценарий
- Владелец регистрирует компанию.
- Администратор приглашает участников и наблюдателя.
- Администратор включает модели и выпускает API-ключ.
- Участник подключает приложение своим ключом и смотрит свои логи и свой расход.
- Наблюдатель смотрит расходы и счета организации.