Настроить доступ к управлению группой

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

Чтобы выдать права доступа на группу пользователей:

1. Посмотрите описание команды CLI для назначения роли:

   yc organization-manager group add-access-binding --help
   

2. Получите список групп пользователей вместе с идентификаторами этих групп:

   yc organization-manager group list \
     --organization-id <идентификатор_организации>
   

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

4. С помощью команды yc organization-manager group add-access-binding назначьте роль:

   yc organization-manager group add-access-binding \
     --id <идентификатор_группы> \
     --role <роль> \
     --subject <тип_субъекта>:<идентификатор_субъекта>
   

   Где:

   • --id — идентификатор группы пользователей, к которой нужно предоставить доступ.

   • --role — идентификатор роли.

   • --subject — обозначение субъекта, которому назначается роль.

     Обозначения субъектов

     Для обозначения субъекта используется параметр --subject со значением в формате <тип_субъекта>:<идентификатор>. Для некоторых типов субъектов в Yandex Cloud CLI вместо --subject доступны отдельные параметры, в которых достаточно указать имя или идентификатор субъекта без типа. Возможные обозначения субъектов и соответствующие параметры CLI:

     Тип субъекта	Обозначение субъекта	Параметр Yandex Cloud CLI
     userAccount	userAccount:<идентификатор_пользователя>	--user-account-id или --user-yandex-login
     serviceAccount	serviceAccount:<идентификатор_сервисного_аккаунта>	--service-account-id или --service-account-name
     federatedUser	federatedUser:<идентификатор_пользователя>	--user-account-id
     group	group:<идентификатор_группы>	--group-members
     system	system:allAuthenticatedUsers (группа All authenticated users)	--all-authenticated-users
     	system:allUsers (группа All users)	—
     	system:group:organization:<идентификатор_организации>:users (группа All users in organization X)	--organization-users
     	system:group:federation:<идентификатор_федерации>:users (группа All users in federation N)	--federation-users
     	system:group:userpool:<идентификатор_пула>:users (группа All users in userpool P)	—

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, аутентифицируйтесь соответствующим способом.

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

2. Опишите в конфигурационном файле параметры назначаемых ролей:

   resource "yandex_organizationmanager_group_iam_member" "editor" {
     group_id = "<идентификатор_группы>"
     role     = "<идентификатор_роли>"
     member   = "<субъект>"
   }
   

   Где:

   • group_id — идентификатор группы пользователей.

   • role — назначаемая роль. Обязательный параметр.

   • member — обозначение субъекта, которому назначается роль. Обязательный параметр.

     Обозначения субъектов

     Для обозначения субъекта используется комбинация типа и уникального идентификатора — <тип_субъекта>:<идентификатор>. Возможные обозначения субъектов:

     Тип субъекта	Обозначение субъекта
     userAccount	userAccount:<идентификатор_пользователя>
     serviceAccount	serviceAccount:<идентификатор_сервисного_аккаунта>
     federatedUser	federatedUser:<идентификатор_пользователя>
     group	group:<идентификатор_группы>
     system	system:allAuthenticatedUsers (группа All authenticated users)
     	system:allUsers (группа All users)
     	system:group:organization:<идентификатор_организации>:users (группа All users in organization X)
     	system:group:federation:<идентификатор_федерации>:users (группа All users in federation N)
     	system:group:userpool:<идентификатор_пула>:users (группа All users in userpool P)

   Подробнее о параметрах ресурса yandex_organizationmanager_group_iam_member читайте в документации провайдера.

3. Создайте ресурсы:

   1. В терминале перейдите в директорию с конфигурационным файлом.

   2. Проверьте корректность конфигурации с помощью команды:

      terraform validate
      

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.
      

   3. Выполните команду:

      terraform plan
      

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

   4. Примените изменения конфигурации:

      terraform apply
      

   5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

После этого указанным субъектам будут назначены роли на группу пользователей. Проверить назначение роли можно в интерфейсе Cloud Center.

Чтобы назначить роль субъекту на группу пользователей, воспользуйтесь методом REST API updateAccessBindings для ресурса Group или вызовом gRPC API GroupService/UpdateAccessBindings и передайте в запросе:

• Значение ADD в параметре accessBindingDeltas[].action, чтобы добавить роль.

