Registro de chamadas de API do Amazon Neptune com AWS CloudTrail

O Amazon Neptune é integrado AWS CloudTrail com, um serviço que fornece um registro das ações realizadas por um usuário, função ou AWS serviço no Neptune. CloudTrail captura chamadas de API para o Neptune como eventos, incluindo chamadas do console do Neptune e de chamadas de código para as APIs do Neptune.

CloudTrail registra somente eventos para chamadas da API Neptune Management, como a criação de uma instância ou cluster. Se quiser auditar as alterações em seu gráfico, você poderá usar os logs de auditoria. Para ter mais informações, consulte Usar logs de auditoria com clusters do Amazon Neptune.

Importante

As chamadas de console AWS CLI e API do Amazon Neptune são registradas como chamadas feitas para a API do Amazon Relational Database Service (Amazon RDS).

Se você criar uma trilha, poderá habilitar a entrega contínua de CloudTrail eventos para um bucket do Amazon S3, incluindo eventos para o Neptune. Se você não configurar uma trilha, ainda poderá ver os eventos mais recentes no CloudTrail console no Histórico de eventos. Usando as informações coletadas por CloudTrail, você pode determinar a solicitação que foi feita ao Neptune, o endereço IP do qual a solicitação foi feita, quem fez a solicitação, quando ela foi feita e detalhes adicionais.

Para saber mais sobre isso CloudTrail, consulte o Guia AWS CloudTrail do usuário.

Informações sobre Netuno em CloudTrail

CloudTrail é ativado em sua AWS conta quando você cria a conta. Quando a atividade ocorre no Amazon Neptune, essa atividade é registrada em CloudTrail um evento junto com AWS outros eventos de serviço no histórico de eventos. Você pode visualizar, pesquisar e baixar eventos recentes em sua AWS conta. Para obter mais informações, consulte Visualização de eventos com histórico de CloudTrail eventos.

Para um registro contínuo dos eventos em sua AWS conta, incluindo eventos de Neptune, crie uma trilha. Uma trilha permite CloudTrail entregar arquivos de log para um bucket do Amazon S3. Por padrão, ao criar uma trilha no console, a mesma é aplicada a todas as Regiões. A trilha registra eventos de todas as regiões na AWS partição e entrega os arquivos de log ao bucket do Amazon S3 que você especificar. Além disso, você pode configurar outros AWS serviços para analisar e agir com base nos dados de eventos coletados nos CloudTrail registros. Para obter mais informações, consulte:

• Visão geral da criação de uma trilha

• CloudTrail Serviços e integrações compatíveis

• Configurando notificações do Amazon SNS para CloudTrail

• Recebendo arquivos de CloudTrail log de várias regiões e recebendo arquivos de CloudTrail log de várias contas

Se uma ação for tomada em nome da sua AWS conta usando o console do Neptune, a interface da linha de comando do Neptune ou as APIs do SDK do Neptune, registrará a ação como chamadas feitas para a API AWS CloudTrail do Amazon RDS. Por exemplo, se você usa o console do Neptune para modificar uma instância de banco de dados ou chamar o comando modify-db-instance, AWS CLIoAWS CloudTrail log mostra uma chamada para a ação ModifyDBInstance da API do Amazon RDS. Para obter uma lista das ações da API Neptune registradas AWS CloudTrail, consulte a Referência da API Neptune.

nota

AWS CloudTrail registra somente eventos para chamadas da API Neptune Management, como a criação de uma instância ou cluster. Se quiser auditar as alterações em seu gráfico, você poderá usar os logs de auditoria. Para ter mais informações, consulte Usar logs de auditoria com clusters do Amazon Neptune.

Cada entrada de log ou evento contém informações sobre quem gerou a solicitação. As informações de identidade ajudam a determinar:

• Se a solicitação foi feita com credenciais de usuário raiz ou usuário do IAM.

• Se a solicitação foi feita com credenciais de segurança temporárias para um perfil ou usuário federado.

• Se a solicitação foi feita por outro AWS serviço.

Para obter mais informações, consulte o elemento CloudTrail UserIdentity.

Noções básicas das entradas dos arquivos de log do Neptune

Uma trilha é uma configuração que permite a entrega de eventos como arquivos de log para um bucket do Amazon S3 que você especificar. CloudTrail os arquivos de log contêm uma ou mais entradas de log. Um evento representa uma única solicitação de qualquer fonte e inclui informações sobre a ação solicitada, a data e a hora da ação, os parâmetros da solicitação e assim por diante. CloudTrail os arquivos de log não são um rastreamento de pilha ordenado das chamadas públicas de API, portanto, eles não aparecem em nenhuma ordem específica.

O exemplo a seguir mostra um CloudTrail registro de um usuário que criou um snapshot de uma instância de banco de dados e depois excluiu essa instância usando o console Neptune. O console é identificado pelo elemento userAgent. As chamadas de API solicitadas feitas pelo console (CreateDBSnapshot e DeleteDBInstance) são encontradas no elemento eventName para cada registro. Informações sobre o usuário (Alice) podem ser encontradas no 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"
    }
  }
  ]
}