Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

AWS Systems Manager L'automazione fornisce runbook predefiniti per. AWS X-Ray Per informazioni sull'uso dei runbook, consulta [Working with runbooks](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-documents.html). Per informazioni su come visualizzare il contenuto dei runbook, consulta. [Visualizza il contenuto del runbook](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>

 **Descrizione** 

 Il `AWSConfigRemediation-UpdateXRayKMSKey` runbook abilita la crittografia AWS X-Ray dei dati utilizzando una chiave AWS Key Management Service (AWS KMS). Questo runbook deve essere usato solo come base per garantire che AWS X-Ray i dati siano crittografati secondo le migliori pratiche di sicurezza minime consigliate. Consigliamo di crittografare più set di dati con chiavi KMS diverse. 

 [Esegui questa automazione (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSConfigRemediation-UpdateXRayKMSKey) 

**Tipo di documento**

Automazione

**Proprietario**

Amazon

**Piattaforme**

LinuxmacOS, Windows

**Parametri**
+ AutomationAssumeRole

  Tipo: String

  Descrizione: (Obbligatorio) L'Amazon Resource Name (ARN) del ruolo AWS Identity and Access Management (IAM) che consente a Systems Manager Automation di eseguire le azioni per tuo conto.
+ KeyId

  Tipo: String

  Descrizione: (Obbligatorio) L'Amazon Resource Name (ARN), l'ID della chiave o l'alias della chiave KMS che desideri utilizzare AWS X-Ray per crittografare i dati.

**Autorizzazioni IAM richieste**

Il `AutomationAssumeRole` parametro richiede le seguenti azioni per utilizzare correttamente il runbook.
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `kms:DescribeKey` 
+  `xray:GetEncryptionConfig` 
+  `xray:PutEncryptionConfig` 

 **Fasi del documento** 
+  `aws:executeAwsApi`- Abilita la crittografia dei dati X-Ray utilizzando la chiave KMS specificata nel parametro. `KeyId` 
+  `aws:waitForAwsResourceProperty`- Attende lo stato di configurazione della crittografia del sistema X-Ray. `ACTIVE` 
+  `aws:executeAwsApi`- Raccoglie l'ARN della chiave specificata nel `KeyId` parametro. 
+  `aws:assertAwsResourceProperty`- Verifica che la crittografia sia stata abilitata sul sistema X-Ray.