지원 종료 공지: 2026년 10월 7일에는에 대한 지원을 중단할 AWS 예정입니다 AWS IoT Greengrass Version 1. 2026년 10월 7일 이후에는 더 이상 AWS IoT Greengrass V1 리소스에 액세스할 수 없습니다. 자세한 내용은 [에서 마이그레이션 AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html)을 참조하세요. 기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Defice Defender 커넥터 Device Defender [커넥터](connectors.md)는 관리자에게 Greengrass 코어 장치의 상태 변경을 알립니다. 그러면 손상된 장치를 나타낼 수 있는 비정상적인 동작을 식별할 수 있습니다. 이 커넥터는 코어 디바이스의 `/proc` 디렉터리에서 시스템 지표를 읽은 다음 지표를에 게시합니다 AWS IoT Device Defender. 지표 보고 세부 정보는 *AWS IoT 개발자 안내서*의 [장치 지표 문서 사양](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html#DetectMetricsMessagesSpec)을 참조하십시오. 이 커넥터의 버전은 다음과 같습니다. | 버전 | 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` | 버전 변경 사항에 대한 자세한 내용은 [Changelog](#device-defender-connector-changelog)를 참조하십시오. ## 요구 사항 이 커넥터에는 다음과 같은 요구 사항이 있습니다. ------ #### [ Version 3 ] + AWS IoT Greengrass 코어 소프트웨어 v1.9.3 이상. + 코어 장치에 설치되고 PATH 환경 변수에 추가된 [Python](https://www.python.org/) 버전 3.7 또는 3.8입니다. **참고** Python 3.8을 사용하려면 다음 명령을 실행하여 기본 Python 3.7 설치 폴더에서 설치된 Python 3.8 바이너리로 연결되는 심볼릭 링크를 만드십시오. ``` sudo ln -s {{path-to-python-3.8}}/python3.8 /usr/bin/python3.7 ``` 이렇게 하면 AWS IoT Greengrass에 대한 Python 요구 사항을 충족하도록 장치가 구성됩니다. + AWS IoT Device Defender Detect 기능을 사용하여 위반을 추적하도록 구성되었습니다. 자세한 정보는 *AWS IoT 개발자 안내서*의 [감지](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html) 사용 방법을 참조하세요. + `/proc` 디렉터리를 가리키는 Greengrass 그룹의 [로컬 볼륨 리소스](access-local-resources.md) 이 리소스는 다음 속성을 사용해야 합니다. + 소스 경로: `/proc` + 대상 경로: `/host_proc`(또는 [유효한 패턴](#param-ProcDestinationPath)과 일치하는 값) + AutoAddGroupOwner: `true` + Greengrass 코어에 설치된 [psutil](https://pypi.org/project/psutil/) 라이브러리입니다. 버전 5.7.0은 커넥터와 함께 사용하도록 확인된 최신 버전입니다. + Greengrass 코어에 설치된 [cbor](https://pypi.org/project/cbor/) 라이브러리입니다. 버전 1.0.0은 커넥터와 함께 사용하도록 확인된 최신 버전입니다. ------ #### [ Versions 1 - 2 ] + AWS IoT Greengrass 코어 소프트웨어 v1.7 이상. + 코어 장치에 설치되고 PATH 환경 변수에 추가된 [Python](https://www.python.org/) 버전 2.7입니다. + AWS IoT Device Defender Detect 기능을 사용하여 위반을 추적하도록 구성되었습니다. 자세한 정보는 *AWS IoT 개발자 안내서*의 [감지](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html) 사용 방법을 참조하세요. + `/proc` 디렉터리를 가리키는 Greengrass 그룹의 [로컬 볼륨 리소스](access-local-resources.md) 이 리소스는 다음 속성을 사용해야 합니다. + 소스 경로: `/proc` + 대상 경로: `/host_proc`(또는 [유효한 패턴](#param-ProcDestinationPath)과 일치하는 값) + AutoAddGroupOwner: `true` + Greengrass 코어에 설치된 [psutil](https://pypi.org/project/psutil/) 라이브러리입니다. + Greengrass 코어에 설치된 [cbor](https://pypi.org/project/cbor/) 라이브러리입니다. ------ ## 커넥터 파라미터 이 커넥터는 다음 파라미터를 제공합니다. `SampleIntervalSeconds` 각 지표 수집 및 보고 주기 사이 시간(초). 최소값은 300초(5분)입니다. AWS IoT 콘솔의 표시 이름: **지표 보고 간격** 필수: `true` 유형: `string` 유효한 패턴: `^[0-9]*(?:3[0-9][0-9]|[4-9][0-9]{2}|[1-9][0-9]{3,})$` `ProcDestinationPath-ResourceId` `/proc` 볼륨 리소스의 ID. 이 커넥터에는 리소스에 대한 읽기 전용 액세스 권한이 부여됩니다. AWS IoT 콘솔의 표시 이름: **/proc 디렉터리에 대한 리소스** 필수: `true` 유형: `string` 유효한 패턴: `[a-zA-Z0-9_-]+` `ProcDestinationPath` `/proc` 볼륨 리소스의 대상 경로. AWS IoT 콘솔의 표시 이름: **/proc 리소스의 대상 경로** 필수: `true` 유형: `string` 유효한 패턴: `\/[a-zA-Z0-9_-]+` ### 커넥터 만들기 예(AWS CLI) 다음 CLI 명령은 Device Defender 커넥터가 포함된 초기 버전을 사용하여 `ConnectorDefinition`을 생성합니다. ``` 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" } } ] }' ``` **참고** 이 커넥터의 Lambda 함수에는 [수명이 긴](lambda-functions.md#lambda-lifecycle) 수명 주기가 있습니다. AWS IoT Greengrass 콘솔의 커넥터 페이지에서 커넥터를 추가할 수 **있습니다**. 자세한 내용은 [Greengrass 커넥터 시작하기(콘솔)](connectors-console.md) 단원을 참조하십시오. ## 입력 데이터 이 커넥터는 MQTT 메시지를 출력 데이터로 게시하지 않습니다. ## 출력 데이터 이 커넥터는에 출력 데이터 AWS IoT Device Defender 로 보안 지표를 게시합니다. **구독의 주제 필터** `$aws/things/+/defender/metrics/json` 가 AWS IoT Device Defender 예상하는 주제 구문입니다. 이 커넥터는 `+` 와일드카드를 장치 이름으로 바꿉니다(예: `$aws/things/{{thing-name}}/defender/metrics/json`). **출력 예** 지표 보고 세부 정보는 *AWS IoT 개발자 안내서*의 [장치 지표 문서 사양](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender-detect.html#DetectMetricsMessagesSpec)을 참조하십시오. ``` { "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 } } } } ``` ## 라이선스 이 커넥터는 [Greengrass 코어 소프트웨어 라이선스 계약](https://greengrass-release-license.s3.us-west-2.amazonaws.com/greengrass-license-v1.pdf)에 따라 릴리스됩니다. ## Changelog 다음 표에서는 의 각 릴리스에서 변경된 중요 사항에 대해 설명합니다. | 버전 | 변경 사항 | | --- | --- | | 3 | Lambda 런타임 요구 사항을 변경하는 Python 3.7로 런타임을 업그레이드했습니다. | | 2 | 과도한 로깅을 줄이도록 고정합니다. | | 1 | 최초 릴리스입니다. | Greengrass 그룹은 한 번에 하나의 커넥터 버전만 포함할 수 있습니다. 커넥터 버전 업그레이드에 대한 자세한 내용은 [커넥터 버전 업그레이드](connectors.md#upgrade-connector-versions)을 참조하십시오. ## 다음 사항도 참조하세요. + [Greengrass 커넥터를 사용하여 서비스 및 프로토콜과 통합](connectors.md) + [Greengrass 커넥터 시작하기(콘솔)](connectors-console.md) + [Greengrass 커넥터 시작하기(CLI)](connectors-cli.md) + *AWS IoT 개발자 안내서*의 [Device Defender](https://docs.aws.amazon.com/iot/latest/developerguide/device-defender.html)