AWS IoT Device Defender 라이브러리 - FreeRTOS

문서의 영문과 번역 사이에 충돌이 있는 경우에는 영문 버전을 따릅니다. 번역 버전은 기계 번역을 사용하여 제공합니다.

AWS IoT Device Defender 라이브러리

Overview

AWS IoT Device Defender는 연결된 디바이스를 모니터링하여 비정상적인 동작을 감지하고 보안 위험을 완화할 수 있게 해주는 AWS IoT 서비스입니다. AWS IoT Device Defender를 사용하면 AWS IoT 디바이스 플릿에 대해 일관성 있는 IoT 구성을 적용하고, 디바이스가 손상된 경우 신속하게 대응하는 기능을 제공할 수 있습니다.

FreeRTOS 은(는) 라이브러리 이 기술을 통해 FreeRTOS-작업할 기반 기기 AWS IoT Device Defender. Device Defender 라이브러리를 소프트웨어 구성에 추가하여 FreeRTOS 콘솔에서 Device Defender 라이브러리를 사용하여 FreeRTOS를 다운로드할 수 있습니다. 또한 모든 FreeRTOS 라이브러리를 포함하는 FreeRTOS GitHub 리포지토리를 복제할 수 있습니다. 자세한 내용은 README.md 파일을 참조하십시오.

참고

FreeRTOS AWS IoT Device Defender 라이브러리는 연결 지표와 관련된 디바이스 측 AWS IoT Device Defender 지표의 하위 집합만 지원합니다. 자세한 정보는 사용 제한 단원을 참조하십시오.

종속성 및 요구 사항

Device Defender 라이브러리에는 다음 종속 항목이 있습니다.

Troubleshooting

FreeRTOS Device Defender 오류 코드

Device Defender 라이브러리는 오류 코드를 양수 값으로 반환합니다. 각 오류 코드에 대한 자세한 내용은 Device Defender C SDK API 참조AwsIotDefenderError_t를 참조하십시오.

FreeRTOS Device Defender 이벤트

Device Defender 라이브러리에는 성공 또는 실패를 나타내는 "이벤트"라고 하는 양수의 열거형 값을 반환하는 AwsIotDefenderCallback_t 콜백 함수가 포함되어 있습니다. 이벤트 유형에 대한 자세한 내용은 Device Defender C SDK API 참조AwsIotDefenderEventType_t를 참조하십시오.

FreeRTOS Device Defender 디버깅

Device Defender 라이브러리에 대한 디버깅을 활성화하려면 전역 구성 파일에서 Device Defender의 로그 수준을 디버깅 모드로 설정하십시오.

#define AWS_IOT_LOG_LEVEL_DEFENDER IOT_LOG_DEBUG

자세한 내용은 전역 구성 파일 참조를 참조하십시오.

개발자 지원

Device Defender 라이브러리에는 함수에 제공한 오류를 설명하는 문자열을 반환하는 AwsIotDefender_strerror 헬퍼 함수가 포함되어 있습니다.

const char * AwsIotDefender_strerror( AwsIotDefenderError_t error );

사용 제한

AWS IoT Device Defender 서비스는 데이터 직렬화를 위해 JSON 및 CBOR 형식을 모두 지원하지만 FreeRTOS Device Defender 라이브러리는 현재 구성 옵션 AWS_IOT_DEFENDER_FORMAT에 의해 제어되는 CBOR만 지원합니다.

또한 FreeRTOS AWS IoT Device Defender 라이브러리는 디바이스 측 AWS IoT Device Defender 지표의 하위 집합만 지원합니다.

긴 이름 짧은 이름 상위 요소 설명
remote_addr rad connections TCP 연결의 원격 주소를 나열합니다.
total t established_connections 설정된 TCP 연결 수를 나열합니다.

예: .

{ "tcp_connections": { "established_connections": { "connections": [ { "remote_addr": "192.168.0.1:8000" }, { "remote_addr": "192.168.0.2:8000" } ], "total": 2 } } }

FreeRTOS Device Defender 라이브러리는 JSON 형식의 지표를 지원하지 않으므로 이 JSON 문서는 예제 전용입니다.

Initialization

보안 소켓 지표를 사용하려면 AWS_IOT_SECURE_SOCKETS_METRICS_ENABLED 매크로를 정의해야 합니다. 이 매크로를 정의되지 않은 채로 두면 예기치 않은 동작이 발생할 수 있습니다.

FreeRTOS Device Defender API

전체 API 참조는 Device Defender C SDK API 참조를 참조하십시오.

사용 예:

사용 중인 Device Defender 라이브러리의 전체 예제는 AWS IoT Device Defender 데모 단원을 참조하십시오.