Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Azure IoT Hub expone varios puntos de conexión para admitir los dispositivos y servicios que interactúan con él.
Nota
Algunas de las características que se mencionan en este artículo, como la mensajería de la nube al dispositivo, los dispositivos gemelos y la administración de dispositivos, solo están disponibles en el nivel estándar de IoT Hub. Para obtener más información sobre los niveles Básico y Estándar/Gratuito de IoT Hub, consulte Elegir el nivel y tamaño de IoT Hub adecuado para su solución.
Nombres de IoT Hub
Puede encontrar el nombre de host de un centro de IoT en Azure Portal, en el panel Información general de IoT Hub. De manera predeterminada, el nombre DNS de un centro de IoT es similar al ejemplo siguiente:
{your iot hub name}.azure-devices.net
Puntos de conexión habilitados para TLS 1.3
Azure IoT Hub proporciona puntos de conexión adicionales para admitir TLS 1.3 con requisitos de seguridad mejorados. Para hubs con el perfil de conexión clásico, estos endpoints están disponibles junto al endpoint existente para permitir una adopción gradual y sin interrupciones.
No hay ningún cambio previsto en el punto de conexión existente de IoT Hub (<hub>.azure-devices.net), conocido habitualmente como el punto de conexión clásico. Este punto de conexión sigue siendo totalmente compatible, incluido para escenarios de Private Link y sigue siendo el valor predeterminado para las cargas de trabajo existentes.
Los nuevos puntos de conexión son aditivos, no reemplazos y permiten a los clientes adoptar configuraciones de seguridad más sólidas a su propio ritmo.
Tipos de punto de conexión
| Tipo de punto de conexión | Nombre de host | Compatibilidad con protocolos |
|---|---|---|
| Clásico | <hub>.azure-devices.net |
TLS 1.2 (comportamiento existente) |
| Punto de conexión de dispositivo | <hub>.device.azure-devices.net |
TLS 1.2 (restringido) + TLS 1.3 |
| Punto de conexión de servicio | <hub>.service.azure-devices.net |
TLS 1.2 (restringido) + TLS 1.3 |
Perfiles de conexión y selección de puntos finales
Un perfil de conexión describe la configuración de conectividad del hub. Un endpoint es el nombre de host al que se conecta un dispositivo o una aplicación de servicio. Cambiar el nombre de host no modifica el perfil de conexión ni habilita MQTT v5.
- Perfil de conexión clásico: El endpoint clásico y los endpoints de dispositivo y servicio compatibles con TLS 1.3 están generalmente disponibles. Un perfil de conexión clásico no está limitado al endpoint clásico.
- Perfil de conexión MQTT v5: Los endpoints de dispositivo y servicio compatibles con TLS 1.3 están en vista previa. La mensajería de dispositivos utiliza MQTT v5, no MQTT v3.1.1, AMQP o HTTPS. La disponibilidad de TLS 1.3 para hubs de perfil clásico no cambia el estado de la vista previa de MQTT v5.
Utilice el endpoint de dispositivo asignado para las conexiones de dispositivo y el endpoint de servicio para aplicaciones de backend. Para un dispositivo provisionado, utilice el endpoint devuelto por Device Provisioning Service (DPS), en lugar de construir un nombre de host.
Al obtener una cadena de conexión de servicio con la CLI de vista previa, seleccione --hostname-type service; una cadena de conexión de servicio no es una credencial de incorporación de dispositivos.
Las conexiones de dispositivo MQTT v5 requieren autenticación X.509. Para credenciales de incorporación, emisión y renovación de certificados a través de DPS, y resolución de problemas de dispositivos, consulte Configurar un dispositivo.
Consideraciones clave
- Las aplicaciones y dispositivos existentes que usan el punto de conexión clásico siguen funcionando sin cambios.
- Los nuevos puntos de conexión admiten TLS 1.3 y los requisitos de seguridad mejorados.
- Ambos modelos de punto de conexión coexisten para admitir migraciones graduales sin interrupciones del servicio.
- Compatible con TLS 1.3 no significa que TLS 1.3 sea necesario para cada conexión. El cliente y el endpoint negocian una versión TLS y un conjunto de cifrados que ambos soportan. Las versiones TLS y las versiones del protocolo de mensajería de dispositivo son independientes.
- Los endpoints de dispositivos y servicios requieren Indicación de Nombre de Servidor (SNI). Para detalles de suites de cifrado y protocolos, consulte el soporte de IoT Hub TLS.
Puntos de conexión de IoT Hub para el desarrollo y la administración
Azure IoT Hub es un servicio multiinquilino que muestra su funcionalidad a diversos actores. En el siguiente diagrama se muestran los diferentes puntos de conexión expuestos por IoT Hub.
En la lista siguiente se describen los puntos de conexión:
Nota
Los protocolos de dispositivo y las operaciones de mensajería enumerados en esta sección describen el perfil de conexión clásico. Para el soporte y limitaciones de MQTT v5, consulte Capacidades de MQTT v5.
Proveedor de recursos: una interfaz de Azure Resource Manager. Esta interfaz permite que los propietarios de suscripciones de Azure creen y eliminen instancias de IoT Hub para actualizar sus propiedades. Las propiedades de IoT Hub controlan las directivas de acceso compartido de nivel de centro, a diferencia del control de acceso de nivel de dispositivo y las opciones funcionales para la mensajería de la nube al dispositivo y del dispositivo a la nube. El proveedor de recursos también permite exportar identidades de dispositivo.
Gestión de identidad de dispositivos: un conjunto de endpoints HTTPS REST para gestionar las identidades de dispositivos (crear, recuperar, actualizar y eliminar). Las identidades de dispositivos se utilizan para la autenticación de dispositivos y el control de acceso.
Gestión de gemelos de dispositivos: un conjunto de endpoints REST HTTPS orientados al servicio para consultar y actualizar gemelos de dispositivos (actualizar etiquetas y propiedades).
Gestión de trabajos: un conjunto de endpoints HTTPS REST orientados al servicio para consultar y gestionar trabajos.
Endpoints de dispositivo: un conjunto de endpoints para cada dispositivo en el registro de identidad. Salvo cuando se indique lo contrario, estos puntos de conexión se exponen a través de los protocolos MQTT v3.1.1, HTTPS 1.1 y AMQP 1.0. AMQP y MQTT también están disponibles sobre WebSockets en el puerto 443. Estos puntos de conexión incluyen lo siguiente:
Envío de mensajes del dispositivo a la nube
Recepción de mensajes de nube a dispositivo
Iniciar cargas de archivos
Recuperación y actualización de las propiedades del dispositivo gemelo (no se admite HTTP)
Recepción de solicitudes de método directo (no se admite HTTPS)
Endpoints de servicio: un conjunto de endpoints para el backend de tu solución para comunicarse con tus dispositivos. Con una excepción, estos puntos de conexión solo se muestran con los protocolo AMQP y AMQP sobre WebSockets. El punto de conexión de invocación de método directo se muestra en el protocolo HTTPS.
Recepción de mensajes de dispositivo a nube: este punto de conexión es el punto de conexión integrado que se describe en los conceptos de enrutamiento de mensajes. Un servicio back-end puede usarse para leer los mensajes de dispositivo a nube enviados por los dispositivos. Además de este punto de conexión integrado, puede crear puntos de conexión personalizados en el centro de IoT.
Envío de mensajes de nube a dispositivo y recepción de confirmaciones de entrega
Recepción de notificaciones de carga de archivos
Invocación de un método directo
En el artículo SDK de Azure IoT Hub, se describen las distintas maneras con las que se puede acceder a estos puntos de conexión.
Todos los puntos de conexión de IoT Hub usan el protocolo TLS y ningún punto de conexión se expone nunca en canales no cifrados o no seguros.
Puntos de conexión personalizados para el enrutamiento de mensajes
Puede vincular los servicios de Azure existentes con sus suscripciones a Azure en el centro de IoT para usarlos como puntos de conexión para el enrutamiento de mensajes. Estos puntos de conexión hacen de puntos de conexión de servicio y se usan como receptores para las rutas de los mensajes. Los dispositivos no pueden escribir directamente en estos puntos de conexión. Para más información sobre el enrutamiento de mensajes, consulte Uso del enrutamiento de mensajes de IoT Hub para enviar mensajes del dispositivo a la nube a distintos puntos de conexión.
IoT Hub admite los siguientes servicios de Azure como puntos de conexión personalizados:
- Contenedores de almacenamiento
- Event Hubs
- Colas de Service Bus
- Temas de Service Bus
- Cosmos DB
- Microsoft Fabric Eventstreams
Para conocer los límites de los puntos de conexión por centro, consulte Cuotas y limitación.
Punto de conexión integrado
El endpoint integrado y el enrutamiento de reserva no están disponibles para el perfil de conexión MQTT v5. Configurar una ruta explícita hacia un destino soportado; consulte Diferencias en el perfil de conexión de enrutamiento.
Puede usar la integración y los SDK de Event Hubs estándar para recibir mensajes del dispositivo a la nube desde el punto de conexión integrado (mensajes y eventos). Una vez creada cualquier ruta, los datos dejan de fluir al punto de conexión integrado a menos que se cree una ruta a ese punto de conexión. Incluso si no crea ninguna ruta, debe habilitar una ruta alternativa para enrutar los mensajes al punto de conexión integrado. El mecanismo de respaldo está habilitado de forma predeterminada si creas tu hub mediante el portal o la CLI.
La carga del mensaje no está codificada en base64 en el punto de conexión integrado.
Azure Storage como punto de conexión de enrutamiento
IoT Hub puede enrutar mensajes a dos servicios de almacenamiento: Cuentas de Azure Blob Storage y Azure Data Lake Storage Gen2 (ADLS Gen2). Ambos servicios usan blobs para su almacenamiento. Para usar Azure Data Lake Gen2, la cuenta de almacenamiento debe tener habilitados los espacios de nombres jerárquicos. Para más información, consulte Creación de una cuenta de almacenamiento para usarla con Azure Data Lake Storage.
IoT Hub admite la escritura de datos en Azure Storage con los formatos Apache Avro y JSON. El formato predeterminado es Avro. Para usar la codificación JSON, establezca la contentType propiedad en application/json y la contentEncoding propiedad en UTF-8 en las propiedades del sistema de mensajes. Ambos valores no distinguen mayúsculas de minúsculas.
Si no establece las propiedades del sistema necesarias, IoT Hub aplica la codificación base64. Para evitar la codificación base64, establezca la contentType propiedad en application/json y la contentEncoding propiedad en UTF-8 en las propiedades del sistema de mensajes. Si no se establecen estas propiedades, IoT Hub escribe los mensajes en formato codificado en base64.
Solo puede establecer el formato de codificación cuando configure el punto de conexión de Blob Storage. No se puede editar el formato de codificación de un punto de conexión existente.
IoT Hub agrupa los mensajes por lotes y escribe los datos en un almacenamiento cuando el lote llega a cierto tamaño o después de que transcurre cierto tiempo. IoT Hub utiliza de forma predeterminada la siguiente convención de nomenclatura de archivos: {iothub}/{partition}/{YYYY}/{MM}/{DD}/{HH}/{mm}.
Puede usar cualquier convención de nomenclatura de archivos, pero debe usar todos los tokens de la lista. Si ni hay datos que escribir, IoT Hub escribe en un blob vacío.
Para asegurarse de que todos los blobs o archivos se leen sin realizar ninguna suposición sobre la partición, enumere los blobs o los archivos y, a continuación, itere sobre ellos. El intervalo de partición podría cambiar durante una conmutación por error iniciada por Microsoft o una conmutación por error manual de IoT Hub. Puede usar la API List Blobs para la lista de blobs o la API List ADLS Gen2 para la lista de archivos. Por ejemplo:
public void ListBlobsInContainer(string containerName, string iothub)
{
var storageAccount = CloudStorageAccount(Microsoft.Azure.Storage.Auth.StorageCredentials storageCredentials, bool useHttps);
var cloudBlobContainer = storageAccount.CreateCloudBlobClient().GetContainerReference(containerName);
if (cloudBlobContainer.Exists())
{
var results = cloudBlobContainer.ListBlobs(prefix: $"{iothub}/");
foreach (IListBlobItem item in results)
{
Console.WriteLine(item.Uri);
}
}
}
Colas y temas de Service Bus como punto de conexión de enrutamiento
Las colas y los temas de Service Bus que usa como puntos de conexión de IoT Hub no deben tener habilitadas las opciones Sesiones o Detección de duplicados. Si habilita cualquiera de esas opciones, el punto de conexión aparece como Inaccesible en Azure Portal.
La codificación Base64 nunca ocurre al enrutar a colas o temas de Service Bus. Los mensajes se escriben tal cual en el punto de conexión.
Event Hubs como punto de conexión de enrutamiento
Además del punto de conexión integrado compatible con Event Hubs, también puede enrutar los datos a puntos de conexión personalizados de tipo Event Hubs.
La codificación Base64 nunca se produce cuando se enruta a puntos de conexión personalizados de Event Hubs. Los mensajes se escriben tal cual en el punto de conexión.
Azure Cosmos DB como punto de conexión de enrutamiento
Puede enviar datos directamente a Azure Cosmos DB desde IoT Hub. IoT Hub admite la escritura en Cosmos DB en JSON (si se especifica en el tipo de contenido del mensaje) o como binario codificado en base64.
La codificación Base64 se aplica si no se establecen las propiedades del sistema necesarias. Para escribir como JSON, establezca la contentType propiedad en application/json y la contentEncoding propiedad en UTF-8 en las propiedades del sistema de mensajes. Si no se establecen estas propiedades, los datos se codifican en base64 cuando se escriben en Cosmos DB.
Para admitir escenarios de gran escala, puede habilitar claves de partición sintéticas para el punto de conexión de Cosmos DB. Como Cosmos DB es un almacén de datos de hiperescala, todos los datos o documentos que se escriban en él deben contener un campo que represente una partición lógica. Cada partición lógica tiene un tamaño máximo de 20 GB. Puede especificar el nombre de la propiedad de clave de partición en Partition key name (Nombre de clave de partición). El nombre de la propiedad de clave de partición se define en el nivel de contenedor y no se puede actualizar.
Puede configurar el valor de la clave de partición sintética si especifica una plantilla en Partition key template (Plantilla de clave de partición) basada en el volumen de datos estimado. Por ejemplo, en escenarios de fabricación, es posible que la partición lógica se acerque a su límite máximo de 20 GB en un mes. En ese caso, puede definir una clave de partición sintética como una combinación del identificador del dispositivo y el mes. El valor de la clave de partición generada se agrega automáticamente a la propiedad de clave de partición para cada nuevo registro de Cosmos DB, lo que garantiza que se crean particiones lógicas todos los meses para cada dispositivo.
Precaución
Si usa la identidad administrada asignada por el sistema para autenticarse en Cosmos DB, debe usar la CLI de Azure o Azure PowerShell para asignar la definición de rol integrado de Colaborador de datos de Cosmos DB a la identidad. Actualmente no se admite la asignación de roles para Cosmos DB en Azure Portal. Para obtener más información sobre los distintos roles, consulte Configuración del acceso basado en roles en Azure Cosmos DB. Para aprender a asignar roles a través de la CLI, consulte Administración de recursos de rol de SQL de Azure Cosmos DB.
Microsoft Fabric Eventstreams como endpoint de enrutamiento
Puedes enrutar mensajes de dispositivo a nube a un Microsoft Fabric eventstream añadiendo un endpoint personalizado de Fabric Eventstream a tu IoT Hub. Esta integración incorpora la telemetría de IoT Hub directamente a Fabric Real-Time Intelligence para el procesamiento y análisis posteriores.
Nota
El endpoint de enrutamiento Microsoft Fabric Eventstream está generalmente disponible. Soporta los perfiles de conexión clásico y MQTT v5. El propio perfil MQTT v5 permanece en vista previa; la disponibilidad del endpoint no cambia ese estado.
Para enrutar mensajes a un Fabric eventstream, crea una ruta en IoT Hub, añade un punto de conexión de Fabric Eventstream y conéctalo a un Fabric eventstream que utilice un origen de punto de conexión personalizado (aplicación personalizada).
En tu espacio de trabajo de Microsoft Fabric, selecciona la tesela de origen de endpoint personalizada a la que quieres conectarte en tu Eventstream publicado. Si no existe un mosaico de fuente de endpoint personalizado en tu Eventstream, crea un nuevo mosaico de fuente de endpoint personalizado. Una vez seleccionado el mosaico de origen, vaya al panel Detalles. Selecciona Event Hub como protocolo. Selecciona Entra ID Authentication y accede a los detalles de la conexión. Para asegurarte de que la autenticación Entra ID está correctamente configurada para tu espacio de trabajo de Fabric, consulta Conectar a Eventstream usando autenticación Microsoft Entra ID.
Autenticación
El endpoint Fabric Eventstream solo soporta autenticación Microsoft Entra ID. La autenticación de clave por firma de acceso compartido (SAS) no es compatible. Puedes usar una identidad gestionada asignada por el sistema o una asignada por el usuario para IoT Hub. Para más información, consulta Conectividad de salida desde IoT Hub a otros recursos de Azure.
Esquema de los mensajes
Los mensajes enrutados a un endpoint de Fabric Eventstream se entregan utilizando el modo de contenido binario CloudEvents 1.0 sobre AMQP, que difiere del esquema utilizado por otros endpoints de enrutamiento como los Event Hubs. La identidad del dispositivo y los metadatos de eventos se conservan en el sobre CloudEvents. Para los hubs IoT que utilizan Azure Device Registry (ADR), la carga útil del evento incluye identificadores ADR. Para una comparación con el esquema predeterminado de mensajes enrutados, véase esquema de mensajes en los puntos finales de enrutamiento.
Tras este cambio, los campos de metadatos de usuario siguen presentes en el mensaje, pero no aparecerán a menos que se añada una transformación SQL antes de que los datos se entreguen al destino en el flujo de eventos de Fabric.
SELECT ,
GETMETADATAPROPERTYVALUE(
[<Add name of stream input>],
'[User]'
) AS UserProperties
INTO [<Add name of stream output>]
FROM [<Add name of stream input>];
La disponibilidad general del endpoint es independiente de la configuración de referencia de esquema y formato de carga del mensaje en versión preliminar. Para sus roles distintos y verificación del consumidor, consulte Preparar telemetría para agentes y analítica.
Restricciones de las propiedades de enriquecimiento
Los nombres de propiedades de enriquecimiento de mensajes para los endpoints de Fabric Eventstream tienen las siguientes restricciones:
- Los nombres deben empezar por una letra minúscula.
- Los nombres solo pueden contener letras minúsculas y dígitos.
- No se permiten guiones, guiones bajos, puntos y camello. Caja de camello no están permitidos.
- Los nombres pueden tener como máximo 20 caracteres.
Tooling
Puedes crear y configurar un endpoint de Fabric Eventstream usando la CLI de Azure y Bicep.
Nota
¿Empezando con Fabric? Aprovecha la carga de trabajo Azure IoT Solution Accelerator para Microsoft Fabric Real-Time Intelligence para empezar rápidamente a descubrir cómo los datos de Azure IoT dispositivos pueden transformarse en análisis en tiempo real, monitorización operativa, acciones automatizadas y conocimientos impulsados por IA mediante el uso de Fabric Real-Time Intelligence.
Mantenimiento del punto de conexión
Puede usar la API REST Get Endpoint Health para obtener el estado de mantenimiento de los puntos de conexión. Se recomienda usar las métricas de enrutamiento de IoT Hub relativas a la latencia de mensajes de enrutamiento para identificar y depurar errores cuando el estado del punto de conexión no responda o esté en mal estado, ya que se espera que la latencia sea mayor con el punto de conexión en uno de esos estados. Para obtener más información sobre el uso de métricas de IoT Hub, consulte Supervisión de IoT Hub.
| Estado de mantenimiento | Descripción |
|---|---|
| sano | El punto de conexión acepta los mensajes según lo previsto. |
| Insalubre | El punto de conexión no acepta mensajes e IoT Hub está intentando volver a enviarlos. |
| desconocido | IoT Hub no intentó enviar mensajes a este punto de conexión. |
| degradado | El punto de conexión está aceptando mensajes más lentamente de lo esperado o se está recuperando de un estado incorrecto. |
| dead | IoT Hub ya no entrega mensajes a este punto de conexión. No se pudieron enviar los mensajes a este punto de conexión. |
Pasos siguientes
Más información acerca de estos temas: