Создание и подготовка устройств IoT Edge в масштабе в Linux с помощью симметричного ключа

Создание индивидуальной регистрации DPS

1. На портале Azure перейдите к вашему экземпляру службы регистрации устройств Центр Интернета вещей.

2. В разделе Параметрывыберите Управление регистрациями.

3. Выберите Добавить отдельную регистрацию и выполните следующие действия для настройки регистрации.

   1. Для параметра Механизм выберите Симметричный ключ.

   2. Укажите уникальный идентификатор регистрации для своего устройства.

   3. При необходимости укажите идентификатор устройства Центр Интернета вещей для устройства. Идентификаторы устройств можно использовать, чтобы указать отдельное устройство для развертывания модуля. Если не указать идентификатор устройства, используется идентификатор регистрации.

   4. Выберите True, чтобы объявить, что регистрация предназначена для устройства IoT Edge.

   5. При необходимости добавьте значение тега в параметр Первоначальное состояние двойника устройства. Теги можно использовать для указания групп устройств для развертывания модуля. Например:

      {
         "tags": {
            "environment": "test"
         },
         "properties": {
            "desired": {}
         }
      }
      

   6. Нажмите Сохранить.

4. Скопируйте значение Primary Key для индивидуальной регистрации, используемое при установке среды выполнения IoT Edge.

Теперь, когда для этого устройства существует учетная запись, исполняющая среда IoT Edge может автоматически подготавливать устройство во время установки.

Создание групповой регистрации в DPS

1. На портале Azure перейдите к вашему экземпляру службы регистрации устройств Центр Интернета вещей.

2. В разделе Параметрывыберите Управление регистрациями.

3. Выберите Добавить отдельную регистрацию и выполните следующие действия для настройки регистрации.

   1. Укажите имя группы.

   2. В качестве типа аттестации выберите вариант Симметричный ключ.

   3. Выберите True, чтобы объявить, что регистрация предназначена для устройства IoT Edge. Для групповой регистрации все устройства должны быть устройствами IoT Edge или ни одно из них не может быть таковым.

   4. При необходимости добавьте значение тега в параметр Первоначальное состояние двойника устройства. Теги можно использовать для указания групп устройств для развертывания модуля. Например:

      {
         "tags": {
            "environment": "test"
         },
         "properties": {
            "desired": {}
         }
      }
      

   5. Нажмите Сохранить.

4. Скопируйте значение первичного ключа вашей группы регистрации, чтобы использовать его при создании ключей устройств для регистрации группы.

Теперь, когда существует группа регистрации, среда выполнения IoT Edge может автоматически подготавливать устройства во время установки.

Получение ключа устройства

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

Чтобы создать ключ устройства, используйте ключ, который вы скопировали из своей группы регистрации DPS, чтобы вычислить HMAC-SHA256 для уникального идентификатора регистрации устройства и преобразовать результат в формат Base64.

В Windows можно использовать PowerShell для создания производного ключа устройства, как показано в следующем примере.

Замените значение KEY значением первичного ключа, записанным ранее.

Замените значение REG_ID идентификатором регистрации вашего устройства.

$KEY='PASTE_YOUR_ENROLLMENT_KEY_HERE'
$REG_ID='PASTE_YOUR_REGISTRATION_ID_HERE'

$hmacsha256 = New-Object System.Security.Cryptography.HMACSHA256
$hmacsha256.key = [Convert]::FromBase64String($KEY)
$sig = $hmacsha256.ComputeHash([Text.Encoding]::ASCII.GetBytes($REG_ID))
$derivedkey = [Convert]::ToBase64String($sig)
echo "`n$derivedkey`n"

Ниже приведен пример выходных данных производного ключа устройства:

Jsm0lyGpjaVYVP2g3FnmnmG9dI/9qU24wNoykUmermc=

Вы можете установить IoT Edge с помощью нескольких команд. Откройте терминал и выполните следующие команды:

• 24.04:

  wget https://packages.microsoft.com/config/ubuntu/24.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
  sudo dpkg -i packages-microsoft-prod.deb
  rm packages-microsoft-prod.deb
  

• 22.04:

  wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
  sudo dpkg -i packages-microsoft-prod.deb
  rm packages-microsoft-prod.deb
  

Его можно установить с помощью APT и выполнить несколько команд. Откройте терминал и выполните следующие команды:

• 12 - Книжный червь (arm32v7):

  curl https://packages.microsoft.com/config/debian/12/packages-microsoft-prod.deb > ./packages-microsoft-prod.deb
  sudo apt install ./packages-microsoft-prod.deb
  

• 11 - Bullseye (arm32v7):

  curl https://packages.microsoft.com/config/debian/11/packages-microsoft-prod.deb > ./packages-microsoft-prod.deb
  sudo apt install ./packages-microsoft-prod.deb
  

Вы можете установить IoT Edge с помощью нескольких команд. Откройте терминал и выполните следующие команды:

