Начало работы

Чтобы начать работу c сервисом Yandex IoT Core:

Перед началом работы

  1. Перейдите в консоль управления, затем войдите в Облако или зарегистрируйтесь, если вы еще не зарегистрированы.
  2. На странице биллинга убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе ACTIVE или TRIAL_ACTIVE. Если платежного аккаунта нет, создайте его.
  3. Если у вас еще нет каталога, создайте его.

Создайте сертификат

Устройство и реестр взаимодействуют с помощью X.509 сертификатов:

  • Если у вас есть сертификат, просто добавьте его к устройству в реестре.

  • Если у вас нет сертификата, его можно создать, например, с помощью программы OpenSSL. Используйте следующие параметры:

    • -x509 — X.509 сертификат
    • newkey — алгоритм шифрования.
    • -keyout — файл, в который будет записан приватный ключ.
    • -out — файл, в который будет сохранен сертификат.
    • -nodes — флаг. Устанавливается, когда не надо шифровать публичный ключ.
    • -days — срок действия сертификата в днях.
    • -subj — объект запроса.
    $ openssl req -x509 \
    -newkey rsa:4096 \
    -keyout key.pem \
    -out cert.pem \
    -nodes \
    -days 365 \
    -subj '/CN=localhost'
    

Создайте реестр

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

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

Чтобы создать реестр:

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

    $ yc iot registry create --name my-registry
    
    id: b91hafek85hpppnbpld2
    folder_id: aoek49ghmknnpj1ll45e
    created_at: "2019-05-27T13:40:06.923Z"
    name: my-registry
    
  2. Добавьте реестру сертификат:

    $ yc iot registry certificate add \
    --registry-name my-registry \ # Имя реестра.
    --certificate-file ./certs/registry-cert.pem # Путь к публичной части сертификата.
    
    registry_id: b91hafek85hpppnbpld2
    fingerprint: 589ce16050****
    certificate_data: |
      -----BEGIN CERTIFICATE-----
      MIIE/jCCAuagAwIBAgIJAPRA...
      -----END CERTIFICATE-----
    created_at: "2019-05-27T13:41:45.295Z"
    

Создайте устройство

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

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

Чтобы создать устройство:

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

    $ yc iot device create \
    --registry-name my-registry \ # Имя реестра.
    --name my-device # Имя устройства.
    
    id: b912an77oqaeijolmlgm
    registry_id: b91hafek85hpppnbpld2
    created_at: "2019-05-27T13:44:35.164Z"
    name: my-device
    
  2. Добавьте устройству сертификат:

    $ yc iot device certificate add \
    --device-name my-device \ # Имя устройства.
    --certificate-file ./certs/device-cert.pem # Путь к публичной части сертификата.
    
    device_id: b912an77oqaeijolmlgm
    fingerprint: 65e5b05006...
    certificate_data: |
      -----BEGIN CERTIFICATE-----
     MIIE/jCCAuagAwIBAgIJANZbq...
      -----END CERTIFICATE-----
    created_at: "2019-05-27T13:45:23.306Z"
    

Настройте обмен сообщениями между устройствами и реестрами

Узнайте, как:

Что дальше