Creación y aprovisionamiento de un dispositivo IoT Edge en Linux con claves simétricas

Un centro de IoT gratuito o estándar en la suscripción de Azure.

• Un centro de IoT gratuito o estándar en la suscripción de Azure
• Visual Studio Code
• Extensión de Azure IoT Edge. La extensión de Herramientas de Azure IoT Edge para Visual Studio Code está en modo de mantenimiento.
• Extensión de Azure IoT Hub

• Un centro de IoT gratuito o estándar en la suscripción de Azure

• La CLI de Azure en su entorno

  Como mínimo, la versión de la CLI de Azure debe ser la 2.0.70 o posterior. Use az --version para asegurarse. Esta versión admite az comandos de extensión e introduce el marco de comandos de Knack.

En su centro de IoT en Azure Portal, los dispositivos IoT Edge se crean y administran por separado de los dispositivos IOT que no están habilitados para Edge.

1. Inicie sesión en Azure Portal y vaya a IoT Hub.

2. En el panel izquierdo, seleccione Dispositivos en el menú y, luego, elija Agregar dispositivo.

3. En la página Crear un dispositivo, proporcione la información siguiente:

   • Cree un identificador de dispositivo descriptivo, por ejemplo, my-edge-device-1 (todo en minúsculas). Copie este identificador de dispositivo, ya que lo usará más adelante.
   • Active la casilla Dispositivo IoT Edge.
   • Seleccione Clave simétrica como el tipo de autenticación.
   • Use la configuración predeterminada para generar automáticamente claves de autenticación, que conectan el nuevo dispositivo al centro.

4. Seleccione Guardar.

Debería ver el nuevo dispositivo que aparece en el centro de IoT.

Inicio de sesión en Azure

Puede usar las extensiones de Azure IoT para Visual Studio Code para realizar operaciones con IoT Hub. Asegúrese de que ha instalado los requisitos previos de la extensión de Azure IoT.

Una vez instaladas las extensiones de Azure IoT Edge y Azure IoT Hub, verá que se agrega un icono de Azure al menú del icono de la izquierda. Para iniciar sesión en su cuenta de Azure a través de Visual Studio Code, seleccione el icono de Azure y, después, seleccione Iniciar sesión en Azure.

Registro de un nuevo dispositivo en Visual Studio Code

El registro de un nuevo dispositivo es similar a la creación de un dispositivo IoT Edge en Azure Portal. Este dispositivo virtual es uno de los gemelos, mientras que el dispositivo real es el otro gemelo. Visual Studio Code puede configurarlo automáticamente mediante los siguientes pasos.

1. En el menú Explorador de Visual Studio Code, expanda la sección Azure IoT Hub.
2. Selecciona los puntos suspensivos ... en el encabezado de la sección Azure IoT Hub. Si no ves los puntos suspensivos, selecciona o mantén el puntero sobre el encabezado.
3. Seleccione Create IoT Edge Device (Crear un dispositivo de IoT Edge).
4. En el cuadro de texto que se abre, asigne un identificador al dispositivo, por ejemplo, my-edge-device-1 (todo en minúsculas) y presione entrar.

En la consola de salida de Visual Studio Code, verá el resultado del comando: una impresión JSON. La información del dispositivo incluye el deviceId que proporcionó y genera una connectionString que puede usar para conectar el dispositivo físico a IoT Hub. La consola de salida también muestra las claves y otra información de identificación del dispositivo.

Ahora puede ver el dispositivo en la sección Azure IoT Hub>Dispositivos del menú Explorador.

Use el comando az iot hub device-identity create para crear una nueva identidad de dispositivo en su centro de IoT. Reemplace device_id_here por su propio identificador de dispositivo nuevo y único, por ejemplo, my-edge-device-1 (todo en minúsculas). Reemplace hub_name_here por el IoT Hub existente.

Este comando incluye tres parámetros:

• --device-id o -d: proporcione un nombre descriptivo que sea único dentro de su IoT Hub.

• --hub-name o -n: proporcione el nombre de su IoT Hub.

• --edge-enabled o --ee: declare que se trata de un dispositivo de IoT Edge.

  az iot hub device-identity create --device-id device_id_here --hub-name hub_name_here --edge-enabled
  

Si la CLI indica El comando requiere la extensión azure-iot. ¿Desea instalarla ahora?, escriba Y y presione Enter para iniciar la descarga para crear el dispositivo.

