Utilizzo AWS CloudTrail per registrare WorkDocs API le chiamate Amazon

Puoi usare AWS CloudTrail; per registrare WorkDocs API le chiamate Amazon. CloudTrail fornisce un registro delle azioni intraprese da un utente, un ruolo o un AWS servizio in Amazon WorkDocs. CloudTrail acquisisce tutte le API chiamate per Amazon WorkDocs come eventi, incluse le chiamate dalla WorkDocs console Amazon e le chiamate in codice verso Amazon WorkDocs APIs.

Se crei un trail, puoi abilitare la distribuzione continua di CloudTrail eventi a un bucket Amazon S3, inclusi gli eventi per Amazon. WorkDocs Se non crei un percorso, puoi comunque visualizzare gli eventi più recenti nella CloudTrail console nella cronologia degli eventi.

Le informazioni raccolte da CloudTrail includono le richieste, gli indirizzi IP da cui sono state effettuate le richieste, gli utenti che hanno effettuato le richieste e le date della richiesta.

Per ulteriori informazioni in merito CloudTrail, consulta la Guida AWS CloudTrail per l'utente.

WorkDocs Informazioni su Amazon in CloudTrail

CloudTrail è abilitato sul tuo AWS account al momento della creazione dell'account. Quando si verifica un'attività in Amazon WorkDocs, tale attività viene registrata in un CloudTrail evento insieme ad altri eventi AWS di servizio nella cronologia degli eventi. Puoi visualizzare, cercare e scaricare gli eventi recenti nel tuo AWS account. Per ulteriori informazioni, consulta Visualizzazione degli eventi con cronologia degli CloudTrail eventi.

Per una registrazione continua degli eventi nel tuo AWS account, inclusi gli eventi per Amazon WorkDocs, crea un percorso. Un trail consente di CloudTrail inviare file di log a un bucket Amazon S3. Per impostazione predefinita, quando crei un trail nella console, il trail sarà valido in tutte le regioni. Il trail registra gli eventi da 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, consultare:

• Panoramica della creazione di un percorso

• CloudTrail servizi e integrazioni supportati

• Configurazione delle SNS notifiche Amazon per CloudTrail

• Ricezione di file di CloudTrail registro da più regioni e ricezione di file di CloudTrail registro da più account

Tutte le WorkDocs azioni di Amazon vengono registrate CloudTrail e documentate in Amazon WorkDocs API Reference. Ad esempio, le chiamate alle CreateFolder UpdateDocument sezioni DeactivateUser e generano voci nei file di CloudTrail registro.

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 root o IAM utente.

• 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, vedete l'CloudTrail userIdentityelemento.

Comprendere le voci dei file di WorkDocs log di Amazon

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 API chiamate pubbliche, quindi non vengono visualizzati in un ordine specifico.

Amazon WorkDocs genera diversi tipi di CloudTrail voci, quelle dal piano di controllo e quelle dal piano dati. La differenza importante tra i due è che l'identità utente per le voci del piano di controllo è un IAM utente. L'identità utente per le voci del piano dati è l'utente della WorkDocs directory Amazon.

Nota

Per una maggiore sicurezza, crea utenti federati anziché IAM utenti quando possibile.

Le informazioni sensibili, ad esempio le password, i token di autenticazione, i commenti e i contenuti dei file, vengono incluse nelle voci di log. Questi vengono visualizzati come HIDDEN _ DUE _TO_ SECURITY _ REASONS nei log. CloudTrail Questi vengono visualizzati come HIDDEN _ DUE SECURITY _TO_ _ nei log. REASONS CloudTrail

L'esempio seguente mostra due voci di CloudTrail registro per Amazon WorkDocs: il primo record è per un'azione del piano di controllo e il secondo è per un'azione del piano dati.

{
  Records : [
    {
      "eventVersion" : "1.01",
      "userIdentity" :
      {
        "type" : "IAMUser",
        "principalId" : "user_id",
        "arn" : "user_arn",
        "accountId" : "account_id",
        "accessKeyId" : "access_key_id",
        "userName" : "user_name"
      },
      "eventTime" : "event_time",
      "eventSource" : "workdocs.amazonaws.com",
      "eventName" : "RemoveUserFromGroup",
      "awsRegion" : "region",
      "sourceIPAddress" : "ip_address",
      "userAgent" : "user_agent",
      "requestParameters" :
      {
        "directoryId" : "directory_id",
        "userSid" : "user_sid",
        "group" : "group"
      },
      "responseElements" : null,
      "requestID" : "request_id",
      "eventID" : "event_id"
    },
    {
      "eventVersion" : "1.01",
      "userIdentity" :
      {
        "type" : "Unknown",
        "principalId" : "user_id",
        "accountId" : "account_id",
        "userName" : "user_name"
      },
      "eventTime" : "event_time",
      "eventSource" : "workdocs.amazonaws.com",      
      "awsRegion" : "region",
      "sourceIPAddress" : "ip_address",
      "userAgent" : "user_agent",
      "requestParameters" :
      {
        "AuthenticationToken" : "**-redacted-**"
      },
      "responseElements" : null,
      "requestID" : "request_id",
      "eventID" : "event_id"
    }
  ]
}