Управление паролями реестра
Чтобы начать обмен данными и командами между устройствами и реестрами, необходимо авторизоваться. В данном разделе описано, как управлять паролями реестра для соответствующего способа авторизации.
Примечание
Если X.509 сертификат используется вместе с паролем, приоритет пароля выше.
Добавить пароль реестру
Вы можете добавить пароль уже созданному реестру или задать его при создании реестра с помощью параметра --password
.
Примечание
Задать пароль можно также из потока ввода. Для этого используйте флаг --read-password
вместо параметра --password
.
Добавить пароль уже созданному реестру
Чтобы добавить пароль уже созданному реестру:
- В консоли управления
выберите каталог, в котором вы хотите добавить пароль уже созданному реестру. - Выберите сервис IoT Core.
- Выберите в списке нужный реестр.
- В блоке Пароли нажмите кнопку Добавить пароль.
- В поле Пароль введите пароль, который вы будете использовать для доступа к реестру.
Для создания пароля можно воспользоваться генератором паролей .
Не забудьте сохранить пароль, он вам понадобится. - Нажмите кнопку Добавить.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
Чтобы добавить пароль:
-
Получите список реестров в каталоге:
yc iot registry list
Результат:
+----------------------+-------------------+ | ID | NAME | +----------------------+-------------------+ | arenou2oj4ct******** | my-registry | +----------------------+-------------------+
-
Добавьте пароль реестру:
yc iot registry password add --registry-name my-registry --password Passw0rdForRegistry
Результат:
registry_id: arenou2oj4ct******** id: areuu2hgsv6k******** created_at: "2019-12-16T15:32:46.655139Z"
Terraform
Terraform распространяется под лицензией Business Source License
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Чтобы добавить пароль реестру, созданному с помощью Terraform:
-
Опишите в конфигурационном файле параметры ресурсов, которые необходимо создать:
yandex_iot_core_registry
— параметры реестра:name
— имя реестра.description
— описание реестра.passwords
— список паролей реестра для авторизации с помощью логина и пароля.
Пример структуры ресурса в конфигурационном файле:
resource "yandex_iot_core_registry" "my_registry" { name = "test-registry" description = "test registry for terraform provider documentation" ... passwords = [ "<пароль_1>", "<пароль_2>" ] ... }
Более подробную информацию о параметрах ресурса
yandex_iot_core_registry
в Terraform, см. в документации провайдера . -
В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validate
Если конфигурация является корректной, появится сообщение:
Success! The configuration is valid.
-
Выполните команду:
terraform plan
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply
-
Подтвердите изменения: введите в терминале слово
yes
и нажмите Enter.Проверить пароли реестра можно в консоли управления
или с помощью команды CLI:yc iot registry password list --registry-name <имя_реестра>
Чтобы добавить пароль реестру, воспользуйтесь методом REST API addPassword для ресурса Registry или вызовом gRPC API RegistryService/AddPassword.
Задать пароль реестру при создании
Как задать пароль реестру при создании, читайте в разделе Создание реестра.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Создайте реестр с паролем:
yc iot registry create --name registry-with-pass --password Passw0rdForDevice
Результат:
done (1s)
id: areg96c8loru********
folder_id: b1g88tflru0e********
created_at: "2019-12-16T15:34:25.563Z"
name: registry-with-pass
status: ACTIVE
log_group_id: ckghhil3b5o9********
Как задать пароль реестру при создании, читайте в разделе Создание реестра.
Чтобы задать пароль реестру при создании, воспользуйтесь методом REST API create для ресурса Registry или вызовом gRPC API RegistryService/Create.
Получить список паролей реестра
Чтобы просмотреть список паролей реестра:
- В консоли управления
выберите каталог, в котором вы хотите получить список паролей реестра. - Выберите сервис IoT Core.
- Выберите в списке нужный реестр.
- На странице Обзор перейдите к разделу Пароли.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы получить список паролей:
-
Получите список реестров в каталоге:
yc iot registry list
Результат:
+----------------------+--------------------+ | ID | NAME | +----------------------+--------------------+ | areg96c8loru******** | registry-with-pass | | arenou2oj4ct******** | my-registry | +----------------------+--------------------+
-
Получите список паролей реестра:
yc iot registry password list --registry-name registry-with-pass
Результат:
+----------------------+---------------------+ | ID | CREATED AT | +----------------------+---------------------+ | are0gffs957e******** | 2019-12-16 15:34:25 | +----------------------+---------------------+
Чтобы получить список паролей реестра, воспользуйтесь методом REST API listPasswords для ресурса Registry или вызовом gRPC API RegistryService/ListPasswords.
Удалить пароль реестра
Чтобы удалить пароль реестра:
- В консоли управления
выберите каталог, в котором вы хотите удалить пароль реестра. - Выберите сервис IoT Core.
- Выберите в списке нужный реестр.
- В строке с нужным паролем нажмите значок
, в выпадающем списке выберите Удалить. - В открывшемся окне нажмите кнопку Удалить.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы удалить пароль:
-
Получите список паролей реестра:
yc iot registry password list --registry-name registry-with-pass
Результат:
+----------------------+---------------------+ | ID | CREATED AT | +----------------------+---------------------+ | are0gffs957e******** | 2019-12-16 15:34:25 | +----------------------+---------------------+
-
Удалите пароль:
yc iot registry password delete --registry-name registry-with-pass --password-id are0gffs957e********
-
Убедитесь, что пароль действительно удален:
yc iot registry password list --registry-name registry-with-pass
Результат:
+----+------------+ | ID | CREATED AT | +----+------------+ +----+------------+
Terraform
Terraform распространяется под лицензией Business Source License
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Чтобы удалить пароль реестра, созданного с помощью Terraform:
-
Откройте файл конфигурации Terraform и удалите значение пароля в блоке
passwords
, во фрагменте с описанием реестра. Чтобы удалить все пароли, удалите блокpasswords
целиком.Пример описания реестра в конфигурации Terraform:
resource "yandex_iot_core_registry" "my_registry" { name = "test-registry" description = "test registry for terraform provider documentation" ... passwords = [ "<пароль_1>", "<пароль_2>" ] ... }
Более подробную информацию о параметрах ресурса
yandex_iot_core_registry
в Terraform, см. в документации провайдера . -
В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validate
Если конфигурация является корректной, появится сообщение:
Success! The configuration is valid.
-
Выполните команду:
terraform plan
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply
-
Подтвердите изменения: введите в терминале слово
yes
и нажмите Enter.Проверить пароли реестра можно в консоли управления
или с помощью команды CLI:yc iot registry password list --registry-name <имя_реестра>
Чтобы удалить пароль реестра, воспользуйтесь методом REST API deletePassword для ресурса Registry или вызовом gRPC API RegistryService/DeletePassword.