Todos los dispositivos habilitados para Edge que se conectan al centro de IoT se enumeran en la página Dispositivos de su IoT Hub. Si tiene varios dispositivos, puede filtrar la lista seleccionando el tipo dispositivos Iot Edge y, a continuación, seleccione Aplicar.

Cuando esté listo para configurar el dispositivo, necesitará la cadena de conexión que vincula el dispositivo físico con su identidad en el centro de IoT. Los dispositivos que se autentican con claves simétricas tienen sus cadenas de conexión disponibles para copiarse en el portal. Para buscar la cadena de conexión en el portal:

1. En la página Dispositivos, seleccione el identificador de dispositivo IoT Edge en la lista.
2. Copie el valor de la cadena de conexión primaria o la cadena de conexión secundaria. Cualquiera de las teclas funciona.

Todos los dispositivos que se conectan a IoT Hub se enumeran en la sección Azure IoT Hub del explorador de Visual Studio Code. Los dispositivos IoT Edge se distinguen de los dispositivos que no son perimetrales porque tienen un icono diferente y ve que los módulos de $edgeAgent y $edgeHub se implementan en cada dispositivo IoT Edge.

Cuando esté listo para configurar el dispositivo, necesitará la cadena de conexión que vincula el dispositivo físico con su identidad en el centro de IoT. Aquí se muestra cómo obtener la cadena de conexión de Visual Studio Code.

1. Haga clic con el botón derecho en el identificador (nombre) del dispositivo en la sección Azure IoT Hub.

2. Seleccione Copy Device Connection String (Copiar la cadena de conexión del dispositivo).

   La cadena de conexión se copiará al portapapeles.

También puede seleccionar Get Device Info (Obtener información del dispositivo), si hace clic con el botón derecho del mouse en el menú para ver toda la información del dispositivo, incluyendo la cadena de conexión, en la ventana de salida.

Para ver todos los dispositivos de IoT Hub, use el comando az iot hub device-identity list. Reemplace hub_name_here por su propio nombre de IoT Hub.

az iot hub device-identity list --hub-name hub_name_here

Cualquier dispositivo registrado como dispositivo IoT Edge tiene la propiedad capabilities.iotEdge establecida en true. También verá muchos otros metadatos como salida JSON, incluidos los identificadores de dispositivo.

Cuando esté listo para configurar el dispositivo, necesitará su cadena de conexión que vincula el dispositivo físico con su identidad en el centro de IoT. Use el siguiente comando az iot hub device-identity connection-string show para devolver la cadena de conexión para un único dispositivo. Reemplace [device_id] y [hub_name] con sus propios valores. El valor del parámetro device-identity distingue mayúsculas y minúsculas.

az iot hub device-identity connection-string show --device-id [device_id] --hub-name [hub_name]

Debería ver la salida JSON en la consola, similar a la siguiente:

{
  "connectionString": "HostName=[hub_name].azure-devices.net;DeviceId=[device_id];SharedAccessKey=[device_key]"
}

Al copiar la cadena de conexión que se va a usar en un dispositivo, no incluya las comillas alrededor de la cadena de conexión.

La instalación se puede realizar con unos pocos comandos. Abra un terminal y ejecute los comandos siguientes:

• 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
  

• 20.04:

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

La instalación con APT puede realizarse con unos pocos comandos. Abra un terminal y ejecute los comandos siguientes:

• 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
  

La instalación se puede realizar con unos pocos comandos. Abra un terminal y ejecute los comandos siguientes:

• 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
  

El entorno de ejecución de IoT Edge se instala desde el almacén de ajustes en un paso posterior. Continúe con la sección siguiente.

Instale el motor de Moby.

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

Instale el motor de Moby.

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

Instale el motor de Moby y la 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 tiene dependencias en Docker e IoT Identity Service. Instale todas las dependencias escribiendo los siguientes comandos:

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

El acoplamiento de Docker es compatible con Canonical y se admite en escenarios de producción.

1. Crear o editar el archivo de configuración de daemons de Docker existente

   sudo nano /etc/docker/daemon.json
   

2. Establezca el controlador de registro predeterminado en el controlador de registro local, tal como se muestra en el ejemplo.

      {
         "log-driver": "local"
      }
   

3. Reinicie el motor de contenedores para que se apliquen los cambios.

   sudo systemctl restart docker
   

Actualmente, no se admite la configuración del controlador de registro local para el ajuste de Docker.

