Управление пользователями БД

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

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

yc managed-mongodb user list
  --cluster-name <имя кластера>

Имя кластера можно запросить со списком кластеров в каталоге.

Получить список пользователей можно с помощью метода list.

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы создать пользователя в кластере:

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

   yc managed-mongodb user create --help
   

2. Укажите свойства пользователя в команде создания:

   yc managed-mongodb user create <имя пользователя>
     --cluster-name <имя кластера>
     --password <пароль для пользователя>
     --permission database=<имя БД>,role=<роль>,role=<другая роль>,...
     --permission database=<имя другой БД>,role=<роль>,...
   

   Примечание

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

   Длина пароля от 8 до 128 символов.

   Имя кластера можно запросить со списком кластеров в каталоге.

1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

   О том, как создать такой файл, см. в разделе Создание MongoDB-кластера.

2. Добавьте к описанию кластера Managed Service for MongoDB блок user:

   resource "yandex_mdb_mongodb_cluster" "<имя кластера>" {
     ...
     user {
       name     = "<имя пользователя>"
       password = "<пароль>"
       permission {
         database_name = "<имя базы данных, к которой предоставляется доступ>"
         roles         = [ "<список ролей пользователя>" ]
       }
     }
   }
   

   Примечание

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

   Длина пароля от 8 до 128 символов.

3. Проверьте корректность настроек.

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

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

      terraform validate
      

      Если в файлах конфигурации есть ошибки, Terraform на них укажет.

4. Подтвердите изменение ресурсов.

   1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

   2. Если вас устраивают планируемые изменения, внесите их:

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

         terraform apply
         

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

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

Добавить пользователей можно с помощью метода create.

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

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

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

   yc managed-mongodb user update --help
   

2. Укажите свойства пользователя в команде изменения:

   yc managed-mongodb user update <имя пользователя>
     --cluster-name <имя кластера>
     --password <пароль для пользователя>
     --permission database=<имя БД>,role=<роль>,role=<другая роль>,...
     --permission database=<имя другой БД>,role=<роль>,...
   

   Примечание

   Длина пароля от 8 до 128 символов.

Чтобы добавить пользователю доступ к базе данных с определенным набором ролей:

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

   yc managed-mongodb user grant-permission --help
   

2. Укажите свойства пользователя в команде выдачи прав:

   yc managed-mongodb user grant-permission <имя пользователя> \
      --cluster-name <имя кластера> \
      --database <имя БД> \
      --permissions <набор ролей через запятую>
   

Чтобы отозвать доступ у пользователя к базе данных:

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

   yc managed-mongodb user revoke-permission --help
   

2. Укажите свойства пользователя в команде отзыва прав:

   yc managed-mongodb user revoke-permission <имя пользователя> \
      --cluster-name <имя кластера> \
      --database <имя БД>
   

   Эта команда полностью закрывает доступ пользователю к указанной базе данных.

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

1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

   О том, как создать такой файл, см. в разделе Создание MongoDB-кластера.

2. Найдите в описании кластера Managed Service for MongoDB блок user для нужного пользователя.

3. Измените значение полей password и permission:

   resource "yandex_mdb_mongodb_cluster" "<имя кластера>" {
     ...
     user {
       name     = "<имя пользователя>"
       password = "<новый пароль>"
       permission {
         database_name = "<имя базы данных>"
         roles         = [ "<новый список ролей пользователя>" ]
       }
     }
   }
   

   Примечание

   Длина пароля от 8 до 128 символов.

4. Проверьте корректность настроек.

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

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

      terraform validate
      

      Если в файлах конфигурации есть ошибки, Terraform на них укажет.

5. Подтвердите изменение ресурсов.

   1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

   2. Если вас устраивают планируемые изменения, внесите их:

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

         terraform apply
         

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

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

Воспользуйтесь методом API update и передайте в запросе:

• Идентификатор кластера, в котором находится пользователь, в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
• Имя пользователя в параметре userName. Чтобы узнать имя, получите список пользователей в кластере.
• Имя базы данных, для которой вы хотите изменить список ролей пользователя, в параметре permissions.databaseName. Чтобы узнать имя, получите список баз данных в кластере.
• Массив нового списка ролей пользователя в параметре permissions.roles.
• Список полей конфигурации пользователя, подлежащих изменению (в данном случае — permissions), в параметре updateMask.

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы удалить пользователя, выполните команду:

yc managed-mongodb user delete <имя пользователя>
  --cluster-name <имя кластера>

Имя кластера можно запросить со списком кластеров в каталоге.

1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

   О том, как создать такой файл, см. в разделе Создание MongoDB-кластера.

2. Удалите из описания кластера Managed Service for MongoDB блок user с описанием нужного пользователя.

3. Проверьте корректность настроек.

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

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

      terraform validate
      

      Если в файлах конфигурации есть ошибки, Terraform на них укажет.

4. Подтвердите изменение ресурсов.

   1. Выполните команду для просмотра планируемых изменений:

      terraform plan
      

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

   2. Если вас устраивают планируемые изменения, внесите их:

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

         terraform apply
         

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

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

Удалить пользователя можно с помощью метода delete.

Выполните следующую команду:

yc managed-mongodb user create user2 \
  --cluster-name <имя кластера> \
  --password <пароль пользователя> \
  --permission database=db1,role=read

Выполните следующую команду:

yc managed-mongodb user grant-permission user1 \
   --cluster-name cluster1 \
   --database db2 \
   --permission read

1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

   О том, как создать такой файл, см. в разделе Создание MongoDB-кластера.

2. Найдите в описании кластера Managed Service for MongoDB блок user для пользователя user1.

3. Добавьте блок permission:

   resource "yandex_mdb_mongodb_cluster" "cluster1" {
     ...
     user {
       name     = "user1"
       password = "<пароль>"
       ...
       permission {
         database_name = "db2"
         roles         = [ "read" ]
       }
     }
   }
   

   1. Проверьте корректность настроек.

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

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

         terraform validate
         

         Если в файлах конфигурации есть ошибки, Terraform на них укажет.

   2. Подтвердите изменение ресурсов.

      1. Выполните команду для просмотра планируемых изменений:

         terraform plan
         

         Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

      2. Если вас устраивают планируемые изменения, внесите их:

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

            terraform apply
            

         2. Подтвердите изменение ресурсов.

         3. Дождитесь завершения операции.

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