Управление сертификатами устройства

Статья создана

Получить список сертификатов
Добавить сертификат
Удалить сертификат

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

Примечание

При использовании X.509 сертификата вместе с паролем, приоритет пароля выше.

Для обращения к устройству используйте его уникальный идентификатор или имя. Как узнать уникальный идентификатор или имя устройства, читайте в разделе Получение информации об устройстве.

Получить список сертификатов

Консоль управленя

CLI

API

В консоли управления выберите каталог, в котором находится устройство.
Выберите сервис Yandex IoT Core.
Выберите реестр, в котором находится устройство.
Перейдите на вкладку Устройства.
Выберите устройство.
На странице Обзор перейдите к разделу Сертификаты.

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

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

Посмотрите список сертификатов устройства:

yc iot device certificate list --device-name my-device

Результат:

+------------------------------------------+---------------------+
|               FINGERPRINT                |     CREATED AT      |
+------------------------------------------+---------------------+
| df3cc4f337eba01a264803d15b119e2d33943315 | 2019-05-29 17:14:36 |
| 65e5b050069da5ca5996a4a8a92514098b0a5dd1 | 2019-05-29 17:14:18 |
+------------------------------------------+---------------------+

Получить список сертификатов устройства можно с помощью метода API listCertificates.

Добавить сертификат

Консоль управления

CLI

Terraform

Чтобы добавить сертификат устройства:

В консоли управления выберите каталог, в который вы хотите добавить сертификат устройства.
Выберите сервис Yandex IoT Core.
Нажмите на имя нужного реестра.
В левом меню выберите Устройства.
Выберите в списке нужное устройство.
На странице Обзор перейдите к разделу Сертификаты и нажмите кнопку Добавить сертификат.
- Чтобы добавить файл:
  1. Выберите способ Файл.
  2. Нажмите Выбрать файл.
  3. Укажите файл сертификата на вашем компьютере, нажмите Открыть.
  4. Нажмите Добавить.
- Чтобы добавить текст:
  1. Выберите способ Текст.
  2. Вставьте тело сертификата в поле Содержимое.
  3. Нажмите Добавить.

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

Добавьте сертификат устройству:

yc iot device certificate add \
  --device-name my-device \ # Имя устройства.
  --certificate-file device-cert.pem # Путь к публичной части сертификата.

Результат:

device_id: b9135goeh1uc1s2i07nm
fingerprint: 65e5b050069da5ca5996a4a8a92514098b0a5dd1
certificate_data: |
  -----BEGIN CERTIFICATE-----
  MIIE/jCCAuagAwI...
  -----END CERTIFICATE-----
created_at: "2019-05-29T17:14:18.804Z"

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). Terraform и его провайдеры распространяются под лицензией Mozilla Public License.

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

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

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

Чтобы добавить сертификат устройству, созданному с помощью Terraform:

Опишите в конфигурационном файле параметры ресурсов, которые необходимо создать:
- yandex_iot_core_device — параметры устройства:
  - registry_id — идентификатор реестра, в котором создается устройство.
  - name — имя устройства.
  - description — описание устройства.
  - certificates — список сертификатов для авторизации с помощью сертификатов.
Пример описания устройства в конфигурации Terraform:
```
resource "yandex_iot_core_device" "my_device" {
  registry_id = "<идентификатор_реестра>"
  name        = "<имя_устройства>"
  description = "test device for terraform provider documentation"
...
  certificates = [
    file("<путь_к_файлу_c_сертификатом>")
  ]
...  
}
```
Более подробную информацию о параметрах ресурса yandex_iot_core_device в Terraform, см. в документации провайдера.
В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.
Проверьте корректность конфигурационного файла с помощью команды:
```
terraform validate
```
Если конфигурация является корректной, появится сообщение:
```
Success! The configuration is valid.
```
Выполните команду:
```
terraform plan
```
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
Примените изменения конфигурации:
```
terraform apply
```
Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

Проверить сертификаты устройства можно в консоли управления или с помощью команды CLI:
```
yc iot device certificate list --device-name <имя_устройства>
```

Удалить сертификат

Консоль управления

CLI

Terraform

Чтобы удалить сертификат устройства:

В консоли управления выберите каталог, из которого вы хотите удалить сертификат устройства.
Выберите сервис Yandex IoT Core.
Нажмите на имя нужного реестра.
В левом меню выберите Устройства.
Выберите в списке нужное устройство.
На странице Обзор перейдите к разделу Сертификаты.
В строке с нужным сертификатом нажмите значок , в выпадающем списке выберите Удалить.
В открывшемся окне нажмите кнопку Удалить.

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

Удалите сертификат устройства:

yc iot device certificate delete --device-name my-device --fingerprint 65...

Проверьте, что сертификат действительно удален:

yc iot device certificate list --device-name my-device

Результат:

+-------------+------------+
| FINGERPRINT | CREATED AT |
+-------------+------------+
+-------------+------------+

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

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

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

Откройте файл конфигурации Terraform и удалите значение нужного сертификата в блоке certificates, во фрагменте с описанием устройства. Чтобы удалить все сертификаты, удалите блок certificates целиком.

Пример описания устройства в конфигурации Terraform:
```
resource "yandex_iot_core_device" "my_device" {
  registry_id = "<идентификатор_реестра>"
  name        = "<имя_устройства>"
  description = "test device for terraform provider documentation"
...
  certificates = [
    file("<путь_к_файлу_c_сертификатом>")
  ]
...  
}
```
Более подробную информацию о параметрах ресурса yandex_iot_core_device в Terraform, см. в документации провайдера.
В командной строке перейдите в папку, где вы отредактировали конфигурационный файл.
Проверьте корректность конфигурационного файла с помощью команды:
```
terraform validate
```
Если конфигурация является корректной, появится сообщение:
```
Success! The configuration is valid.
```
Выполните команду:
```
terraform plan
```
В терминале будет выведен список ресурсов с параметрами. На этом этапе изменения не будут внесены. Если в конфигурации есть ошибки, Terraform на них укажет.
Примените изменения конфигурации:
```
terraform apply
```
Подтвердите изменения: введите в терминале слово yes и нажмите Enter.

Проверить сертификаты устройства можно в консоли управления или с помощью команды CLI:
```
yc iot device certificate list --device-name <имя_устройства>
```

Управление сертификатами устройства

Получить список сертификатов

Добавить сертификат

Удалить сертификат

Была ли статья полезна?