Instale la versión más reciente de IoT Edge y el paquete de servicio de identidad de IoT (si aún no está actualizado):

• 22.04:

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

• 20.04:

  sudo apt-get update; \
     sudo apt-get install aziot-edge defender-iot-micro-agent-edge
  

El paquete defender-iot-micro-agent-edge opcional incluye el micro agente de seguridad de Microsoft Defender para IoT que proporciona visibilidad del punto de conexión en la administración de la posición de seguridad, vulnerabilidades, detección de amenazas, administración de flotas y mucho más para ayudarle a proteger los dispositivos de IoT Edge. Se recomienda instalar el microagente con el agente de Edge para habilitar la supervisión de seguridad y la protección de los dispositivos de Edge. Para obtener más información sobre Microsoft Defender para IoT, consulte ¿Qué es Microsoft Defender para IoT para generadores de dispositivos?.

Instale la versión más reciente de IoT Edge y el paquete de servicio de identidad de IoT (si aún no está actualizado):

sudo apt-get update; \
  sudo apt-get install aziot-edge defender-iot-micro-agent-edge

El paquete defender-iot-micro-agent-edge opcional incluye el micro agente de seguridad de Microsoft Defender para IoT que proporciona visibilidad del punto de conexión en la administración de la posición de seguridad, vulnerabilidades, detección de amenazas, administración de flotas y mucho más para ayudarle a proteger los dispositivos de IoT Edge. Se recomienda instalar el microagente con el agente de Edge para habilitar la supervisión de seguridad y la protección de los dispositivos de Edge. Para obtener más información sobre Microsoft Defender para IoT, consulte ¿Qué es Microsoft Defender para IoT para generadores de dispositivos?.

Instale la versión más reciente de IoT Edge y el paquete de servicio de identidad de IoT (si aún no está actualizado):

sudo yum install aziot-edge

Instale IoT Edge desde el almacén de ajuste:

sudo snap install azure-iot-edge

Conectar ajuste

De manera predeterminada, los ajustes están libres de dependencias, no son de confianza y están estrictamente confinados. Por lo tanto, los ajustes deben estar conectados a otros ajustes y recursos del sistema después de la instalación. Use los siguientes comandos para conectar los ajustes de IoT Identity Service e IoT Edge entre sí y a los recursos del sistema. Para empezar, los ajustes deben conectarse manualmente. En el caso de las implementaciones de producción, se pueden configurar para conectarse automáticamente para reducir la carga de trabajo de aprovisionamiento.

#------------------------
#  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

Puede configurar el dispositivo IoT Edge con autenticación de clave simétrica mediante el comando siguiente:

sudo iotedge config mp --connection-string 'PASTE_DEVICE_CONNECTION_STRING_HERE'

El comando iotedge config mp crea un archivo de configuración en el dispositivo y escribe la cadena de conexión en el archivo.

1. Aplique los cambios de configuración.

   sudo iotedge config apply
   

2. Para ver el archivo de configuración, puede abrirlo:

   sudo nano /etc/aziot/config.toml
   

1. Cree un archivoconfig.toml en el directorio principal y configure el dispositivo IoT Edge con una autenticación de clave simétrica para el ajuste.

   sudo nano ~/config.toml
   

2. Puede aprovisionar manualmente con una cadena de conexión mediante la siguiente configuración de aprovisionamiento:

   [provisioning]
   source = "manual"
   connection_string = "REPLACE_WITH_DEVICE_CONNECTION_STRING"
   

   Para obtener más información sobre las opciones de configuración de aprovisionamiento, consulte Configuración del dispositivo IoT Edge.

3. Establezca la configuración de IoT Edge y el servicio de identidad mediante el comando siguiente:

   sudo snap set azure-iot-edge raw-config="$(cat ~/config.toml)"
   

sudo apt-get autoremove --purge aziot-edge

Excluya la marca --purge si planea reinstalar IoT Edge y usar la misma información de configuración en el futuro. La marca --purge elimina todos los archivos asociados a IoT Edge, incluidos los archivos de configuración.

sudo yum remove aziot-edge

Quite el entorno de ejecución de Azure IoT Edge:

sudo snap remove azure-iot-edge

Quitar el servicio de identidad de Azure:

sudo snap remove azure-iot-identity

sudo apt-get autoremove --purge moby-engine

sudo yum remove moby-cli
sudo yum remove moby-engine

sudo snap remove docker