Registrazione delle chiamate API Amazon Neptune con AWS CloudTrail

Amazon Neptune è integrato AWS CloudTrail con, un servizio che fornisce un registro delle azioni intraprese da un utente, ruolo o AWS servizio in Neptune. CloudTrail acquisisce le chiamate API per Neptune come eventi, incluse le chiamate dalla console Neptune e le chiamate in codice alle API Neptune.

CloudTrail registra solo gli eventi per le chiamate dell'API Neptune Management, come la creazione di un'istanza o di un cluster. Per controllare le modifiche al tuo grafo, puoi utilizzare i log di audit. Per ulteriori informazioni, consulta Utilizzo dei log di audit con i cluster Amazon Neptune.

Importante

La console AWS CLI di Amazon Neptune e le chiamate API vengono registrate come chiamate effettuate all'API Amazon Relational Database Service (Amazon RDS).

Se crei un trail, puoi abilitare la distribuzione continua di CloudTrail eventi a un bucket Amazon S3, inclusi gli eventi per Neptune. 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, è possibile determinare la richiesta che è stata effettuata a Neptune, 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 per l'AWS CloudTrail utente.

Informazioni su Nettuno in CloudTrail

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

Per una registrazione continua degli eventi nel tuo AWS account, inclusi gli eventi per Neptune, 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 . 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, consultare:

• Panoramica della creazione di un trail

• CloudTrail Servizi e integrazioni supportati

• Configurazione delle notifiche Amazon SNS per CloudTrail

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

Se viene eseguita un'azione per conto del tuo AWS account utilizzando la console Neptune, l'interfaccia a riga di comando di Neptune o le API Neptune SDK, registra l'azione come chiamate effettuate all'API Amazon RDS AWS CloudTrail . Ad esempio, se utilizzi la console Neptune per modificare un'istanza DB o richiami AWS CLImodify-db-instanceil comando, AWS CloudTrail il log mostra una chiamata all'azione ModifyDBInstance dell'API Amazon RDS. Per un elenco delle azioni dell'API Neptune registrate da AWS CloudTrail, consulta il Neptune API Reference.

Nota

AWS CloudTrail registra solo gli eventi per le chiamate dell'API Neptune Management, come la creazione di un'istanza o di un cluster. Per controllare le modifiche al tuo grafo, puoi utilizzare i log di audit. Per ulteriori informazioni, consulta Utilizzo dei log di audit con i cluster Amazon Neptune.

Ogni evento o voce di registro contiene informazioni sull'utente che ha generato la richiesta. Le informazioni di identità consentono di determinare quanto segue:

• Se la richiesta è stata effettuata con le credenziali dell'utente IAM o root.

• 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 servizio. AWS

Per ulteriori informazioni, vedete l'elemento CloudTrail userIdentity.

Informazioni sulle voci dei file di log Neptune

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 un CloudTrail registro per un utente che ha creato uno snapshot di un'istanza DB e poi l'ha eliminata utilizzando la console Neptune. La console è identificata dall'elemento userAgent. Le chiamate API richieste effettuate dalla console (CreateDBSnapshot e DeleteDBInstance) si trovano nell'elemento eventName di ciascun record. Le informazioni relative all'utente (Alice) sono disponibili nell'elemento userIdentity.

{
  Records:[
  {
    "awsRegion":"us-west-2",
    "eventName":"CreateDBSnapshot",
    "eventSource":"",
    "eventTime":"2014-01-14T16:23:49Z",
    "eventVersion":"1.0",
    "sourceIPAddress":"192.0.2.01",
    "userAgent":"AWS Console, aws-sdk-java\/unknown-version Linux\/2.6.18-kaos_fleet-1108-prod.2 Java_HotSpot(TM)_64-Bit_Server_VM\/24.45-b08",
    "userIdentity":
    {
      "accessKeyId":"",
      "accountId":"123456789012",
      "arn":"arn:aws:iam::123456789012:user/Alice",
      "principalId":"AIDAI2JXM4FBZZEXAMPLE",
      "sessionContext":
      {
        "attributes":
        {
          "creationDate":"2014-01-14T15:55:59Z",
          "mfaAuthenticated":false
        }
      },
      "type":"IAMUser",
      "userName":"Alice"
    }
  },
  {
    "awsRegion":"us-west-2",
    "eventName":"DeleteDBInstance",
    "eventSource":"",
    "eventTime":"2014-01-14T16:28:27Z",
    "eventVersion":"1.0",
    "sourceIPAddress":"192.0.2.01",
    "userAgent":"AWS Console, aws-sdk-java\/unknown-version Linux\/2.6.18-kaos_fleet-1108-prod.2 Java_HotSpot(TM)_64-Bit_Server_VM\/24.45-b08",
    "userIdentity":
    {
      "accessKeyId":"",
      "accountId":"123456789012",
      "arn":"arn:aws:iam::123456789012:user/Alice",
      "principalId":"AIDAI2JXM4FBZZEXAMPLE",
      "sessionContext":
      {
        "attributes":
        {
          "creationDate":"2014-01-14T15:55:59Z",
          "mfaAuthenticated":false
        }
      },
      "type":"IAMUser",
      "userName":"Alice"
    }
  }
  ]
}