update-trail 사용

중요

2021년 11월 22일 현재AWS CloudTrail트레일이 글로벌 서비스 이벤트를 캡처하는 방식을 변경했습니다. 이제 Amazon에서 만든 이벤트는 CloudFront,AWS Identity and Access Management, 그리고AWS STS생성된 리전 (us-east-1) 의 미국 동부 (버지니아 북부) 리전 (us-east-1) 의 리전 (us-east-1) 의 리전 (us-east-1) 의 추적을 따릅니다. 이렇게 해서 CloudTrail 이러한 서비스를 다른 서비스와 일관되게 취급합니다AWS글로벌 서비스. 글로벌 서비스 이벤트를 미국 동부 (버지니아 북부) 리전 (us-버지니아 북부) 의 다른 (버지니아 북부) 리전 (us-us-east-us-us-east-us-east-us-ina) 의 다른단일 지역 트레일미국 동부 (버지니아 북부) 이외 지역의 글로벌 서비스 이벤트 사용여러 지역 전용 트레일. 글로벌 서비스 이벤트 캡처에 대한 자세한 내용은 이 단원의 후반부에서 글로벌 서비스 이벤트 로깅 활성화 및 비활성화을(를) 참조하세요.

이와는 대조적으로이벤트 기록에서 CloudTrail 콘솔 및aws cloudtrail lookup-events명령은 이러한 이벤트가 발생한 지역의 이벤트를 표시합니다. 예를 들어ConsoleLogin이벤트는 us-west-1에서 발생했습니다.이벤트 기록에서 CloudTrail 콘솔 및aws cloudtrail lookup-events명령을 실행하면 us-west-1에서 이 이벤트가 표시됩니다.

update-trail 명령을 사용하여 추적에 대한 구성 설정을 변경할 수 있습니다. 또한 add-tags 및 remove-tags 명령을 사용하여 추적의 태그를 추가하고 제거할 수 있습니다. 추적이 생성된 AWS 리전(홈 리전)에서만 추적을 업데이트할 수 있습니다. AWS CLI를 사용할 때는 프로필에 구성된 AWS 리전에서 명령이 실행된다는 점을 기억해야 합니다. 다른 리전에서 명령을 실행하려는 경우 프로필의 기본 리전을 변경하거나 명령에 --region 파라미터를 사용합니다.

활성화한 경우 CloudTrail Amazon Security Lake의 관리 이벤트는 다중 지역이고 두 가지를 모두 기록하는 조직 트레일을 하나 이상 유지 관리해야 합니다.read과write관리 전용 이벤트 Security Lake 요구 사항을 충족하지 못하는 방식으로 적격 트레일을 업데이트할 수 없습니다. 예를 들어, 트레일을 단일 지역으로 변경하거나 로깅을 해제하는 등의 방법을 사용할 수 있습니다.read또는write관리 전용 이벤트

참고

를 사용하는 경우AWS CLI또는 다음 중 하나AWS트레일을 수정하기 위한 SDK는 트레일의 버킷 정책이 다음과 같은지 확인하세요 up-to-date. 버킷이 새 버킷의 이벤트를 자동으로 수신하도록 하려면AWS 리전정책에는 전체 서비스 이름이 포함되어야 합니다.cloudtrail.amazonaws.com. 자세한 정보는 에 대한 Amazon S3 버킷 정책 CloudTrail을 참조하세요.

한 리전에 적용되는 추적을 모든 리전에 적용되는 추적으로 변환

모든 리전에 적용되도록 기존 추적을 변경하려면 --is-multi-region-trail 옵션을 사용합니다.

aws cloudtrail update-trail --name my-trail --is-multi-region-trail

이제 추적이 모든 리전에 적용되는지 확인하려면 출력의 IsMultiRegionTrail 요소에 true가 표시되는지 확인합니다.

{
    "IncludeGlobalServiceEvents": true, 
    "Name": "my-trail", 
    "TrailARN": "arn:aws:cloudtrail:us-east-2:123456789012:trail/my-trail", 
    "LogFileValidationEnabled": false, 
    "IsMultiRegionTrail": true, 
    "IsOrganizationTrail": false,
    "S3BucketName": "my-bucket"
}

다중 지역 트레일을 단일 지역 트레일로 전환

기존 다중 지역 트레일을 변경하여 해당 트레일이 생성된 지역에만 적용되도록 하려면 다음을 사용하십시오.--no-is-multi-region-trail옵션.

aws cloudtrail update-trail --name my-trail --no-is-multi-region-trail

이제 추적이 단일 리전에 적용되는지 확인하려면 출력의 IsMultiRegionTrail 요소에 false가 표시되는지 확인합니다.