• Роль в параметре accessBindingDeltas[].accessBinding.roleId.

• Идентификатор субъекта, которому назначается роль, в параметре accessBindingDeltas[].accessBinding.subject.id.

• Тип субъекта, которому назначается роль, в параметре accessBindingDeltas[].accessBinding.subject.type.

  Обозначения субъектов

  Для обозначения субъекта используется комбинация типа и уникального идентификатора в полях запроса subject.type и subject.id. Возможные комбинации:

  subject.type	subject.id
  userAccount	<идентификатор_пользователя>
  serviceAccount	<идентификатор_сервисного_аккаунта>
  federatedUser	<идентификатор_пользователя>
  group	<идентификатор_группы>
  system	allAuthenticatedUsers (группа All authenticated users)
  	allUsers (группа All users)
  	group:organization:<идентификатор_организации>:users (группа All users in organization X)
  	group:federation:<идентификатор_федерации>:users (группа All users in federation N)
  	group:userpool:<идентификатор_пула>:users (группа All users in userpool P)

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

Чтобы назначить несколько ролей на группу пользователей:

1. Убедитесь, что на ресурс не назначены роли, которые вы не хотите потерять:

   yc organization-manager group list-access-bindings \
     --id <идентификатор_группы>
   

2. Посмотрите описание команды CLI для назначения ролей:

   yc organization-manager group set-access-bindings --help
   

3. Получите список групп пользователей вместе с идентификаторами этих групп:

   yc organization-manager group list
   

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

5. С помощью команды yc organization-manager group set-access-bindings назначьте роли:

   yc organization-manager group set-access-bindings \
     --id <идентификатор_группы> \
     --access-binding role=<роль>,subject=<тип_субъекта>:<идентификатор_субъекта>
   

   Где:

   • --id — идентификатор группы пользователей, к которой нужно предоставить доступ.

   • role — идентификатор роли, которую нужно назначить.

   • subject — обозначение субъекта, которому назначается роль.

     Обозначения субъектов

     Для обозначения субъекта используется комбинация типа и уникального идентификатора — <тип_субъекта>:<идентификатор>. Возможные обозначения субъектов:

     Тип субъекта	Обозначение субъекта
     userAccount	userAccount:<идентификатор_пользователя>
     serviceAccount	serviceAccount:<идентификатор_сервисного_аккаунта>
     federatedUser	federatedUser:<идентификатор_пользователя>
     group	group:<идентификатор_группы>
     system	system:allAuthenticatedUsers (группа All authenticated users)
     	system:allUsers (группа All users)
     	system:group:organization:<идентификатор_организации>:users (группа All users in organization X)
     	system:group:federation:<идентификатор_федерации>:users (группа All users in federation N)
     	system:group:userpool:<идентификатор_пула>:users (группа All users in userpool P)

   Для каждой роли передайте отдельный параметр --access-binding. Пример:

   yc organization-manager group set-access-bindings \
     --id ins672qpemb4******** \
     --access-binding role=<роль1>,subject=serviceAccount:<идентификатор_сервисного_аккаунта> \
     --access-binding role=<роль2>,subject=serviceAccount:<идентификатор_сервисного_аккаунта> \
     --access-binding role=<роль3>,subject=serviceAccount:<идентификатор_сервисного_аккаунта>
   

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, аутентифицируйтесь соответствующим способом.

Чтобы назначить несколько ролей на группу пользователей:

