Управление паролями устройства
Чтобы начать обмен данными и командами между устройствами и реестрами, необходимо авторизоваться. В данном разделе описано, как управлять паролями устройства для соответствующего способа авторизации.
Примечание
Если X.509 сертификат используется вместе с паролем, приоритет пароля выше.
Добавить пароль устройству
Вы можете добавить пароль уже созданному устройству или задать его при создании устройства с помощью параметра --password
.
Примечание
Задать пароль можно также из потока ввода. Для этого используйте флаг --read-password
вместо параметра --password
.
Добавить пароль уже созданному устройству
Чтобы добавить пароль уже созданному устройству:
- В консоли управления
выберите каталог, в котором вы хотите добавить пароль уже созданному устройству. - Выберите сервис IoT Core.
- Выберите в списке реестр с нужным устройством.
- В левой части окна выберите раздел Устройства.
- Выберите в списке нужное устройство.
- В блоке Пароли нажмите кнопку Добавить пароль.
- В поле Пароль введите пароль, который вы будете использовать для доступа к устройству.
Для создания пароля можно воспользоваться генератором паролей .
Не забудьте сохранить пароль, он вам понадобится. - Нажмите кнопку Добавить.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
Чтобы добавить пароль:
-
Получите список устройств в реестре:
yc iot device --registry-name my-registry list
Результат:
+----------------------+--------+ | ID | NAME | +----------------------+--------+ | arenak5ciqss******** | second | | areqjd6un3af******** | first | +----------------------+--------+
-
Добавьте пароль устройству:
yc iot device password add --device-name first --password Passw0rdForDevice
Результат:
device_id: areqjd6un3af******** id: areqjd6un3af******** created_at: "2019-12-16T15:11:36.892167Z"
Terraform
Terraform распространяется под лицензией Business Source License
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Чтобы добавить пароль устройству, созданному с помощью Terraform:
-
Опишите в конфигурационном файле параметры ресурса, которые необходимо создать:
yandex_iot_core_device
— параметры устройства:registry_id
— идентификатор реестра, в котором создано устройство.name
— имя устройства.description
— описание устройства.passwords
— список паролей для авторизации с помощью логина и пароля.
Пример структуры ресурса в конфигурационном файле:
resource "yandex_iot_core_device" "my_device" { registry_id = "<идентификатор_реестра>" name = "<имя_устройства>" description = "test device for terraform provider documentation" ... passwords = [ "<пароль>", ] ... }
Более подробную информацию о параметрах ресурса
yandex_iot_core_device
в Terraform, см. в документации провайдера . -
В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validate
Если конфигурация является корректной, появится сообщение:
Success! The configuration is valid.
-
Выполните команду:
terraform plan
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply
-
Подтвердите изменения: введите в терминале слово
yes
и нажмите Enter.Проверить пароли устройства можно в консоли управления
или с помощью команды CLI:yc iot device password list --device-name <имя_устройства>
Чтобы добавить пароль устройству, воспользуйтесь методом REST API addPassword для ресурса Device или вызовом gRPC API DeviceService/AddPassword.
Задать пароль устройству при создании
Как задать пароль устройству при создании, читайте в разделе Создание устройства.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы задать пароль при создании:
-
Получите список реестров в каталоге:
yc iot registry list
Результат:
+----------------------+-------------------+ | ID | NAME | +----------------------+-------------------+ | arenou2oj4ct******** | my-registry | +----------------------+-------------------+
-
Создайте устройство с паролем:
yc iot device create --registry-name my-registry --name device-with-pass --password Passw0rdForDevice
Результат:
id: arepomfambsg******** registry_id: arenou2oj4ct******** created_at: "2019-12-16T15:18:39.358922Z" name: device-with-pass
Как задать пароль устройству при создании, читайте в разделе Создание устройства.
Чтобы задать пароль устройству при создании, воспользуйтесь методом REST API create для ресурса Device или вызовом gRPC API DeviceService/Create.
Получить список паролей устройства
Чтобы просмотреть список паролей устройства:
- В консоли управления
выберите каталог, в котором вы хотите получить список паролей устройства. - Выберите сервис IoT Core.
- Выберите в списке реестр с нужным устройством.
- В левой части окна выберите раздел Устройства.
- Выберите в списке нужное устройство.
- На странице Обзор перейдите к разделу Пароли.
В разделе Пароли отобразится список паролей устройства.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы получить список паролей:
-
Получите список устройств в реестре:
yc iot device --registry-name my-registry list
Результат:
+----------------------+------------------+ | ID | NAME | +----------------------+------------------+ | arenak5ciqss******** | second | | arepomfambsg******** | device-with-pass | | areqjd6un3af******** | first | +----------------------+------------------+
-
Получите список паролей устройства:
yc iot device password list --device-name device-with-pass
Результат:
+----------------------+---------------------+ | ID | CREATED AT | +----------------------+---------------------+ | areuin5t7pnd******** | 2019-12-16 15:18:39 | +----------------------+---------------------+
Чтобы получить список паролей устройства, воспользуйтесь методом REST API listPasswords для ресурса Device или вызовом gRPC API DeviceService/ListPasswords.
Удалить пароль устройства
Чтобы удалить пароль устройства:
- В консоли управления
выберите каталог, в котором вы хотите удалить пароль устройства. - Выберите сервис IoT Core.
- Выберите в списке реестр с нужным устройством.
- В левой части окна выберите раздел Устройства.
- Выберите в списке нужное устройство.
- В строке с нужным паролем нажмите значок
, в выпадающем списке выберите Удалить. - В открывшемся окне нажмите кнопку Удалить.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы удалить пароль:
-
Получите список паролей устройства:
yc iot device password list --device-name device-with-pass
Результат:
+----------------------+---------------------+ | ID | CREATED AT | +----------------------+---------------------+ | areuin5t7pnd******** | 2019-12-16 15:18:39 | +----------------------+---------------------+
-
Удалите пароль:
yc iot device password delete --device-name device-with-pass --password-id areuin5t7pnd********
-
Убедитесь, что пароль действительно удален:
yc iot device password list --device-name device-with-pass
Результат:
+----+------------+ | ID | CREATED AT | +----+------------+ +----+------------+
Terraform
Terraform распространяется под лицензией Business Source License
Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform
Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.
Чтобы удалить пароль устройства, созданного с помощью Terraform:
-
Откройте файл конфигурации Terraform и удалите значение нужного пароля в блоке
passwords
, во фрагменте с описанием устройства. Чтобы удалить все пароли, удалите блокpasswords
целиком.Пример описания устройства в конфигурации Terraform:
resource "yandex_iot_core_device" "my_device" { registry_id = "<идентификатор_реестра>" name = "<имя_устройства>" description = "test device for terraform provider documentation" ... passwords = [ "<пароль>", ] ... }
Более подробную информацию о параметрах ресурса
yandex_iot_core_device
в Terraform, см. в документации провайдера . -
В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.
-
Проверьте корректность конфигурационного файла с помощью команды:
terraform validate
Если конфигурация является корректной, появится сообщение:
Success! The configuration is valid.
-
Выполните команду:
terraform plan
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
-
Примените изменения конфигурации:
terraform apply
-
Подтвердите изменения: введите в терминале слово
yes
и нажмите Enter.Проверить пароли устройства можно в консоли управления
или с помощью команды CLI:yc iot device password list --device-name <имя_устройства>
Чтобы удалить пароль устройства, воспользуйтесь методом REST API deletePassword для ресурса Device или вызовом gRPC API DeviceService/DeletePassword.