{
    "IncludeGlobalServiceEvents": true, 
    "Name": "my-trail", 
    "TrailARN": "arn:aws:cloudtrail:us-east-2:123456789012:trail/my-trail", 
    "LogFileValidationEnabled": false, 
    "IsMultiRegionTrail": false, 
    "IsOrganizationTrail": false,
    "S3BucketName": "my-bucket"
}

글로벌 서비스 이벤트 로깅 활성화 및 비활성화

글로벌 서비스 이벤트를 로깅하지 않도록 추적을 변경하려면 --no-include-global-service-events 옵션을 사용합니다.

aws cloudtrail update-trail --name my-trail --no-include-global-service-events

추적이 글로벌 서비스 이벤트를 더 이상 로깅하지 않는지 확인하려면 출력의 IncludeGlobalServiceEvents 요소에 false가 표시되는지 확인합니다.

{
    "IncludeGlobalServiceEvents": false, 
    "Name": "my-trail", 
    "TrailARN": "arn:aws:cloudtrail:us-east-2:123456789012:trail/my-trail", 
    "LogFileValidationEnabled": false, 
    "IsMultiRegionTrail": false, 
    "IsOrganizationTrail": false,
    "S3BucketName": "my-bucket"
}

글로벌 서비스 이벤트를 로깅하도록 추적을 변경하려면 --include-global-service-events 옵션을 사용합니다.

단일 리전 (us-east-1) 의 단일 리전 (us-east-1) 의 단일 리전 (us-east-1) 의 단일 리전 (us-east-1) 의 단일 리전 (us-east-1) 의 글로벌 서비스 이벤트는 2021년 11월 22일부터 단일 리전 추적을 사용할 수 없습니다. 글로벌 서비스 이벤트를 계속 캡처하려면 추적을 다중 리전 추적을 계속하여 추적을 생성하십시오. 예를 들어 이 명령은 미국 동부 (오하이오) 의 단일 리전 (us-east-2) 의 단일 리전 (us-east-2) 의 단일 리전 (us-east-2) 의 단일 리전 (us-east-2) 의 단일 리전 추적을 생성합니다. 바꾸기myExistingSingleRegionTrailWith예구성에 적합한 트레일 이름을 입력하십시오.

aws cloudtrail --region us-east-2 update-trail --name myExistingSingleRegionTrailWithGSE --is-multi-region-trail

글로벌 서비스 이벤트는 2021년 11월 22일부터 미국 동부 (버지니아 북부) 에서만 사용할 수 있으므로 단일 리전 추적을 생성하여 미국 동부 (버지니아 북부) 리전 (us-east-1) 의 글로벌 서비스 이벤트를 구독할 수도 있습니다. 다음 명령은 us-east-1 (us-east-1) 의 단일 리전 추적을 생성하여 수신할 수 있습니다. CloudFront, IAM,AWS STS이벤트:

aws cloudtrail --region us-east-1 create-trail --include-global-service-events --name myTrail --s3-bucket-name DOC-EXAMPLE-BUCKET

로그 파일 검증 활성화

추적에 대해 로그 파일 검증을 활성화하려면 --enable-log-file-validation 옵션을 사용합니다. 해당 추적에 대해 다이제스트 파일이 Amazon S3 버킷에 전달됩니다.

aws cloudtrail update-trail --name my-trail --enable-log-file-validation

로그 파일 검증이 활성화되었는지 확인하려면 출력의 LogFileValidationEnabled 요소에 true가 표시되는지 확인합니다.

{
    "IncludeGlobalServiceEvents": true, 
    "Name": "my-trail", 
    "TrailARN": "arn:aws:cloudtrail:us-east-2:123456789012:trail/my-trail", 
    "LogFileValidationEnabled": true, 
    "IsMultiRegionTrail": false, 
    "IsOrganizationTrail": false,
    "S3BucketName": "my-bucket"
}

로그 파일 검증 비활성화

추적에 대해 로그 파일 검증을 비활성화하려면 --no-enable-log-file-validation 옵션을 사용합니다.

aws cloudtrail update-trail --name my-trail-name --no-enable-log-file-validation

로그 파일 검증이 비활성화되었는지 확인하려면 출력의 LogFileValidationEnabled 요소에 false가 표시되는지 확인합니다.

{
    "IncludeGlobalServiceEvents": true, 
    "Name": "my-trail", 
    "TrailARN": "arn:aws:cloudtrail:us-east-2:123456789012:trail/my-trail", 
    "LogFileValidationEnabled": false, 
    "IsMultiRegionTrail": false, 
    "IsOrganizationTrail": false,
    "S3BucketName": "my-bucket"
}

AWS CLI를 사용하여 로그 파일을 검증하려면 검증 중 CloudTrail 로그 파일 무결성AWS CLI 단원을 참조하십시오.