Подключиться
Yandex IoT Core

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

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

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

Примечание

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

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

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

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

Если у вас еще нет интерфейса командной строки 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.

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

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

  1. В консоли управления выберите каталог, в который вы хотите добавить сертификат устройства.

  2. Выберите сервис Yandex IoT Core.

  3. Нажмите на имя нужного реестра.

  4. В левом меню выберите Устройства.

  5. Выберите в списке нужное устройство.

  6. На странице Обзор перейдите к разделу Сертификаты и нажмите кнопку Добавить сертификат.

    • Чтобы добавить файл:

      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"

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

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

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

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

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

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

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

    $ yc iot device certificate list --device-name my-device
+-------------+------------+
| FINGERPRINT | CREATED AT |
+-------------+------------+
+-------------+------------+
В этой статье: