/ /

Mensagens de auditoria de eventos do sistema

Observação

System Event Audit Messages are available in MongoDB Enterprise and MongoDB Atlas.

Para saber mais sobre esse recurso no MongoDB Atlas, consulte a documentação do Atlas para Configurar auditoria de banco de dados e Exibir e baixar registros do MongoDB .

Mensagem de auditoria

A feição de auditoria de evento pode registrar eventos no formato JSON. Para configurar a saída de auditoria, consulte Configurar auditoria.

Alterado na versão 5.0.

As mensagens JSON registradas têm a seguinte sintaxe:

{
  atype: <string>,
  ts : { $date: <timestamp> },
  uuid : { $binary: <string>, $type: <string> },
  local: { ip: <string>, port: <int> || isSystemUser: <boolean> || unix: <string> },
  remote: { ip: <string>, port: <int> || isSystemUser: <boolean> || unix: <string> },
  users : [ { user: <string>, db: <string> }, ... ],
  roles: [ { role: <string>, db: <string> }, ... ],
  param: <document>,
  result: <int>
}

Campo	Tipo	Descrição
`atype`	string	Tipo de ação. Consulte Ações, detalhes e resultados de eventos de auditoria.
`ts`	documento	Documento que contém a data e hora UTC do evento, no formato ISO 8601.
`uuid`	documento	Um documento que contém um identificador de mensagem. O UUID identifica uma conexão de cliente. Use o UUID para rastrear eventos de auditoria conectados a esse cliente. O valor do campo `$type` é Tipo JSON `04` que indica que o campo `$binary` contém um UUID. Novidade na versão 5.0.
`local`	documento	Um documento que contém o endereço `ip` e o número `port` da instância em execução. A partir do MongoDB 5.0, você pode alternativamente ser um documento com um destes campos: `isSystemUser` que indica se o usuário que causou o evento era um usuário do sistema. Registrado para trabalhos autorreferenciais iniciados por um processo em segundo plano executado na mesma instância do servidor. `unix` que contém o caminho do arquivo de soquete MongoDB se o cliente se conectar por meio de um soquete de domínio Unix. Observação Starting in MongoDB 5.0, the `local` field is deprecated. Use the `localEndpoint` field in the clientMetadata audit message instead. Alterado na versão 5.0.
`remote`	documento	Um documento que contém o endereço `ip` e o número `port` da conexão de entrada associada ao evento. A partir do MongoDB 5.0, você pode alternativamente ser um documento com um destes campos: `isSystemUser` que indica se o usuário que causou o evento era um usuário do sistema. Registrado para trabalhos autorreferenciais iniciados por um processo em segundo plano executado na mesma instância do servidor. `unix` que contém o caminho do arquivo de soquete MongoDB se o cliente se conectar por meio de um soquete de domínio Unix. Alterado na versão 5.0.
`users`	array	array de documentos de identificação do usuário. Como o MongoDB permite que uma sessão faça login com um usuário diferente por banco de dados, essa array pode ter mais de um usuário. Cada documento contém um campo `user` para o nome de usuário e um campo `db` para o banco de dados de autenticação para esse usuário.
`roles`	array	Array de documentos que especificam as funções concedidas ao usuário. Cada documento contém um campo `role` para o nome da função e um campo `db` para o banco de dados associado à função.
`param`	documento	Detalhes específicos do evento. Consulte Ações, detalhes e resultados de eventos de auditoria.
`result`	inteiro	Código de erro. Consulte Ações, detalhes e resultados de eventos de auditoria.

Ações, detalhes e resultados do evento de auditoria

As seguintes listas de tabela para cada atype ou tipo de ação, os detalhes de param associados e os valores de result, se houver.

atype

param

result

authenticate

{
  user: <user name>,
  db: <database>,
  mechanism: <mechanism>
}

A partir de MongoDB 5.0, authenticate:

Está registado para tentativas de autenticação incompletas.
Inclui o nome principal e identificador no mechanism para mecanismos de autenticação externa como x.509 e Amazon Web Services Identity and Access Management (AWS-IAM) (consulte authMechanism).

Alterado na versão 5.0.

0 - Sucesso
18 - Falha na autenticação
334 - Mecanismo indisponível

authCheck

{
  command: <name>,
  ns: <database>.<collection>,
  args: <command object>
}

ns o campo é opcional.
o campo args pode ser suprimido.

Por padrão, o sistema de auditoria registra apenas as falhas de autorização. Para habilitar o sistema para registrar os sucessos de autorização, utilize o parâmetro auditAuthorizationSuccess.

Habilitar o auditAuthorizationSuccess degrada o desempenho mais do que registrar somente as falhas de autorização.

Iniciando no MongoDB 5.0, o authCheck não está registrado para ações que são geradas internamente.

Alterado na versão 5.0.

0 - Sucesso
13 - Não autorizado a executar a operação.

clientMetadata

{
   localEndpoint : {
      ip : <IP address of running instance>,
      port : <port of running instance>
   } || {
      unix : <MongoDB socket file path if connecting through
              a Unix domain socket>
   },
   clientMetadata : {
      driver : {
         name : <client driver name>,
         version : <client driver version>
      },
      os : {
         type : <client operating system type>,
         name : <client operating system name>,
         architecture : <client operating system architecture>,
         version : <client operating system version>
      },
      platform : <client platform name>,
      application : {
         name : <client application name>
      }
   }
}

Contém os metadados do cliente. Registrado quando o cliente executa o comando hello.

Dica

Dados do cliente

Novidade na versão 5.0.

0 - Sucesso

createCollection

{
   ns: <database>.<collection || view>,
   viewOn: <database>.<collection>,
   pipeline: [ <pipeline definition> ]
}

Registrado quando um:

A coleção é criada.eta
Visualizar é criado, com o nome de visualização registrado no campo ns.

A partir do MongoDB 5.0, essas informações adicionais são registradas para uma visualização:

viewOn campo com o banco de dados e a coleção para a visualização.
pipeline com a definição de aggregation pipeline para a visualização.

Alterado na versão 5.0.

0 - Sucesso

createDatabase

{ ns: <database> }

0 - Sucesso

createIndex

{
  ns: <database>.<collection>,
  indexName: <index name>,
  indexSpec: <index specification>,
  indexBuildState: <index build state>
}

Os valores possíveis para indexBuildState são:

IndexBuildStarted
IndexBuildSucceeded
IndexBuildAborted

A partir do MongoDB 5.0, createIndex eventos de auditoria são:

Registrado no início e fim da criação do índice e inclui uma mensagem indicando se o índice foi criado ou não com sucesso.
Atribuído ao usuário de origem para a ação que causou o evento de auditoria createIndex.
Registrado para um evento createCollection se a coleção tiver um índice.

Alterado na versão 5.0.

0 - Sucesso
276 - A construção de índice foi interrompida.

A mensagem de auditoria contém o código de resultado 276 para eventos de auditoria createIndex com IndexBuildState definido como IndexBuildAborted. A mensagem de auditoria contém o código de resultado 0 para eventos de auditoria createIndex com IndexBuildState definido como IndexBuildStarted ou IndexBuildSucceeded.

directAuthMutation

{
   document: {
      <collection modifications>
   },
   ns: <database>.<collection>,
   operation: <database operation>
}

Registrado quando uma operação do banco de dados modifica diretamente o conteúdo das coleções do admin.system.users ou admin.system.roles.

Novidade na versão 5.0.

0 - Sucesso

renameCollection

{
  old: <database>.<collection>,
  new: <database>.<collection>
}

0 - Sucesso

dropCollection

{
   ns: <database>.<collection || view>,
   viewOn: <database>.<collection>,
   pipeline: [ <pipeline definition> ]
}

Registrado quando um:

A coleção foi descartada.
Visualizar é descartado, com o nome de visualização registrado no campo ns.

A partir do MongoDB 5.0, essas informações adicionais são registradas para uma visualização:

viewOn campo com o banco de dados e a coleção para a visualização.
pipeline com a definição de aggregation pipeline para a visualização.

Além disso, a partir do MongoDB 5.0, um evento de auditoria dropCollection é registrado quando ocorre um evento dropDatabase.

Alterado na versão 5.0.

0 - Sucesso
26 - NamespaceNotFound

Se a coleção ou visualização não existir, a mensagem de auditoria mostrará o código de retorno como result: 26.

dropDatabase

{ ns: <database> }

0 - Sucesso

dropIndex

{
  ns: <database>.<collection>,
  indexName: <index name>
}

0 - Sucesso

createUser

{
  user: <user name>,
  db: <database>,
  customData: <document>,
  roles: [
     {
       role: <role name>,
       db: <database>
     },
     ...
  ]
}

O campo customData é opcional.

0 - Sucesso

dropUser

{
  user: <user name>,
  db: <database>
}

0 - Sucesso

dropAllUsersFromDatabase

{ db: <database> }

0 - Sucesso

getClusterParameter

{
    requestedClusterServerParameters: <parameters>
}

0 - Sucesso

setClusterParameter

{
    originalClusterServerParameter: <original parameter value>,
    updatedClusterServerParameter": <new parameter value>
}

0 - Sucesso

updateCachedClusterServerParameter

{
    originalClusterServerParameter: <original parameter value>,
    updatedClusterServerParameter": <new parameter value>
}

Registrado quando um parâmetro é alterado devido a:

Propagação de um comando setClusterParameter
Evento de replicação, como reversão
Uma atualização dos novos valores de parâmetros do cluster a partir do servidor de configuração em mongos

0 - Sucesso

updateUser

{
  user: <user name>,
  db: <database>,
  passwordChanged: <boolean>,
  customData: <document>,
  roles: [
     {
       role: <role name>,
       db: <database>
     },
     ...
  ]
}

O campo customData é opcional.

0 - Sucesso

grantRolesToUser

{
  user: <user name>,
  db: <database>,
  roles: [
     {
       role: <role name>,
       db: <database>
     },
     ...
  ]
}

