

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à.

# Lavorare conAWS CloudTrailandAWS CloudHSM
<a name="get-api-logs-using-cloudtrail"></a>

AWS CloudHSMè integrato conAWS CloudTrail, un servizio che fornisce una registrazione delle azioni intraprese da un utente, un ruolo o un AWS servizio inAWS CloudHSM. CloudTrail acquisisce tutte le chiamate API AWS CloudHSM come eventi. Le chiamate acquisite includono chiamate dalla AWS CloudHSM console e chiamate di codice alle operazioni AWS CloudHSM API. Se crei un trail, puoi abilitare la distribuzione continua di CloudTrail eventi a un bucket Amazon S3, inclusi gli eventi per. AWS CloudHSM Se non configuri un percorso, puoi comunque visualizzare gli eventi più recenti nella CloudTrail console nella cronologia degli **eventi**. Utilizzando le informazioni raccolte da CloudTrail, puoi determinare a quale richiesta è stata inviataAWS CloudHSM, l'indirizzo IP da cui è stata effettuata la richiesta, chi ha effettuato la richiesta, quando è stata effettuata e dettagli aggiuntivi. 

Per ulteriori informazioni CloudTrail, consulta la [Guida AWS CloudTrail per l'utente](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). Per un elenco completo delle operazioni AWS CloudHSM API, consulta [Azioni](https://docs.aws.amazon.com/cloudhsm/latest/APIReference/API_Operations.html) nel *riferimento AWS CloudHSM API*.

## AWS CloudHSMinformazioni in CloudTrail
<a name="service-name-info-in-cloudtrail"></a>

CloudTrail è abilitato sul tuo AWS account al momento della creazione dell'account. Quando si verifica un'attività inAWS CloudHSM, tale attività viene registrata in un CloudTrail evento insieme ad altri eventi AWS di servizio nella **cronologia degli eventi**. È possibile visualizzare, cercare e scaricare gli eventi recenti nell'account AWS. Per ulteriori informazioni, vedere [Visualizzazione degli eventi con la cronologia degli CloudTrail eventi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/view-cloudtrail-events.html). 

Per una registrazione continua degli eventi nel tuo AWS account, inclusi gli eventi diAWS CloudHSM, crea un percorso. Un *trail* consente di CloudTrail inviare file di log a un bucket Amazon S3. Per impostazione predefinita, quando si crea un trail nella console, il trail sarà valido in tutte le regioni AWS. Il trail registra gli eventi di tutte le regioni della AWS partizione e consegna i file di log al bucket Amazon S3 specificato. Inoltre, puoi configurare altri AWS servizi per analizzare ulteriormente e agire in base ai dati sugli eventi raccolti nei log. CloudTrail Per ulteriori informazioni, consulta gli argomenti seguenti: 
+ [Panoramica della creazione di un trail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-and-update-a-trail.html)
+ [CloudTrail Servizi e integrazioni supportati](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html#cloudtrail-aws-service-specific-topics-integrations)
+ [Configurazione delle notifiche Amazon SNS per CloudTrail](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/getting_notifications_top_level.html)
+ [Ricezione di file di CloudTrail registro da più regioni](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/receive-cloudtrail-log-files-from-multiple-regions.html) e [ricezione di file di CloudTrail registro da](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-receive-logs-from-multiple-accounts.html) più account

CloudTrail registra tutte le AWS CloudHSM operazioni, incluse le operazioni di sola lettura, come `DescribeClusters` e`ListTags`, e le operazioni di gestione, ad esempio, e. `InitializeCluster` `CreatHsm` `DeleteBackup`

Ogni evento o voce di log contiene informazioni sull’utente che ha generato la richiesta. Le informazioni di identità consentono di determinare quanto segue: 
+ Se la richiesta è stata effettuata con credenziali utente root o AWS Identity and Access Management (IAM).
+ Se la richiesta è stata effettuata con le credenziali di sicurezza temporanee per un ruolo o un utente federato.
+ Se la richiesta è stata effettuata da un altro AWS servizio.

Per ulteriori informazioni, consulta [Elemento CloudTrail userIdentity](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-event-reference-user-identity.html).

## ComprensioneAWS CloudHSMvoci del file di log
<a name="understanding-service-name-entries"></a>

Un trail è una configurazione che consente la distribuzione di eventi come file di log in un bucket Amazon S3 specificato dall'utente. CloudTrail i file di registro contengono una o più voci di registro. Un evento rappresenta una singola richiesta proveniente da qualsiasi fonte e include informazioni sull'azione richiesta, la data e l'ora dell'azione, i parametri della richiesta e così via. CloudTrail i file di registro non sono una traccia ordinata dello stack delle chiamate API pubbliche, quindi non vengono visualizzati in un ordine specifico. 

L'esempio seguente mostra una voce di CloudTrail registro che illustra l'AWS CloudHSM`CreateHsm`azione.

```
{
    "eventVersion": "1.05",
    "userIdentity": {
        "type": "AssumedRole",
        "principalId": "AROAJZVM5NEGZSTCITAMM:ExampleSession",
        "arn": "arn:aws:sts::111122223333:assumed-role/AdminRole/ExampleSession",
        "accountId": "111122223333",
        "accessKeyId": "ASIAIY22AX6VRYNBGJSA",
        "sessionContext": {
            "attributes": {
                "mfaAuthenticated": "false",
                "creationDate": "2017-07-11T03:48:44Z"
            },
            "sessionIssuer": {
                "type": "Role",
                "principalId": "AROAJZVM5NEGZSTCITAMM",
                "arn": "arn:aws:iam::111122223333:role/AdminRole",
                "accountId": "111122223333",
                "userName": "AdminRole"
            }
        }
    },
    "eventTime": "2017-07-11T03:50:45Z",
    "eventSource": "cloudhsm.amazonaws.com",
    "eventName": "CreateHsm",
    "awsRegion": "us-west-2",
    "sourceIPAddress": "205.251.233.179",
    "userAgent": "aws-internal/3",
    "requestParameters": {
        "availabilityZone": "us-west-2b",
        "clusterId": "cluster-fw7mh6mayb5"
    },
    "responseElements": {
        "hsm": {
            "eniId": "eni-65338b5a",
            "clusterId": "cluster-fw7mh6mayb5",
            "state": "CREATE_IN_PROGRESS",
            "eniIp": "10.0.2.7",
            "hsmId": "hsm-6lz2hfmnzbx",
            "subnetId": "subnet-02c28c4b",
            "availabilityZone": "us-west-2b"
        }
    },
    "requestID": "1dae0370-65ec-11e7-a770-6578d63de907",
    "eventID": "b73a5617-8508-4c3d-900d-aa8ac9b31d08",
    "eventType": "AwsApiCall",
    "recipientAccountId": "111122223333"
}
```

## AWS CloudHSMeventi di gestione in CloudTrail
<a name="cloudtrail-management-events"></a>

[Gli eventi](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events) di gestione forniscono informazioni sulle operazioni di gestione eseguite sulle risorse dell'aziendaAccount AWS. Queste operazioni sono definite anche operazioni del piano di controllo (control-plane). Per impostazione predefinita, CloudTrail registra gli eventi di gestione.

AWS CloudHSMregistra tutte le operazioni del piano di controllo come eventi di gestione. Per un elenco delle operazioni del piano di AWS CloudHSM controllo a cui si AWS CloudHSM effettua l'accesso CloudTrail, vedere [Azioni](https://docs.aws.amazon.com/cloudhsm/latest/APIReference/API_Operations.html) nell'*AWS CloudHSMAPI* Reference.

## AWS CloudHSMeventi di servizio in CloudTrail
<a name="cloudtrail-service-events"></a>

AWS CloudHSMregistra gli eventi di servizio CloudTrail quando il servizio esegue automaticamente azioni sulle risorse. Questi eventi non possono essere attivati direttamente da una chiamata a un'API pubblicaAWS CloudHSM. Per questi eventi, il campo `eventType` è `AwsServiceEvent`.

Di seguito sono riportati gli eventi di servizio a cui viene effettuato l'AWS CloudHSMaccesso. CloudTrail
+ `DeleteBackup`— Registrato quando elimina AWS CloudHSM automaticamente un backup in base alla politica di conservazione dei backup.
+ `BackupDeletedPermanently`— Registrato quando un backup PENDING\_DELETION viene eliminato definitivamente e non può più essere ripristinato.
+ `MigrationStart`— Registrato quando inizia una migrazione di tipo HSM per un cluster.
+ `MigrationEnd`— Registrato quando viene completata una migrazione di tipo HSM per un cluster.
+ `RollbackStart`— Registrato quando inizia un rollback di migrazione di tipo HSM per un cluster.
+ `RollbackEnd`— Registrato quando viene completato un rollback di migrazione di tipo HSM per un cluster.

È possibile identificare gli eventi AWS CloudHSM di servizio nei CloudTrail registri in base ai seguenti valori di attributo:
+ `eventSource`: `cloudhsm.amazonaws.com`
+ `eventType`: `AwsServiceEvent`