1. Опишите в конфигурационном файле параметры назначаемых ролей:

   resource "yandex_organizationmanager_group_iam_member" "role1" {
     group_id = "<идентификатор_группы>"
     role     = "<роль1>"
     member   = "<тип_субъекта>:<идентификатор_субъекта>"
   }
   
   resource "yandex_organizationmanager_group_iam_member" "role2" {
     group_id = "<идентификатор_группы>"
     role     = "<роль2>"
     member   = "<тип_субъекта>:<идентификатор_субъекта>"
   }
   
   resource "yandex_organizationmanager_group_iam_member" "role3" {
     group_id = "<идентификатор_группы>"
     role     = "<роль3>"
     member   = "<тип_субъекта>:<идентификатор_субъекта>"
   }
   

   Где:

   • group_id — идентификатор группы пользователей.

   • role — роль, которую хотите назначить.

   • member — обозначение субъекта, которому назначается роль.

     Обозначения субъектов

     Для обозначения субъекта используется комбинация типа и уникального идентификатора — <тип_субъекта>:<идентификатор>. Возможные обозначения субъектов:

     Тип субъекта	Обозначение субъекта
     userAccount	userAccount:<идентификатор_пользователя>
     serviceAccount	serviceAccount:<идентификатор_сервисного_аккаунта>
     federatedUser	federatedUser:<идентификатор_пользователя>
     group	group:<идентификатор_группы>
     system	system:allAuthenticatedUsers (группа All authenticated users)
     	system:allUsers (группа All users)
     	system:group:organization:<идентификатор_организации>:users (группа All users in organization X)
     	system:group:federation:<идентификатор_федерации>:users (группа All users in federation N)
     	system:group:userpool:<идентификатор_пула>:users (группа All users in userpool P)

   Подробнее о параметрах ресурса yandex_organizationmanager_group_iam_member читайте в документации провайдера.

2. Создайте ресурсы:

   1. В терминале перейдите в директорию с конфигурационным файлом.

   2. Проверьте корректность конфигурации с помощью команды:

      terraform validate
      

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.
      

   3. Выполните команду:

      terraform plan
      

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

   4. Примените изменения конфигурации:

      terraform apply
      

   5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

После этого указанному субъекту будут назначены несколько ролей на группу пользователей. Проверить назначение ролей можно в интерфейсе Cloud Center.

Чтобы назначить несколько ролей субъекту на группу пользователей, воспользуйтесь методом REST API setAccessBindings для ресурса Group или вызовом gRPC API GroupService/SetAccessBindings. Передайте в запросе массив из объектов, каждый из которых соответствует отдельной роли и содержит следующие данные:

• Роль в параметре accessBindings[].roleId.

• Идентификатор субъекта, которому назначаются роли, в параметре accessBindings[].subject.id.

• Тип субъекта, которому назначаются роли, в параметре accessBindings[].subject.type.

  Обозначения субъектов

  Для обозначения субъекта используется комбинация типа и уникального идентификатора в полях запроса subject.type и subject.id. Возможные комбинации:

  subject.type	subject.id
  userAccount	<идентификатор_пользователя>
  serviceAccount	<идентификатор_сервисного_аккаунта>
  federatedUser	<идентификатор_пользователя>
  group	<идентификатор_группы>
  system	allAuthenticatedUsers (группа All authenticated users)
  	allUsers (группа All users)
  	group:organization:<идентификатор_организации>:users (группа All users in organization X)
  	group:federation:<идентификатор_федерации>:users (группа All users in federation N)
  	group:userpool:<идентификатор_пула>:users (группа All users in userpool P)

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id. Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

1. Посмотрите описание команды CLI для отзыва роли:

   yc organization-manager group remove-access-binding --help
   

2. Получите список групп пользователей вместе с идентификаторами этих групп:

   yc organization-manager group list \
     --organization-id <идентификатор_организации>
   

3. Получите идентификатор пользователя, сервисного аккаунта или группы пользователей, у которых отзываете роль.

4. С помощью команды yc organization-manager group remove-access-binding отзовите роль у субъекта:

   yc organization-manager group remove-access-binding \
     --id <идентификатор_группы> \
     --role <роль> \
     --subject <тип_субъекта>:<идентификатор_субъекта>
   

   Где:

   • --id — идентификатор группы пользователей, к которой был предоставлен доступ.

   • --role — идентификатор роли, которую нужно отозвать.

   • --subject — обозначение субъекта, у которого отзывается роль.

     Обозначения субъектов

     Для обозначения субъекта используется параметр --subject со значением в формате <тип_субъекта>:<идентификатор>. Для некоторых типов субъектов в Yandex Cloud CLI вместо --subject доступны отдельные параметры, в которых достаточно указать имя или идентификатор субъекта без типа. Возможные обозначения субъектов и соответствующие параметры CLI:

     Тип субъекта	Обозначение субъекта	Параметр Yandex Cloud CLI
     userAccount	userAccount:<идентификатор_пользователя>	--user-account-id или --user-yandex-login
     serviceAccount	serviceAccount:<идентификатор_сервисного_аккаунта>	--service-account-id или --service-account-name
     federatedUser	federatedUser:<идентификатор_пользователя>	--user-account-id
     group	group:<идентификатор_группы>	--group-members
     system	system:allAuthenticatedUsers (группа All authenticated users)	--all-authenticated-users
     	system:allUsers (группа All users)	—
     	system:group:organization:<идентификатор_организации>:users (группа All users in organization X)	--organization-users
     	system:group:federation:<идентификатор_федерации>:users (группа All users in federation N)	--federation-users
     	system:group:userpool:<идентификатор_пула>:users (группа All users in userpool P)	—

Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

