Configurar auditoria

Saída para syslog

Para habilitar a auditoria e imprimir eventos de auditoria no syslog (a opção não está disponível no Windows) no formato JSON, especifique syslog para a configuração do --auditDestination. Por exemplo:

mongod --dbpath data/db --auditDestination syslog

Inclua opções adicionais, conforme necessário, para sua configuração. Por exemplo, se você deseja que clientes remotos se conectem à sua implementação ou se os membros da implementação forem executados em hosts diferentes, especifique o --bind_ip.

Você também pode especificar estas opções no arquivo de configuração:

storage:
   dbPath: data/db
auditLog:
   destination: syslog

Saída para Console

Para habilitar a auditoria e imprimir os eventos de auditoria para o resultado padrão (ou seja, stdout), especifique console para a configuração --auditDestination. Por exemplo:

mongod --dbpath data/db --auditDestination console

Inclua opções adicionais, conforme necessário, para sua configuração. Por exemplo, se você deseja que clientes remotos se conectem à sua implementação ou se os membros da implementação forem executados em hosts diferentes, especifique o --bind_ip.

Você também pode especificar estas opções no arquivo de configuração:

storage:
   dbPath: data/db
auditLog:
   destination: console

Saída para Arquivo JSON

Para habilitar a auditoria e imprimir eventos de auditoria em um arquivo no formato JSON, especifique as seguintes opções:

Por exemplo, o seguinte habilita a auditoria e registra eventos de auditoria em um arquivo com o nome de caminho relativo de data/db/auditLog.json:

mongod --dbpath data/db --auditDestination file --auditFormat JSON --auditPath data/db/auditLog.json

Inclua opções adicionais, conforme necessário, para sua configuração. Por exemplo, se você deseja que clientes remotos se conectem à sua implementação ou se os membros da implementação forem executados em hosts diferentes, especifique o --bind_ip.

O arquivo de auditoria pode ser girado com o comando logRotate, junto com o log do servidor ou de forma independente. As especificações de rotação podem ser configuradas com a opção de arquivo de configuração systemLog.logRotate ou a opção de linha de comando --logRotate.

Você também pode especificar estas opções no arquivo de configuração:

storage:
   dbPath: data/db
auditLog:
   destination: file
   format: JSON
   path: data/db/auditLog.json

Saída para arquivo BSON

Para habilitar eventos de auditoria e imprimir eventos de auditoria em um arquivo no formato binário BSON, especifique as seguintes opções:

Por exemplo, o seguinte permite a auditoria e registra eventos de auditoria em um arquivo BSON com o nome do caminho relativo de data/db/auditLog.bson:

mongod --dbpath data/db --auditDestination file --auditFormat BSON --auditPath data/db/auditLog.bson

Inclua opções adicionais, conforme necessário, para sua configuração. Por exemplo, se você deseja que clientes remotos se conectem à sua implementação ou se os membros da implementação forem executados em hosts diferentes, especifique o --bind_ip.

O arquivo de auditoria é rotated ao mesmo tempo que o arquivo de log do servidor. As especificações de rotação podem ser configuradas com a opção systemLog.logRotate do arquivo de configuração ou com a opção --logRotate da linha de comando.

Você também pode especificar estas opções no arquivo de configuração:

storage:
   dbPath: data/db
auditLog:
   destination: file
   format: BSON
   path: data/db/auditLog.bson

O exemplo seguinte converte o login de auditoria em formulário legível utilizando bsondump e gera resultados:

bsondump data/db/auditLog.bson

Separação de preocupações

Antes do MongoDB 50, todos os auditórios de uma instância do MongoDB mongod ou mongos precisavam ter acesso de gravação ao sistema de arquivos do servidor host para atualizar os filtros de auditoria. O Gerenciamento de Filtros de Auditoria em tempo de execução melhora a segurança separando o acesso de auditoria do acesso administrativo.

Usar o Gerenciamento de Filtro de Auditoria em Tempo de Execução em vez de editar arquivos de configuração significa diretamente:

• O acesso ao sistema de arquivos não é necessário, portanto, um auditor não precisa acessar o servidor hostmongod ou mongos.

• Não há acesso direto ao arquivo de configuração da instância mongod ou mongos.

• O gerenciamento de filtros de auditoria em tempo de execução expõe apenas os filtros de auditoria e o parâmetro auditAuthorizationSuccess.

Configuração de tempo de execução

A partir do MongoDB 5.0, quando o Gerenciamento de filtros de auditoria em tempo de execução está ativado, a auditoria pode ser reconfigurada em tempo de execução sem reiniciar a instância mongod ou mongos. Uma instância configurada estaticamente deve ser reiniciada para atualizar suas configurações de auditoria.

As modificações do filtro de auditoria feitas no tempo de execução persistem quando uma instância é desligada e reiniciada.

Consistência

Em um cluster, se todos os nós mongod e mongos participantes estiverem configurados para usar o Gerenciamento de filtros de auditoria em tempo de execução, todos os nós usarão os mesmos filtros de auditoria. Por outro lado, se cada nó tiver seus próprios filtros de auditoria configurados localmente, não haverá garantia de consistência dos filtros de auditoria entre os nós.

Habilitar gerenciamento de filtro de auditoria em tempo de execução

A partir do MongoDB 5.0, as configurações de auditoria para nós mongod e mongos podem ser configuradas em tempo de execução.l Um grupo desses nós pode participar de uma configuração de auditoria distribuída.

Para incluir um nó em uma configuração de auditoria distribuída, atualize o arquivo de configuração do nó da seguinte maneira e reinicie o servidor.

O servidor registra um erro e falha ao iniciar se:

• runtimeConfiguration é true e

• auditLog.filter ou auditAuthorizationSuccess estiver definido.

Para modificar os filtros de auditoria e o parâmetro auditAuthorizationSuccess no tempo de execução, consulte setAuditConfig.