Команда
Приглашайте коллег, распределяйте ответственность и отзывайте доступ, не оставляя организацию и её автоматизацию без владельца.
Членство определяет, кто входит в организацию, а роли и права доступа к ресурсам — что участники могут делать. Управляйте и членством, и правами, когда коллеги присоединяются к организации, меняют обязанности или уходят.
Пригласите нужного человека и предоставьте нужные полномочия #
Пригласите коллегу по адресу почты и выберите полномочия, которые нужно предоставить. Для управления приглашениями требуется org:manage_team или соответствующая политика приглашений. Прежде чем отправлять ещё одно приглашение тому же человеку, проверьте, нет ли уже приглашения, ожидающего принятия.
Чтобы принять приглашение, нужно войти в учётную запись с указанным адресом почты. Принять приглашение с помощью сервисного ключа не удастся. Если учётная запись не совпадает, исправьте данные учётной записи или приглашение, а не передавайте токен другой учётной записи. Если срок приглашения истёк или оно отозвано, проверьте его текущее состояние перед повторной попыткой.
При включённом RBAC приглашения не могут предоставлять полномочия владельца. Сначала пригласите человека, а после присоединения используйте защищённую операцию управления владением. Вызывающая сторона не может передавать разрешения, которых у неё нет. Если нужная роль изменилась до принятия приглашения, обновите его.
Без права доступа RBAC в приглашении по умолчанию назначается роль «Владелец». Перед отправкой убедитесь, что действительно хотите предоставить такие широкие полномочия: отсутствие выбора настраиваемой роли не означает, что доступ будет ограничен. При изменении права доступа RBAC роли текущих участников и роли в ожидающих принятия приглашениях тоже могут сброситься до роли «Владелец». Подробнее — в разделе Изменения доступа.
Назначайте роли с учётом обязанностей #
Участники могут просматривать список участников. Для назначения ролей нужны RBAC и org:manage_team. При этом проверки предотвращают повышение привилегий. Даже без назначенной роли у участника могут оставаться дополнительные права доступа к ресурсам. Поэтому снять роль — не то же самое, что прекратить членство.
Только владелец может назначить другого владельца или снять полномочия владельца. В организации должен оставаться хотя бы один владелец. Прежде чем отказаться от полномочий или выйти из организации, назначьте преемника и убедитесь, что роль назначена. Защита от удаления последнего владельца помогает сохранить непрерывность работы, но подходящего преемника организация должна выбрать сама.
Отзовите доступ и проверьте зависимые клиенты #
Чтобы прекратить участие одного человека, удалите участника или выйдите из организации. Проверьте автоматизацию, за которую отвечал уходящий коллега. Доступ личных ключей API зависит от текущего членства их создателя: когда членство прекращается, ключи теряют доступ к организации. Сервисные ключи организации от членства не зависят — отдельно проверьте их область доступа и необходимость отзыва.
Помимо учётных данных, проверьте ожидающие принятия приглашения, права доступа к общим ресурсам и то, что у организации останется владелец. Не удаляйте организацию из-за ухода участника. О замене и отзыве учётных данных читайте в разделе Ключи API.
После изменения проверьте текущий состав участников, назначенные роли и доступную запись аудита. Вызывающая сторона, которую затронули изменения, должна проверить нужный доступ через поддерживаемый интерфейс. Не передавайте ключ с более широкими полномочиями, чтобы обойти отказ в доступе.