Управление участниками

В Team workspace можно приглашать коллег и выбирать, получат ли они доступ ко всему workspace или только к назначенным проектам.

Приглашение участника

1. Откройте Settings → Участники.
2. Нажмите Invite Member.
3. Укажите email и выберите роль.
4. Отправьте приглашение.

Ссылка из письма действует 7 дней. Получателю нужно войти в аккаунт или создать его, а затем подтвердить присоединение.

Совет

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

Роли workspace

Встроенная роль определяет доступ во всём workspace.

Owner

Владелец workspace с полным контролем. Только Owner может передать владение или удалить workspace. В workspace может быть только один Owner.

Admin

Управляет проектами, командой, группами доступа, настройками и биллингом, но не может удалить workspace или передать владение.

Developer

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

Member

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

Viewer

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

Contributor

Состоит в workspace и видит команду, но не получает доступ к проектам автоматически. Проект появится у Contributor только после прямого назначения или добавления через группу доступа.

На каждом назначенном проекте Contributor получает одну из проектных ролей:

• Project Admin — полный контроль над проектом и его доступом;
• Project Developer — деплои и изменение настроек без управления доступом к проекту;
• Project Viewer — просмотр без изменений.

Contributor не может создавать новые проекты и не видит карточки неназначенных проектов.

Billing

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

Как ограничить доступ проектами

Выберите один из двух способов:

• Прямое назначение — удобно для одного человека и одного-двух проектов. Откройте Project Settings → Доступ и выберите участника и проектную роль.
• Группа доступа — удобна, если одинаковый набор участников работает с несколькими проектами. Откройте Settings → Группы доступа.

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

Подробнее: Группы доступа.

Осторожно

Developer, Member и Viewer имеют доступ ко всем проектам workspace. Чтобы действительно скрыть неназначенные проекты, используйте роль Contributor.

Кастомные роли

На Enterprise можно создать workspace-роль на основе Developer, Member или Viewer и добавить ей нужные возможности. Такая роль, как и её основа, действует во всём workspace. Для ограничения списком проектов используйте Contributor и проектные роли.

Кастомные роли находятся в Settings → Роли. Подробнее: Кастомные роли.

Эффективные права

Итоговый доступ к проекту складывается из роли workspace, прямого назначения и всех подходящих групп доступа. На странице участника можно открыть Эффективные права и проверить, какие возможности он получил и откуда.

Изменения доступа применяются к открытым сессиям автоматически. Если проект отозван у Contributor, его карточка и обновления этого проекта исчезнут после переподключения.

Управление участниками

Изменение роли

1. Откройте Settings → Участники.
2. Найдите участника и откройте меню роли.
3. Выберите новую роль.

Owner не может понизить себя. Сначала передайте владение другому Admin.

Удаление участника

После удаления участник теряет доступ к workspace и ко всем назначенным проектам. Созданные им проекты и деплои остаются.

Передача владения

Owner может выбрать участника с ролью Admin, нажать Transfer Ownership и подтвердить действие slug workspace. Бывший Owner становится Admin.

Управление через API

API находится под /v1. Для session-запросов передавайте активный workspace в заголовке X-Workspace.

# Участники и приглашения
GET    /v1/workspace-members
POST   /v1/workspace-members/invite
PATCH  /v1/workspace-members/{memberId}/role
DELETE /v1/workspace-members/{memberId}

# Группы доступа
GET    /v1/access-groups
POST   /v1/access-groups
GET    /v1/access-groups/{groupId}
POST   /v1/access-groups/{groupId}/members
POST   /v1/access-groups/{groupId}/projects

# Прямой доступ к проекту
GET    /v1/project-access/{projectId}/assignments
PUT    /v1/project-access/{projectId}/assignments/{userId}
DELETE /v1/project-access/{projectId}/assignments/{userId}
GET    /v1/project-access/{projectId}/permissions

Для приглашения Contributor передайте:

{
  "email": "user@example.com",
  "role": "CONTRIBUTOR"
}

При назначении проекта передайте projectRole: ADMIN, DEVELOPER или VIEWER.

Лимиты планов

Возможность	Hobby	Pro	Enterprise
Участники	Только Owner	До 10	100+
Contributor и прямые назначения	—	Да	Да
Группы доступа	—	До 10	До 100
Кастомные роли	—	—	Да

Hobby предназначен для одного владельца. Для совместной работы перейдите на Pro или Enterprise.

См. также

• Workspaces
• Создание Team Workspace
• Группы доступа
• Кастомные роли
• Биллинг