Partager via

Configurer et personnaliser le micro-agent Defender pour IoT pour Eclipse ThreadX

  • Article

Cet article explique comment configurer le micro-agent Defender pour IoT pour votre appareil Eclipse ThreadX afin de répondre à vos besoins en réseau, bande passante et mémoire.

Remarque

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

Étapes de configuration

Vous devez sélectionner un fichier de distribution cible qui a une extension *.dist, à partir du répertoire netxduo/addons/azure_iot/azure_iot_security_module/configs.

Lorsque vous utilisez un environnement de compilation CMake, vous devez définir un paramètre de ligne de commande sur IOT_SECURITY_MODULE_DIST_TARGET pour la valeur choisie. Par exemple : -DIOT_SECURITY_MODULE_DIST_TARGET=RTOS_BASE.

Dans un IAR ou un autre environnement de compilation différent de CMake, vous devez ajouter le chemin netxduo/addons/azure_iot/azure_iot_security_module/inc/configs/<target distribution>/ à tous les chemins inclus connus. Par exemple : netxduo/addons/azure_iot/azure_iot_security_module/inc/configs/RTOS_BASE.

Comportement de l’appareil

Utilisez le fichier suivant pour configurer le comportement de votre appareil.

netxduo/addons/azure_iot/azure_iot_security_module/inc/configs/<target distribution>/asc_config.h

Dans un environnement de compilation CMake, vous devez changer la configuration par défaut en modifiant le fichier netxduo/addons/azure_iot/azure_iot_security_module/configs/<target distribution>.dist. Utilisez le format CMake set(ASC_XXX ON) ou le fichier netxduo/addons/azure_iot/azure_iot_security_module/inc/configs/<target distribution>/asc_config.h pour tous les autres environnements. Par exemple : #define ASC_XXX.

Le comportement par défaut de chaque configuration est fourni dans les tableaux suivants :

Configuration générale

Nom Type Default Détails
ASC_SECURITY_MODULE_ID Chaîne defender-iot-micro-agent Identificateur unique de l’appareil.
SECURITY_MODULE_VERSION_(MAJEURE)(MINEURE)(PATCH) Nombre 3.2.1 Version.
ASC_SECURITY_MODULE_SEND_MESSAGE_RETRY_TIME Nombre 3 Durée nécessaire au micro-agent Defender pour IoT pour envoyer le message de sécurité après un échec (en secondes).
ASC_SECURITY_MODULE_PENDING_TIME Numéro 300 Durée d’attente du micro-agent Defender pour IoT (en secondes). L’état change de suspension, si le temps est dépassé.

Configuration de la collecte

Nom Type Default Détails
ASC_FIRST_COLLECTION_INTERVAL Numéro 30 Décalage de l’intervalle de collecte au démarrage du collecteur. Lors du démarrage, la valeur est ajoutée à la collecte du système afin d’éviter d’envoyer simultanément des messages à partir de plusieurs appareils.
ASC_HIGH_PRIORITY_INTERVAL Numéro 10 Intervalle du groupe à haute priorité du collecteur (en secondes).
ASC_MEDIUM_PRIORITY_INTERVAL Numéro 30 Intervalle du groupe à priorité moyenne du collecteur (en secondes).
ASC_LOW_PRIORITY_INTERVAL Numéro 145 440 Intervalle du groupe à faible priorité du collecteur (en secondes).

Activité du réseau de collecteurs

Pour personnaliser la configuration de l’activité du réseau de collecteurs, utilisez ce qui suit :

Nom Type Default Détails
ASC_COLLECTOR_NETWORK_ACTIVITY_TCP_DISABLED Boolean false Filtre l’activité de réseau TCP.
ASC_COLLECTOR_NETWORK_ACTIVITY_UDP_DISABLED Boolean false Filtre les événements de l’activité de réseau UDP.
ASC_COLLECTOR_NETWORK_ACTIVITY_ICMP_DISABLED Boolean false Filtre les événements de l’activité de réseau ICMP.
ASC_COLLECTOR_NETWORK_ACTIVITY_CAPTURE_UNICAST_ONLY Boolean true Capture uniquement les paquets entrants en monodiffusion. Lorsqu’elle est définie sur false, elle capture à la fois la diffusion et la multidiffusion.
ASC_COLLECTOR_NETWORK_ACTIVITY_SEND_EMPTY_EVENTS Boolean false Envoie des événements vides du collecteur.
ASC_COLLECTOR_NETWORK_ACTIVITY_MAX_IPV4_OBJECTS_IN_CACHE Numéro 64 Nombre maximal d’événements réseau IPv4 à stocker en mémoire.
ASC_COLLECTOR_NETWORK_ACTIVITY_MAX_IPV6_OBJECTS_IN_CACHE Numéro 64 Nombre maximal d’événements réseau IPv6 à stocker en mémoire.

Collecteurs

Nom Type Default Détails
ASC_COLLECTOR_HEARTBEAT_ENABLED Boolean ACTIVÉ Active le collecteur de pulsations.
ASC_COLLECTOR_NETWORK_ACTIVITY_ENABLED Boolean ACTIVÉ Active le collecteur d’activité réseau.
ASC_COLLECTOR_SYSTEM_INFORMATION_ENABLED Boolean ACTIVÉ Active le collecteur d’informations système.

Les indicateurs d’autres configurations sont avancés et présentent des fonctionnalités non prises en charge. Pour apporter des modifications ou pour plus d’informations, contactez le support technique.

Alertes et recommandations de sécurité prises en charge

Le micro-agent Defender pour IoT pour Eclipse ThreadX prend en charge des alertes de sécurité et des suggestions spécifiques. Veillez à passer en revue et à personnaliser les valeurs d’alerte et de recommandation pertinentes pour votre service.

Analytique des journaux d'activité (facultatif)

Vous pouvez activer et configurer Log Analytics pour investiguer les événements et les activités des appareils. Découvrez comment effectuer la configuration et consultez Log Analytics avec le service Defender pour IoT pour en savoir plus.

Étapes suivantes