Aviso de fim do suporte: em 7 de outubro de 2026, AWS o suporte para o. AWS IoT Greengrass Version 1 Depois de 7 de outubro de 2026, você não poderá mais acessar os AWS IoT Greengrass V1 recursos. Para obter mais informações, visite [Migrar de AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html). As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Conector Device Defender O [conector](connectors.md) Device Defender notifica os administradores sobre alterações no estado de um dispositivo de núcleo do Greengrass. Isso pode ajudar a identificar comportamento incomum e, assim, indicar um dispositivo comprometido. Esse conector lê as métricas do sistema do `/proc` diretório no dispositivo principal e, em seguida, publica as métricas no. AWS IoT Device Defender Para obter detalhes de relatórios de métricas, consulte [Especificação da documentação de métricas do dispositivo](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html#DetectMetricsMessagesSpec) no *Guia do desenvolvedor do AWS IoT *. Esse conector tem as seguintes versões. | Versão | 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 obter informações sobre alterações de versão, consulte o [Changelog](#device-defender-connector-changelog). ## Requisitos Esse conector tem os seguintes requisitos: ------ #### [ Version 3 ] + AWS IoT Greengrass Software principal v1.9.3 ou posterior. + [Python](https://www.python.org/), versão 3.7 ou 3.8, instalado no dispositivo de núcleo e adicionado à variável de ambiente PATH. **nota** Para usar o Python 3.8, execute o comando a seguir para criar um symblink da pasta de instalação padrão do Python 3.7 para os binários instalados do Python 3.8. ``` sudo ln -s {{path-to-python-3.8}}/python3.8 /usr/bin/python3.7 ``` Isso configura seu dispositivo para atender ao requisito Python para AWS IoT Greengrass. + AWS IoT Device Defender configurado para usar o recurso Detectar para acompanhar as violações. Para obter mais informações, consulte [Detectar](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html) no *Guia do desenvolvedor do AWS IoT *. + Um [recurso de volume local](access-local-resources.md) no grupo do Greengrass que aponta para o diretório `/proc`. O recurso deverá usar as seguintes propriedades: + Caminho de origem: `/proc` + Caminho de destino: `/host_proc` (ou um valor que corresponda ao [padrão válido](#param-ProcDestinationPath)) + AutoAddGroupOwner: `true` + A biblioteca [psutil](https://pypi.org/project/psutil/) instalada no núcleo do Greengrass. A versão 5.7.0 é a versão mais recente verificada para trabalhar com o conector. + A biblioteca [cbor](https://pypi.org/project/cbor/) instalada no núcleo do Greengrass. A versão 1.0.0 é a versão mais recente verificada para trabalhar com o conector. ------ #### [ Versions 1 - 2 ] + AWS IoT Greengrass Software principal v1.7 ou posterior. + [Python](https://www.python.org/) versão 2.7 instalado no dispositivo de núcleo e adicionado à variável de ambiente PATH. + AWS IoT Device Defender configurado para usar o recurso Detectar para acompanhar as violações. Para obter mais informações, consulte [Detectar](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html) no *Guia do desenvolvedor do AWS IoT *. + Um [recurso de volume local](access-local-resources.md) no grupo do Greengrass que aponta para o diretório `/proc`. O recurso deverá usar as seguintes propriedades: + Caminho de origem: `/proc` + Caminho de destino: `/host_proc` (ou um valor que corresponda ao [padrão válido](#param-ProcDestinationPath)) + AutoAddGroupOwner: `true` + A biblioteca [psutil](https://pypi.org/project/psutil/) instalada no núcleo do Greengrass. + A biblioteca [cbor](https://pypi.org/project/cbor/) instalada no núcleo do Greengrass. ------ ## Parâmetros do conector Esse conector oferece os seguintes parâmetros: `SampleIntervalSeconds` O número de segundos entre cada ciclo de coleta de métricas e geração de relatórios. O valor mínimo é 300 segundos (5 minutos). Nome de exibição no AWS IoT console: **intervalo de geração de relatórios de métricas** Obrigatório: `true` Digite: `string` Padrão válido: `^[0-9]*(?:3[0-9][0-9]|[4-9][0-9]{2}|[1-9][0-9]{3,})$` `ProcDestinationPath-ResourceId` O ID do recurso de volume `/proc`. Esse conector recebe acesso somente leitura ao recurso. Nome de exibição no AWS IoT console: **Recurso para o diretório /proc** Obrigatório: `true` Digite: `string` Padrão válido: `[a-zA-Z0-9_-]+` `ProcDestinationPath` O caminho de destino do recurso de volume `/proc`. Nome de exibição no AWS IoT console: **caminho de destino do recurso /proc** Obrigatório: `true` Digite: `string` Padrão válido: `\/[a-zA-Z0-9_-]+` ### Exemplo de criação de conector (AWS CLI) O seguinte comando da CLI cria um `ConnectorDefinition` com uma versão inicial que contém o conector 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** A função do Lambda nesse conector tem um ciclo de vida [longo](lambda-functions.md#lambda-lifecycle). No AWS IoT Greengrass console, você pode adicionar um conector na página **Conectores** do grupo. Para obter mais informações, consulte [Conceitos básicos de conectores do Greengrass (console)](connectors-console.md). ## Dados de entrada Esse conector não aceita mensagens MQTT como dados de entrada. ## Dados de saída Esse conector publica métricas de segurança AWS IoT Device Defender como dados de saída. **Filtro de tópico na assinatura** `$aws/things/+/defender/metrics/json` Essa é a sintaxe do tópico que AWS IoT Device Defender espera. O conector substitui o curinga `+` pelo nome do dispositivo (por exemplo, `$aws/things/{{thing-name}}/defender/metrics/json`). **Exemplo de saída** Para obter detalhes de relatórios de métricas, consulte [Especificação da documentação de métricas do dispositivo](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html#DetectMetricsMessagesSpec) no *Guia do desenvolvedor do 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 } } } } ``` ## Licenças Esse conector é liberado de acordo com o [Contrato de licença de software do Greengrass Core](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf). ## Changelog A tabela a seguir descreve as alterações em cada versão do conector. | Versão | Alterações | | --- | --- | | 3 | Atualização do runtime do Lambda para Python 3.7, o que altera o requisito de runtime. | | 2 | Corrija para reduzir o registro excessivo. | | 1 | Versão inicial. | Um grupo do Greengrass só pode conter uma versão do conector por vez. Para obter informações sobre como fazer upgrade de uma versão do conector, consulte [Atualizar a versões do conector](connectors.md#upgrade-connector-versions). ## Consulte também + [Integrar a serviços e protocolos usando conectores do Greengrass](connectors.md) + [Conceitos básicos de conectores do Greengrass (console)](connectors-console.md) + [Conceitos básicos de conectores do Greengrass (CLI)](connectors-cli.md) + [Device Defender](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender.html) no *Guia do desenvolvedor AWS IoT *