를 사용하여 통화 로깅 AWS IoT API AWS CloudTrail

AWS IoT 는 의 사용자 AWS CloudTrail, 역할 또는 AWS 서비스에서 수행한 작업의 레코드를 제공하는 서비스인 와 통합됩니다 AWS IoT. 는 AWS IoT 콘솔의 API 호출 및 에 대한 코드 호출을 포함하여 에 대한 모든 호출을 이벤트 AWS IoT 로 CloudTrail 캡처합니다 AWS IoT APIs. 추적을 생성하는 경우 에 CloudTrail 대한 이벤트를 포함하여 Amazon S3 버킷으로 이벤트를 지속적으로 전송할 수 있습니다 AWS IoT. 추적을 구성하지 않은 경우에도 CloudTrail 콘솔의 이벤트 기록 에서 최신 이벤트를 볼 수 있습니다. 에서 수집한 정보를 사용하여 에 수행된 요청 CloudTrail, 요청이 수행된 AWS IoT IP 주소, 요청을 수행한 사람, 요청이 수행된 시간 및 기타 세부 정보를 확인할 수 있습니다.

에 대한 자세한 내용은 AWS CloudTrail 사용 설명서 섹션을 CloudTrail참조하세요.

AWS IoT 의 정보 CloudTrail

CloudTrail 계정을 생성할 AWS 계정 때 에서 가 활성화됩니다. 에서 활동이 발생하면 AWS IoT해당 활동은 CloudTrail 이벤트 기록 의 다른 AWS 서비스 이벤트와 함께 이벤트에 기록됩니다. 에서 최근 이벤트를 보고 검색하고 다운로드할 수 있습니다 AWS 계정. 자세한 내용은 이벤트 기록을 사용하여 CloudTrail 이벤트 보기를 참조하세요.

AWS IoT에 대한 이벤트를 포함하여 AWS 계정에 이벤트를 지속적으로 기록하려면 추적을 생성합니다. 추적을 사용하면 CloudTrail 가 Amazon S3 버킷에 로그 파일을 전달할 수 있습니다. 기본적으로 콘솔에서 추적을 생성하면 추적이 모든 에 적용됩니다 AWS 리전. 추적은 AWS 리전 AWS 파티션의 모든 에서 이벤트를 기록하고 지정한 Amazon S3 버킷에 로그 파일을 전달합니다. CloudTrail 로그에서 수집된 이벤트 데이터를 추가로 분석하고 이에 따라 작업하도록 다른 AWS 서비스를 구성할 수 있습니다. 자세한 내용은 다음을 참조하세요.

• 추적 생성 개요

• CloudTrail 지원되는 서비스 및 통합

• 에 대한 Amazon SNS 알림 구성 CloudTrail

• 여러 리전에서 CloudTrail 로그 파일 수신 및 여러 계정에서 로그 파일 수신 CloudTrail

참고

AWS IoT 데이터 영역 작업(장치 측)은 에서 기록하지 않습니다 CloudTrail. CloudWatch 를 사용하여 이러한 작업을 모니터링합니다.

일반적으로 변경을 수행하는 AWS IoT 제어 영역 작업은 에 의해 기록됩니다 CloudTrail. CreateThing, CreateKeysAndCertificate, 와 같은 통화는 CloudTrail 항목을 UpdateCertificate 남기고, ListThings 및 와 같은 통화는 항목을 남기지 ListTopicRules 않습니다.

모든 이벤트 및 로그 항목에는 요청을 생성한 사용자에 대한 정보가 들어 있습니다. 보안 인증 정보를 이용하면 다음을 쉽게 판단할 수 있습니다.

• 루트 또는 IAM 사용자 자격 증명으로 요청이 이루어졌는지 여부.

• 역할 또는 페더레이션 사용자에 대한 임시 보안 보안 인증을 사용하여 요청이 생성되었는지 여부.

• 요청이 다른 AWS 서비스에 의해 이루어졌는지 여부.

자세한 내용은 CloudTrail userIdentity 요소를 참조하세요.

AWS IoT 작업은 AWS IoT API 참조 에 설명되어 있습니다. AWS IoT 무선 작업은 AWS IoT 무선 API 참조 에 설명되어 있습니다.

AWS IoT 로그 파일 항목 이해

추적은 사용자가 지정한 Amazon S3 버킷에 로그 파일로 이벤트를 전달할 수 있도록 하는 구성입니다. CloudTrail 로그 파일에는 하나 이상의 로그 항목이 포함됩니다. 이벤트는 모든 소스의 단일 요청을 나타내며 요청된 작업, 작업 날짜 및 시간, 요청 파라미터 등에 대한 정보를 포함합니다. CloudTrail log 파일은 퍼블릭 API 호출의 순서가 지정된 스택 추적이 아니므로 특정 순서로 표시되지 않습니다.

다음 예제에서는 AttachPolicy 작업을 보여주는 CloudTrail 로그 항목을 보여줍니다.

{
    "timestamp":"1460159496",
    "AdditionalEventData":"",
    "Annotation":"",
    "ApiVersion":"",
    "ErrorCode":"",
    "ErrorMessage":"",
    "EventID":"8bff4fed-c229-4d2d-8264-4ab28a487505",
    "EventName":"AttachPolicy",
    "EventTime":"2016-04-08T23:51:36Z",
    "EventType":"AwsApiCall",
    "ReadOnly":"",
    "RecipientAccountList":"",
    "RequestID":"d4875df2-fde4-11e5-b829-23bf9b56cbcd",
    "RequestParamters":{
        "principal":"arn:aws:iot:us-east-1:123456789012:cert/528ce36e8047f6a75ee51ab7beddb4eb268ad41d2ea881a10b67e8e76924d894",
        "policyName":"ExamplePolicyForIoT"
    },
    "Resources":"",
    "ResponseElements":"",
    "SourceIpAddress":"52.90.213.26",
    "UserAgent":"aws-internal/3",
    "UserIdentity":{
        "type":"AssumedRole",
        "principalId":"AKIAI44QH8DHBEXAMPLE",
        "arn":"arn:aws:sts::12345678912:assumed-role/iotmonitor-us-east-1-beta-InstanceRole-1C5T1YCYMHPYT/i-35d0a4b6",
        "accountId":"222222222222",
        "accessKeyId":"access-key-id",
        "sessionContext":{
            "attributes":{
                "mfaAuthenticated":"false",
                "creationDate":"Fri Apr 08 23:51:10 UTC 2016"
            },
            "sessionIssuer":{
                "type":"Role",
                "principalId":"AKIAI44QH8DHBEXAMPLE",
                "arn":"arn:aws:iam::123456789012:role/executionServiceEC2Role/iotmonitor-us-east-1-beta-InstanceRole-1C5T1YCYMHPYT",
                "accountId":"222222222222",
                "userName":"iotmonitor-us-east-1-InstanceRole-1C5T1YCYMHPYT"
            }
        },
        "invokedBy":{
            "serviceAccountId":"111111111111"
        }
    },
    "VpcEndpointId":""
}