Чтобы управлять инфраструктурой с помощью Terraform от имени сервисного аккаунта или пользовательских аккаунтов: аккаунта на Яндексе, федеративного аккаунта и локального пользователя, аутентифицируйтесь соответствующим способом.

Чтобы отозвать роль у пользователя, сервисного аккаунта или группы пользователей:

1. Откройте конфигурационный файл Terraform и удалите фрагмент с ресурсом yandex_organizationmanager_group_iam_member, соответствующим роли, которую хотите отозвать.

   resource "yandex_organizationmanager_group_iam_member" "editor" {
     group_id = "<идентификатор_группы>"
     role     = "<идентификатор_роли>"
     member   = "<тип_субъекта>:<идентификатор_субъекта>"
   }
   

   Где:

   • group_id — идентификатор группы пользователей.

   • role — отзываемая роль. Обязательный параметр.

   • member — обозначение субъекта, у которого отзывается роль. Обязательный параметр.

     Обозначения субъектов

     Для обозначения субъекта используется комбинация типа и уникального идентификатора — <тип_субъекта>:<идентификатор>. Возможные обозначения субъектов:

     Тип субъекта	Обозначение субъекта
     userAccount	userAccount:<идентификатор_пользователя>
     serviceAccount	serviceAccount:<идентификатор_сервисного_аккаунта>
     federatedUser	federatedUser:<идентификатор_пользователя>
     group	group:<идентификатор_группы>
     system	system:allAuthenticatedUsers (группа All authenticated users)
     	system:allUsers (группа All users)
     	system:group:organization:<идентификатор_организации>:users (группа All users in organization X)
     	system:group:federation:<идентификатор_федерации>:users (группа All users in federation N)
     	system:group:userpool:<идентификатор_пула>:users (группа All users in userpool P)

2. Примените изменения:

   1. В терминале перейдите в директорию с конфигурационным файлом.

   2. Проверьте корректность конфигурации с помощью команды:

      terraform validate
      

      Если конфигурация является корректной, появится сообщение:

      Success! The configuration is valid.
      

   3. Выполните команду:

      terraform plan
      

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

   4. Примените изменения конфигурации:

      terraform apply
      

   5. Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

После этого роль будет отозвана у указанного субъекта. Проверить отсутствие роли можно в интерфейсе Cloud Center.

Чтобы отозвать роль у субъекта на группу пользователей, воспользуйтесь методом REST API updateAccessBindings для ресурса Group или вызовом gRPC API GroupService/UpdateAccessBindings и передайте в запросе:

• Значение REMOVE в параметре accessBindingDeltas[].action, чтобы отозвать роль.

• Роль в параметре accessBindingDeltas[].accessBinding.roleId.

• Идентификатор субъекта, у которого отзывается роль, в параметре accessBindingDeltas[].accessBinding.subject.id.

• Тип субъекта, у которого отзывается роль, в параметре accessBindingDeltas[].accessBinding.subject.type.

  Обозначения субъектов

  Для обозначения субъекта используется комбинация типа и уникального идентификатора в полях запроса subject.type и subject.id. Возможные комбинации:

  subject.type	subject.id
  userAccount	<идентификатор_пользователя>
  serviceAccount	<идентификатор_сервисного_аккаунта>
  federatedUser	<идентификатор_пользователя>
  group	<идентификатор_группы>
  system	allAuthenticatedUsers (группа All authenticated users)
  	allUsers (группа All users)
  	group:organization:<идентификатор_организации>:users (группа All users in organization X)
  	group:federation:<идентификатор_федерации>:users (группа All users in federation N)
  	group:userpool:<идентификатор_пула>:users (группа All users in userpool P)