• 9.x (amd64):

    wget https://packages.microsoft.com/config/rhel/9.0/packages-microsoft-prod.rpm -O packages-microsoft-prod.rpm
    sudo yum localinstall packages-microsoft-prod.rpm
    rm packages-microsoft-prod.rpm
  

• 8.x (amd64):

    wget https://packages.microsoft.com/config/rhel/8/packages-microsoft-prod.rpm -O packages-microsoft-prod.rpm
    sudo yum localinstall packages-microsoft-prod.rpm
    rm packages-microsoft-prod.rpm
  

Вы устанавливаете исполняемую среду IoT Edge из Snap Store на последующих шагах. Переходите к следующему разделу.

Установите движок Moby.

sudo apt-get update; \
  sudo apt-get install moby-engine

Установите движок Moby.

sudo apt-get update; \
  sudo apt-get install moby-engine

Установите модуль Moby и CLI.

sudo yum install moby-engine moby-cli

curl -ssl https://raw.githubusercontent.com/moby/moby/master/contrib/check-config.sh -o check-config.sh
chmod +x check-config.sh
./check-config.sh

IoT Edge имеет зависимости от Docker и Службы удостоверений Интернета вещей. Установите зависимости с помощью следующих команд:

sudo snap install docker
sudo snap install azure-iot-identity

Оснащение Docker поддерживается компанией Canonical и пригодно для промышленных сценариев.

1. Создайте или измените существующий файл конфигурации управляющей программы Docker:

   sudo nano /etc/docker/daemon.json
   

2. Задайте драйвер ведения журнала по умолчанию драйверу local ведения журнала, как показано в примере:

      {
         "log-driver": "local"
      }
   

3. Перезапустите обработчик контейнеров, чтобы изменения вступили в силу.

   sudo systemctl restart docker
   

В настоящее время оснастка Docker не поддерживает настройку драйвера ведения журнала local.

Установите последнюю версию IoT Edge и пакет службы удостоверений Интернета вещей (если вы еще не up-to-date):

• 22.04:

  sudo apt-get update; \
     sudo apt-get install aziot-edge
  

Установите последнюю версию IoT Edge и пакет службы удостоверений Интернета вещей (если вы еще не up-to-date):

sudo apt-get update; \
  sudo apt-get install aziot-edge

Установите последнюю версию IoT Edge и пакет службы удостоверений Интернета вещей (если вы еще не up-to-date):

sudo yum install aziot-edge

Установите IoT Edge из Snap Store.

sudo snap install azure-iot-edge

Подключение снапов

По умолчанию снап-пакеты не имеют зависимостей, не являются доверенными и строго ограничены. Поэтому после установки необходимо подключить snaps к другим snaps и к системным ресурсам. Используйте следующие команды для подключения службы идентификации Интернета вещей и IoT Edge snap пакетов друг к другу и системным ресурсам. Чтобы приступить к работе, вручную подключите снапсы. Для производственных развертываний их можно настроить, чтобы они автоматически подключались, что поможет уменьшить нагрузку на подготовку.

#------------------------
#  IoT Identity Service
#------------------------

# Connect the Identity Service snap to the logging system
# and grant permission to query system info

sudo snap connect azure-iot-identity:log-observe
sudo snap connect azure-iot-identity:mount-observe
sudo snap connect azure-iot-identity:system-observe
sudo snap connect azure-iot-identity:hostname-control

# If using a TPM, enable TPM access

sudo snap connect azure-iot-identity:tpm

#------------
#  IoT Edge
#------------

# Connect to your /home directory to enable writing support bundles

sudo snap connect azure-iot-edge:home

# Connect to logging and grant permission to query system info

sudo snap connect azure-iot-edge:log-observe
sudo snap connect azure-iot-edge:mount-observe
sudo snap connect azure-iot-edge:system-observe
sudo snap connect azure-iot-edge:hostname-control
# Allow IoT Edge to connect to the /var/run/iotedge folder and use sockets

sudo snap connect azure-iot-edge:run-iotedge

# Connect IoT Edge to Docker

sudo snap connect azure-iot-edge:docker docker:docker-daemon

sudo cp /etc/aziot/config.toml.edge.template /etc/aziot/config.toml

Откройте файл конфигурации на устройстве IoT Edge.

sudo nano /etc/aziot/config.toml

При использовании установки в формате snap для IoT Edge файл шаблона находится в /snap/azure-iot-edge/current/etc/aziot/config.toml.edge.template. Скопируйте файл шаблона в домашний каталог и назовите его config.toml. Например:

cp /snap/azure-iot-edge/current/etc/aziot/config.toml.edge.template ~/config.toml

Откройте файл конфигурации в домашнем каталоге на устройстве IoT Edge.

nano ~/config.toml

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

Убедитесь, что используется регистрация группы, созданная в службе управления настройками устройств. Перейдите к службе подготовки вашего устройства на портале Azure. Откройте сведения о регистрации для группы, которую вы создали. Перейдите на вкладку "Записи регистрации", чтобы просмотреть все устройства, зарегистрированные в этой группе.