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

# X-Ray
<a name="automation-ref-xray"></a>

AWS Systems Manager 자동화는에 대한 사전 정의된 실행서를 제공합니다 AWS X-Ray. 실행서에 대한 자세한 내용은 [실행서 작업](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-documents.html)을 참조하세요. 실행서 콘텐츠를 보는 방법에 대한 자세한 내용은 [실행서 콘텐츠 보기](automation-runbook-reference.md#view-automation-json)(을)를 참조하세요.

**Topics**
+ [`AWSConfigRemediation-UpdateXRayKMSKey`](automation-aws-update-xray-key.md)

# `AWSConfigRemediation-UpdateXRayKMSKey`
<a name="automation-aws-update-xray-key"></a>

 **설명** 

 `AWSConfigRemediation-UpdateXRayKMSKey` 실행서는 AWS Key Management Service (AWS KMS) 키를 사용하여 AWS X-Ray 데이터에 대한 암호화를 활성화합니다. 이 실행서는 최소 권장 보안 모범 사례에 따라 AWS X-Ray 데이터를 암호화하기 위한 기준으로만 사용해야 합니다. 서로 다른 KMS 키를 사용하여 여러 데이터 세트를 암호화하는 것이 좋습니다.

 [이 자동화 실행(콘솔)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSConfigRemediation-UpdateXRayKMSKey) 

**문서 유형**

자동화

**소유자**

Amazon

**플랫폼**

Linux, macOS, Windows 

**파라미터**
+ AutomationAssumeRole

  유형: 문자열

  설명: (필수) 사용자를 대신하여 Systems Manager Automation을 통해 작업을 수행할 수 있도록 허용하는 AWS Identity and Access Management (IAM) 역할의 Amazon 리소스 이름(ARN)입니다.
+ KeyId

  유형: 문자열

  설명: (필수) 데이터를 암호화하는 데 AWS X-Ray 사용할 KMS 키의 Amazon 리소스 이름(ARN), 키 ID 또는 키 별칭입니다.

**필수 IAM 권한**

실행서를 성공적으로 사용하려면 `AutomationAssumeRole` 파라미터에 다음 작업이 필요합니다.
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `kms:DescribeKey` 
+  `xray:GetEncryptionConfig` 
+  `xray:PutEncryptionConfig` 

 **문서 단계** 
+  `aws:executeAwsApi` - `KeyId` 파라미터에서 지정하는 KMS 키를 사용하여 X-Ray 데이터에 대한 암호화를 활성화할 수 있습니다.
+  `aws:waitForAwsResourceProperty` - X-Ray의 암호화 구성 상태가 `ACTIVE`가 될 때까지 기다립니다.
+  `aws:executeAwsApi` - `KeyId` 파라미터에서 지정하는 키의 ARN을 수집합니다.
+  `aws:assertAwsResourceProperty` - X-Ray에서 암호화가 활성화되었는지 확인합니다.