Micro-agent Defender-IoT pour l’API Eclipse ThreadX (préversion)

Les API Defender pour IoT sont régies par la licence d’API Microsoft et les conditions d’utilisation.

Cette API est destinée à être utilisée avec le micro-agent Defender-IoT pour Eclipse ThreadX uniquement. Pour obtenir des ressources supplémentaires, consultez la ressource GitHub Defender-IoT-micro-agent pour Eclipse ThreadX.

Remarque

Defender pour IoT prévoit de mettre hors service le micro-agent le 1er août 2025.

Activer le micro-agent Defender-IoT pour Eclipse ThreadX

nx_azure_iot_security_module_enable

Prototype

UINT nx_azure_iot_security_module_enable(NX_AZURE_IOT *nx_azure_iot_ptr);

Description

Cette routine active la Azure sous-système de micro-agent IoT Defender-IoT. Une machine à états interne gère la collection d’événements de sécurité et les envoie à Azure IoT Hub. Une seule NX_AZURE_IOT_SECURITY_MODULE instance est requise et nécessaire pour gérer la collecte de données.

Paramètres

Nom Description
nx_azure_iot_ptr [in] Pointeur vers un NX_AZURE_IOT.

Valeurs de retour

Valeurs de retour Description
NX_AZURE_IOT_SUCCESS Activation réussie Azure module de sécurité IoT.
NX_AZURE_IOT_FAILURE Échec de l’activation du module de sécurité Azure IoT en raison d’une erreur interne.
NX_AZURE_IOT_INVALID_PARAMETER Le module de sécurité nécessite un #NX_AZURE_IOT instance valide.

Autorisé à partir de

Threads

Désactiver Azure micro-agent IoT Defender-IoT

nx_azure_iot_security_module_disable

Prototype

UINT nx_azure_iot_security_module_disable(NX_AZURE_IOT *nx_azure_iot_ptr);

Description

Cette routine désactive le sous-système Azure micro-agent IoT Defender-IoT.

Paramètres

Nom Description
nx_azure_iot_ptr [in] Pointeur vers NX_AZURE_IOT. Si la valeur est NULL, le singleton instance est désactivé.

Valeurs de retour

Valeurs de retour Description
NX_AZURE_IOT_SUCCESS Réussite lorsque le module de sécurité Azure IoT est correctement désactivé.
NX_AZURE_IOT_INVALID_PARAMETER Azure IoT Hub instance est différent de l’instance composite singleton.
NX_AZURE_IOT_FAILURE Échec de la désactivation du module de sécurité Azure IoT en raison d’une erreur interne.

Autorisé à partir de

Threads

Étapes suivantes

Pour en savoir plus sur la prise en main du micro-agent Eclipse ThreadX Defender-IoT, consultez les articles suivants :