Defender-IoT-micro-agent for Eclipse ThreadX API (versión preliminar)

Las API de Defender para IoT se rigen por la licencia de API de Microsoft y los términos de uso.

Esta API está diseñada para su uso con el microagente de Defender IoT solo para Eclipse ThreadX. Para obtener más recursos, consulte el recurso de GitHub Defender-IoT-micro-agent for Eclipse ThreadX.

Nota:

Defender para IoT planea retirar el microagente el 1 de agosto de 2025.

Habilitación del microagente de Defender IoT para Eclipse ThreadX

nx_azure_iot_security_module_enable

Prototipo

UINT nx_azure_iot_security_module_enable(NX_AZURE_IOT *nx_azure_iot_ptr);

Descripción

Esta rutina habilita el subsistema Azure IoT Defender-IoT-micro-agent. Una máquina de estado interno administra la colección de eventos de seguridad y los envía a Azure IoT Hub. Solo se necesita una instancia de NX_AZURE_IOT_SECURITY_MODULE para administrar la recopilación de datos.

Parameters

Nombre Descripción
nx_azure_iot_ptr [in] Puntero a un NX_AZURE_IOTobjeto .

Valores devueltos

Valores devueltos Descripción
NX_AZURE_IOT_SUCCESS Habilitado correctamente Azure módulo de seguridad de IoT.
NX_AZURE_IOT_FAILURE No se pudo habilitar el módulo de seguridad de IoT de Azure debido a un error interno.
NX_AZURE_IOT_INVALID_PARAMETER El módulo de seguridad requiere una instancia de #NX_AZURE_IOT válida.

Se permite desde

Subprocesos

Deshabilitar Azure microagente de IoT Defender-IoT

nx_azure_iot_security_module_disable

Prototipo

UINT nx_azure_iot_security_module_disable(NX_AZURE_IOT *nx_azure_iot_ptr);

Descripción

Esta rutina deshabilita el subsistema Azure IoT Defender-IoT-micro-agent.

Parameters

Nombre Descripción
nx_azure_iot_ptr [in] Puntero a NX_AZURE_IOT. Si es NULL, la instancia singleton está deshabilitada.

Valores devueltos

Valores devueltos Descripción
NX_AZURE_IOT_SUCCESS Se ha realizado correctamente cuando el módulo de seguridad de IoT de Azure está deshabilitado correctamente.
NX_AZURE_IOT_INVALID_PARAMETER Azure IoT Hub instancia es diferente de la instancia compuesta singleton.
NX_AZURE_IOT_FAILURE No se pudo deshabilitar el módulo de seguridad de IoT de Azure debido a un error interno.

Se permite desde

Subprocesos

Pasos siguientes

Para más información sobre cómo empezar a trabajar con Eclipse ThreadX Defender-IoT-micro-agent, consulte los artículos siguientes:

  • Revise la introducción a Defender para IoT Eclipse ThreadX Defender-IoT-micro-agent de Defender para IoT.