

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

# 를 사용하여 AWS Network Security Manager API 호출 로깅 AWS CloudTrail
<a name="logging-using-cloudtrail"></a>

AWS Network Security Manager는 사용자 AWS CloudTrail, 역할 또는 서비스가 수행한 작업에 대한 레코드를 제공하는 AWS 서비스와 통합됩니다. CloudTrail은 AWS Network Security Manager에 대한 모든 API 호출을 관리 이벤트로 캡처합니다. 캡처되는 호출에는 AWS Network Security Manager 콘솔의 호출과 AWS Network Security Manager API 작업에 대한 프로그래밍 방식의 호출이 포함됩니다.

추적을 생성하면 AWS Network Security Manager에 대한 이벤트를 포함하여 CloudTrail 이벤트를 지속적으로 Amazon S3 버킷에 배포할 수 있습니다. 트레일을 구성하지 않은 경우에도 CloudTrail 콘솔의 **이벤트 기록**에서 최신 이벤트를 볼 수 있습니다. 자세한 정보는 [AWS CloudTrail 사용 설명서](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/)를 참조하세요.

## AWS CloudTrail의 Network Security Manager 정보
<a name="cloudtrail-info"></a>

CloudTrail은 계정을 생성할 AWS 계정 때에서 활성화됩니다. AWS Network Security Manager에서 활동이 발생하면 해당 활동이 **이벤트 기록**의 다른 AWS 서비스 이벤트와 함께 CloudTrail 이벤트에 기록됩니다. 에서 최근 이벤트를 보고 검색하고 다운로드할 수 있습니다 AWS 계정. 자세한 내용은 [CloudTrail 이벤트 기록을 사용하여 이벤트 보기](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html)를 참조하세요.

 AWS Network Security Manager에 대한 이벤트를 AWS 계정포함하여에 이벤트를 지속적으로 기록하려면 추적을 생성합니다. CloudTrail은 *추적*을 사용하여 Amazon S3 버킷으로 로그 파일을 전송할 수 있습니다. 콘솔에서 트레일을 생성하면 기본적으로 모든 AWS 리전에 트레일이 적용됩니다. 추적은 파티션에 있는 모든 리전의 AWS 이벤트를 로깅합니다. 지정한 Amazon S3 버킷으로 로그 파일을 전송합니다. CloudTrail 로그에서 수집된 이벤트 데이터를 추가로 분석하고 조치를 취하도록 다른 AWS 서비스를 구성할 수 있습니다. 자세한 내용은 다음 자료를 참조하세요.
+ [추적 생성 개요](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail 지원 서비스 및 통합](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html)
+ [CloudTrail에 대한 Amazon SNS 알림 구성](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/configure-sns-notifications-for-cloudtrail.html)

모든 AWS Network Security Manager 작업은 CloudTrail에서 로깅됩니다. 퍼블릭 작업에는 다음이 포함됩니다.
+ 규칙, 템플릿, 정책, 범위 및 배포에 대한 CRUD(CruD) 작업 생성, 읽기, 업데이트 및 삭제
+ 스냅샷 작업
+ 태그 지정 작업
+ 관리자 계정 작업
+ 동기화 상태 작업
+ 리소스 연결 작업
+ 규칙 생성 작업

모든 이벤트 항목에는 다음 정보가 포함됩니다.
+ 이벤트 소스: `network-security-manager.amazonaws.com`
+ 이벤트 이름, 즉 API 작업 이름(예: `CreatePolicy` 또는 `ListDeployments`)
+ 영향을 받는 리소스, ARN 및 리소스 유형으로 식별됨

읽기 전용 작업(예: `GetPolicy`, `ListRules`및 `ListResourceSynchronizationStatuses`)은와 함께 로깅`readOnly: true`되며 응답 요소를 포함하지 않습니다. 변형 작업에는 요청 파라미터 및 응답 요소가 포함됩니다.

**참고**  
CloudTrail은 이벤트 레코드에서 민감한 필드를 수정합니다. 예를 들어 CloudTrail은 `GenerateRuleConfiguration` 작업에서 `prompt` 파라미터를 수정합니다.

## 예: CreatePolicy 이벤트
<a name="cloudtrail-example"></a>

다음 예제는 `CreatePolicy` 작업에 대한 CloudTrail 로그 항목을 보여줍니다.

```
{
  "eventVersion": "1.09",
  "userIdentity": {
      "type": "AssumedRole",
      "principalId": "AROAEXAMPLEID:my-session",
      "arn": "arn:aws:sts::123456789012:assumed-role/AdminRole/my-session",
      "accountId": "123456789012",
      "accessKeyId": "AKIAIOSFODNN7EXAMPLE",
      "sessionContext": {
          "sessionIssuer": {
              "type": "Role",
              "principalId": "AROAEXAMPLEID",
              "arn": "arn:aws:iam::123456789012:role/AdminRole",
              "accountId": "123456789012",
              "userName": "AdminRole"
          },
          "attributes": {
              "creationDate": "2026-08-10T18:22:41Z",
              "mfaAuthenticated": "false"
          }
      }
  },
  "eventTime": "2026-08-10T18:24:03Z",
  "eventSource": "network-security-manager.amazonaws.com",
  "eventName": "CreatePolicy",
  "awsRegion": "us-east-1",
  "sourceIPAddress": "192.0.2.44",
  "userAgent": "aws-cli/2.17.0 Python/3.12.4 Darwin/24.6.0",
  "requestParameters": {
      "clientToken": "550e8400-e29b-41d4-a716-446655440001",
      "policyName": "production-web-acl-policy",
      "firewallType": "WAF",
      "priority": 1,
      "associatedTemplateAndRuleList": [
          {
              "templateIdentifier": "arn:aws:network-security-manager:us-east-1:123456789012:template:t1a2b3c4d5"
          }
      ],
      "policyConfiguration": {
          "remediationEnabled": true,
          "resourcesCleanUp": false,
          "wafConfig": {
              "existingCustomerWebACLResolution": "RETROFIT",
              "conflictResolution": "MERGE_WHERE_APPLICABLE"
          }
      },
      "isPublished": true
  },
  "responseElements": {
      "policyId": "p9z8y7x6w5v4u3t2",
      "policyArn": "arn:aws:network-security-manager:us-east-1:123456789012:policy:p9z8y7x6w5v4u3t2",
      "policyName": "production-web-acl-policy",
      "status": "ACTIVE",
      "version": "1"
  },
  "requestID": "b1c2d3e4-5f67-4890-a1b2-c3d4e5f6a7b8",
  "eventID": "f0e1d2c3-b4a5-4968-8776-5a4b3c2d1e0f",
  "readOnly": false,
  "resources": [
      {
          "accountId": "123456789012",
          "type": "AWS::NetworkSecurityManager::Policy",
          "ARN": "arn:aws:network-security-manager:us-east-1:123456789012:policy:p9z8y7x6w5v4u3t2"
      }
  ],
  "eventType": "AwsApiCall",
  "managementEvent": true,
  "recipientAccountId": "123456789012",
  "eventCategory": "Management"
}
```