Aviso de fin de soporte: el 7 de octubre de 2026, AWS suspenderemos el soporte para AWS IoT Greengrass Version 1. Después del 7 de octubre de 2026, ya no podrá acceder a los AWS IoT Greengrass V1 recursos. Para obtener más información, visita [Migrar desde AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html). Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # Conector de Device Defender El [conector](connectors.md) Device Defender notifica a los administradores de los cambios en el estado de un dispositivo del núcleo de Greengrass. Esto puede ayudar a identificar comportamiento inusual que podrían indicar un dispositivo en riesgo. Este conector lee las métricas del sistema del `/proc` directorio del dispositivo principal y, a continuación, las publica en AWS IoT Device Defender. Para obtener detalles sobre los informes de métricas, consulte [Especificación de documentos de métricas de dispositivos](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html#DetectMetricsMessagesSpec) en la *Guía del desarrollador de AWS IoT *. Este conector tiene las siguientes versiones. | Versión | ARN | | --- | --- | | 3 | `arn:aws:greengrass:region::/connectors/DeviceDefender/versions/3` | | 2. | `arn:aws:greengrass:region::/connectors/DeviceDefender/versions/2` | | 1 | `arn:aws:greengrass:region::/connectors/DeviceDefender/versions/1` | Para obtener información sobre los cambios de versión, consulte el [Registro de cambios](#device-defender-connector-changelog). ## Requisitos Este conector exige los siguientes requisitos: ------ #### [ Version 3 ] + AWS IoT Greengrass Software principal, versión 1.9.3 o posterior. + Se necesita tener la versión 3.7 o 3.8 de [Python](https://www.python.org/) instalada en el dispositivo principal y añadido a la variable de entorno PATH. **nota** Para usar Python 3.8, ejecute el siguiente comando para crear un enlace simbólico desde la carpeta de instalación predeterminada de Python 3.7 a los binarios de Python 3.8 instalados. ``` sudo ln -s path-to-python-3.8/python3.8 /usr/bin/python3.7 ``` Esto configura su dispositivo para que cumpla con el requisito de Python para AWS IoT Greengrass. + AWS IoT Device Defender configurado para usar la función de detección para realizar un seguimiento de las infracciones. Para obtener más información, consulte [Detectar](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html) en la *Guía para desarrolladores de AWS IoT *. + Un [recurso de volumen local](access-local-resources.md) en el grupo de Greengrass que apunta al directorio `/proc`. El recurso debe usar las siguientes propiedades: + Ruta de origen: `/proc` + Ruta de destino: `/host_proc` (o un valor que coincide con el [patrón válido](#param-ProcDestinationPath)) + AutoAddGroupOwner: `true` + La biblioteca [psutil](https://pypi.org/project/psutil/) instalada en el núcleo de Greengrass. La versión 5.7.0 es la última versión que se verifica para que funcione con el conector. + La biblioteca [cbor](https://pypi.org/project/cbor/) instalada en el núcleo de Greengrass. La versión 1.0.0 es la última versión que se verifica para que funcione con el conector. ------ #### [ Versions 1 - 2 ] + AWS IoT Greengrass Software básico v1.7 o posterior. + Versión 2.7 de [Python](https://www.python.org/) instalada en el dispositivo principal y añadida a la variable de entorno PATH. + AWS IoT Device Defender configurado para usar la función de detección para realizar un seguimiento de las infracciones. Para obtener más información, consulte [Detectar](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html) en la *Guía para desarrolladores de AWS IoT *. + Un [recurso de volumen local](access-local-resources.md) en el grupo de Greengrass que apunta al directorio `/proc`. El recurso debe usar las siguientes propiedades: + Ruta de origen: `/proc` + Ruta de destino: `/host_proc` (o un valor que coincide con el [patrón válido](#param-ProcDestinationPath)) + AutoAddGroupOwner: `true` + La biblioteca [psutil](https://pypi.org/project/psutil/) instalada en el núcleo de Greengrass. + La biblioteca [cbor](https://pypi.org/project/cbor/) instalada en el núcleo de Greengrass. ------ ## Parámetros de conector Este conector proporciona los siguientes parámetros: `SampleIntervalSeconds` El número de segundos entre cada ciclo de recopilación y generación de informes de métricas. El valor mínimo es de 300 segundos (5 minutos). Nombre para mostrar en la AWS IoT consola: **intervalo de informes de métricas** Obligatorio: `true` Tipo: `string` Patrón válido: `^[0-9]*(?:3[0-9][0-9]|[4-9][0-9]{2}|[1-9][0-9]{3,})$` `ProcDestinationPath-ResourceId` El ID del recurso del volumen `/proc`. A este conector se le concede acceso de solo lectura al recurso. Nombre para mostrar en la AWS IoT consola: **recurso para el directorio /proc** Obligatorio: `true` Tipo: `string` Patrón válido: `[a-zA-Z0-9_-]+` `ProcDestinationPath` La ruta de destino del recurso del volumen `/proc`. Nombre para mostrar en la AWS IoT consola: **ruta de destino del** recurso /proc Obligatorio: `true` Tipo: `string` Patrón válido: `\/[a-zA-Z0-9_-]+` ### Ejemplo de creación de conector (AWS CLI) El siguiente comando de la CLI crea una `ConnectorDefinition` con una versión inicial que contiene el conector de Device Defender. ``` aws greengrass create-connector-definition --name MyGreengrassConnectors --initial-version '{ "Connectors": [ { "Id": "MyDeviceDefenderConnector", "ConnectorArn": "arn:aws:greengrass:region::/connectors/DeviceDefender/versions/3", "Parameters": { "SampleIntervalSeconds": "600", "ProcDestinationPath": "/host_proc", "ProcDestinationPath-ResourceId": "my-proc-resource" } } ] }' ``` **nota** La función de Lambda de este conector tiene un ciclo de vida [prolongado](lambda-functions.md#lambda-lifecycle). En la AWS IoT Greengrass consola, puede añadir un conector desde la página de **conectores** del grupo. Para obtener más información, consulte [Introducción a los conectores de Greengrass (consola)](connectors-console.md). ## Datos de entrada Este conector no acepta mensajes MQTT como datos de entrada. ## Datos de salida Este conector publica las métricas de seguridad AWS IoT Device Defender como datos de salida. **Filtro de temas en la suscripción** `$aws/things/+/defender/metrics/json` Esta es la sintaxis del tema que se AWS IoT Device Defender espera. El conector sustituye el comodín `+` con el nombre de dispositivo (por ejemplo `$aws/things/thing-name/defender/metrics/json`). **Ejemplo de salida** Para obtener detalles sobre los informes de métricas, consulte [Especificación de documentos de métricas de dispositivos](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html#DetectMetricsMessagesSpec) en la *Guía del desarrollador de AWS IoT *. ``` { "header": { "report_id": 1529963534, "version": "1.0" }, "metrics": { "listening_tcp_ports": { "ports": [ { "interface": "eth0", "port": 24800 }, { "interface": "eth0", "port": 22 }, { "interface": "eth0", "port": 53 } ], "total": 3 }, "listening_udp_ports": { "ports": [ { "interface": "eth0", "port": 5353 }, { "interface": "eth0", "port": 67 } ], "total": 2 }, "network_stats": { "bytes_in": 1157864729406, "bytes_out": 1170821865, "packets_in": 693092175031, "packets_out": 738917180 }, "tcp_connections": { "established_connections":{ "connections": [ { "local_interface": "eth0", "local_port": 80, "remote_addr": "192.168.0.1:8000" }, { "local_interface": "eth0", "local_port": 80, "remote_addr": "192.168.0.1:8000" } ], "total": 2 } } } } ``` ## Licencias Este conector se publica bajo el [contrato de licencia de software de Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Registros de cambios La siguiente tabla describe los cambios en cada versión del conector. | Versión | Cambios | | --- | --- | | 3 | Se actualizó el tiempo de ejecución de Lambda a Python 3.7, lo que cambia el requisito de tiempo de ejecución. | | 2 | Se ha introducido una corrección para reducir el registro excesivo. | | 1 | Versión inicial. | Un grupo de Greengrass solo puede contener una versión del conector a la vez. Para obtener información sobre cómo actualizar una versión de conector, consulte [Actualización de versiones de los conectores](connectors.md#upgrade-connector-versions). ## Véase también + [Integración con servicios y protocolos mediante conectores de Greengrass](connectors.md) + [Introducción a los conectores de Greengrass (consola)](connectors-console.md) + [Introducción a los conectores de Greengrass (CLI)](connectors-cli.md) + [Device Defender](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender.html) en la *Guía para desarrolladores de AWS IoT *