0 - Sucesso

revokeRolesFromUser

{
  user: <user name>,
  db: <database>,
  roles: [
     {
       role: <role name>,
       db: <database>
     },
     ...
  ]
}

0 - Sucesso

createRole

{
  role: <role name>,
  db: <database>,
  roles: [
     {
       role: <role name>,
       db: <database>
     },
     ...
  ],
  privileges: [
    {
      resource: <resource document>,
      actions: [ <action>, ... ]
    },
    ...
  ]
}

Os campos roles e privileges são opcionais.

Para obter detalhes sobre o documento de recurso, consulte Documento de recursos em implementações autogerenciadas. Para uma lista de ações, consulte Ações de Privilégio.

0 - Sucesso

updateRole

{
  role: <role name>,
  db: <database>,
  roles: [
     {
       role: <role name>,
       db: <database>
     },
     ...
  ],
  privileges: [
    {
      resource: <resource document>,
      actions: [ <action>, ... ]
    },
    ...
  ]
}

Os campos roles e privileges são opcionais.

Para obter detalhes sobre o documento de recurso, consulte Documento de recursos em implementações autogerenciadas. Para uma lista de ações, consulte Ações de Privilégio.

0 - Sucesso

dropRole

{
  role: <role name>,
  db: <database>
}

0 - Sucesso

dropAllRolesFromDatabase

{ db: <database> }

0 - Sucesso

grantRolesToRole

{
  role: <role name>,
  db: <database>,
  roles: [
     {
       role: <role name>,
       db: <database>
     },
     ...
  ]
}

0 - Sucesso

revokeRolesFromRole

{
  role: <role name>,
  db: <database>,
  roles: [
     {
       role: <role name>,
       db: <database>
     },
     ...
  ]
}

0 - Sucesso

grantPrivilegesToRole

{
  role: <role name>,
  db: <database>,
  privileges: [
    {
      resource: <resource document>,
      actions: [ <action>, ... ]
    },
    ...
  ]
}

Para obter detalhes sobre o documento de recurso, consulte Documento de recursos em implementações autogerenciadas. Para uma lista de ações, consulte Ações de Privilégio.

0 - Sucesso

revokePrivilegesFromRole

{
  role: <role name>,
  db: <database name>,
  privileges: [
    {
      resource: <resource document>,
      actions: [ <action>, ... ]
    },
    ...
  ]
}

Para obter detalhes sobre o documento de recurso, consulte Documento de recursos em implementações autogerenciadas. Para uma lista de ações, consulte Ações de Privilégio.

0 - Sucesso

replSetReconfig

{
  old: {
   _id: <replicaSetName>,
   version: <number>,
   ...
   members: [ ... ],
   settings: { ... }
  },
  new: {
   _id: <replicaSetName>,
   version: <number>,
   ...
   members: [ ... ],
   settings: { ... }
  }
}

Para obter detalhes sobre o documento de configuração do conjunto de réplicas, consulte Configuração do conjunto de réplicas autogerenciado.

0 - Sucesso

enableSharding

{ ns: <database> }

0 - Sucesso

shardCollection

{
  ns: <database>.<collection>,
  key: <shard key pattern>,
  options: { unique: <boolean> }
}

0 - Sucesso

addShard

{
  shard: <shard name>,
  connectionString: <hostname>:<port>,
}

Quando um shard é um conjunto de réplicas, o connectionString inclui o nome do conjunto de réplicas e pode incluir outros membros do conjunto de réplicas.

0 - Sucesso

refineCollectionShardKey

{
  ns: <database>.<collection>,
  key: <shard key pattern>
}

0 - Sucesso

removeShard

{ shard: <shard name> }

0 - Sucesso

shutdown

{ }

Indica o início da desativação do banco de dados.

0 - Sucesso

applicationMessage

{ msg: <custom message string> }

Consulte logApplicationMessage.

0 - Sucesso

logout

{
  reason: <string>,
  initialUsers: [ <document>, ... ],
  updatedUsers: [ <document>, ... ],
}

reason será:

"Desconexão explícita do <database>"
"Desconexão implícita devido ao encerramento da conexão com o cliente"

initialUsers é um conjunto de documentos que contêm usuários autenticados no cliente atual antes de sair.

updatedUsers é uma array de documentos que contém usuários que devem ser autenticados no cliente atual após o evento de logout.

Cada documento em initialUsers e updatedUsers contém:

user: o nome de usuário
db: o banco de dados user é autenticado para

Novidade na versão 5.0.

0 - Sucesso

startup

{
    startupOptions: <document>,
    initialClusterServerParameter: <array of documents>
}

startupOptions contém todas as opções que o nó tem após a inicialização
initialClusterServerParameters contém os valores iniciais dos parâmetros do servidor de cluster que o nó tem no final da inicialização:
- depois de terem sido carregados do armazenamento (para mongod)
- depois de terem sido atualizados no servidor de configuração (para mongos).

Novidade na versão 5.0.

Alterado na versão 6.1.

0 - Sucesso

Voltar

Configurar filtros

Referência