API 호출을 AWS CloudTrail 기록하는 데 사용 - Amazon Chime SDK
추적 생성트레일로 캡처한 데이터Amazon Chime SDK 로그 파일 항목의 이해

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

API 호출을 AWS CloudTrail 기록하는 데 사용

Amazon Chime SDK는 사용자 AWS CloudTrail, 역할 또는 서비스가 Amazon Chime SDK에서 수행한 작업의 기록을 제공하는 서비스와 통합됩니다. AWS CloudTrail Amazon Chime SDK 콘솔에서의 호출 및 Amazon Chime SDK API에 대한 코드 호출을 포함하여 Amazon Chime SDK에 대한 모든 API 호출을 이벤트로 캡처합니다.

트레일을 생성하면 Amazon Chime SDK에 대한 CloudTrail 이벤트를 포함하여 Amazon S3 버킷에 이벤트를 지속적으로 전송할 수 있습니다. 트레일을 구성하지 않아도 CloudTrail 콘솔의 이벤트 기록 페이지에서 최신 이벤트를 계속 볼 수 있습니다. 이 정보에는 각 요청, 요청이 이루어진 IP 주소, 요청한 사람 등이 포함됩니다.

CloudTrail 계정을 만들면 AWS 계정에서 활성화됩니다. Amazon Chime 관리 콘솔에서 API 호출을 수행하면 이벤트의 해당 활동을 CloudTrail 기록합니다. 이벤트를 보려면 CloudTrail 콘솔을 시작하고 이벤트 기록으로 이동하십시오. AWS 계정에서 최근 이벤트를 보고, 검색하고, 다운로드할 수 있습니다. 자세한 내용은 이벤트 기록으로 CloudTrail 이벤트 보기를 참조하십시오.

자세히 CloudTrail 알아보려면 AWS CloudTrail 사용 설명서를 참조하십시오.

추적 생성

다음 항목에서는 CloudTrail 콘솔을 사용하여 트레일을 만드는 방법을 설명합니다. 기본적으로 콘솔에서 트레일을 생성하면 트레일은 AWS 파티션에 있는 모든 지역의 이벤트를 기록하고 지정한 Amazon S3 버킷으로 로그 파일을 전송합니다.

다음 주제를 나열된 순서대로 따르십시오.

  1. 추적 생성 개요

  2. CloudTrail 지원되는 서비스 및 통합

  3. 에 대한 Amazon SNS 알림 구성 CloudTrail

  4. 여러 지역에서 CloudTrail 로그 파일 수신 및 여러 계정으로부터 CloudTrail 로그 파일 수신

트레일로 캡처한 데이터

CloudTrail 모든 Amazon Chime SDK 작업을 기록합니다. 작업에 대한 자세한 내용은 Amazon Chime SDK API 레퍼런스를 참조하십시오. 예를 들어 CreateAttendee, 작업을 호출하면 CloudTrail 로그 파일에 항목이 생성됩니다. 모든 이벤트에는 요청을 생성한 사람에 대한 정보가 포함됩니다. 자격 증명 정보를 이용하면 다음을 쉽게 판단할 수 있습니다.

  • 요청을 루트로 했는지 아니면 IAM 사용자 보안 인증 정보로 했는지 여부.

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

  • 다른 AWS 서비스에서 요청했는지 여부.

자세한 내용은 CloudTrail사용자 ID 요소를 참조하십시오.

Amazon Chime SDK 로그 파일 항목의 이해

트레일은 지정한 Amazon S3 버킷에 이벤트를 로그 파일로 전송할 수 있는 구성입니다. CloudTrail 로그 파일에는 하나 이상의 로그 항목이 포함되어 있습니다. 이벤트는 모든 소스로부터의 단일 요청을 나타내며 요청 작업, 작업 날짜와 시간, 요청 파라미터 등에 대한 정보가 들어 있습니다. CloudTrail 로그 파일은 공개 API 호출의 정렬된 스택 추적이 아니므로 특정 순서로 표시되지 않습니다.

Amazon Chime SDK의 항목은 chime.amazonaws.com 이벤트 소스로 식별됩니다.

Amazon Chime SDK 계정에 대해 Active Directory를 구성한 경우, 를 사용하여 AWS 디렉터리 서비스 API 호출 로깅을 참조하십시오. CloudTrail 여기서는 Amazon Chime SDK 사용자의 로그인 기능에 영향을 미칠 수 있는 문제를 모니터링하는 방법을 설명합니다.

다음 예는 Amazon Chime SDK의 CloudTrail 로그 항목을 보여줍니다.

{"eventVersion":"1.05",
         "userIdentity":{  
            "type":"IAMUser",
            "principalId":"AAAAAABBBBBBBBEXAMPLE",
            "arn":"arn:aws:iam::123456789012:user/Alice",
            "accountId":"0123456789012",
            "accessKeyId":"AAAAAABBBBBBBBEXAMPLE",
            "sessionContext":{  
               "attributes":{  
                  "mfaAuthenticated":"false",
                  "creationDate":"2017-07-24T17:57:43Z"
               },
               "sessionIssuer":{  
                  "type":"Role",
                  "principalId":"AAAAAABBBBBBBBEXAMPLE",
                  "arn":"arn:aws:iam::123456789012:role/Joe",
                  "accountId":"123456789012",
                  "userName":"Joe"
               }
            }
         } ,
         "eventTime":"2017-07-24T17:58:21Z",
         "eventSource":"chime.amazonaws.com",
         "eventName":"AddDomain",
         "awsRegion":"us-east-1",
         "sourceIPAddress":"72.21.198.64",
         "userAgent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_11_6) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/59.0.3071.115 Safari/537.36",
         "errorCode":"ConflictException",
         "errorMessage":"Request could not be completed due to a conflict",
         "requestParameters":{  
            "domainName":"example.com",
            "accountId":"11aaaaaa1-1a11-1111-1a11-aaadd0a0aa00"
         },
         "responseElements":null,
         "requestID":"be1bee1d-1111-11e1-1eD1-0dc1111f1ac1",
         "eventID":"00fbeee1-123e-111e-93e3-11111bfbfcc1",
         "eventType":"AwsApiCall",
         "recipientAccountId":"123456789012"
      }