Configurar la auditoría

Salida a Syslog

Para habilitar la auditoría e imprimir los eventos de auditoría en syslog (opción no disponible en Windows) en formato JSON, especifica syslog para la configuración de --auditDestination. Por ejemplo:

mongod --dbpath data/db --auditDestination syslog

Incluir opciones adicionales según sea necesario para la configuración. Por ejemplo, si se desea que los clientes remotos se conecten a su implementación o si los miembros de su implementación se ejecutan en hosts diferentes, especificar el --bind_ip.

También puedes especificar estas opciones en el archivo de configuración:

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

Salida a consola

Para habilitar la auditoría y imprimir los eventos de auditoría en la salida estándar (es decir, stdout), especifica console para el ajuste --auditDestination. Por ejemplo:

mongod --dbpath data/db --auditDestination console

Incluir opciones adicionales según sea necesario para la configuración. Por ejemplo, si se desea que los clientes remotos se conecten a su implementación o si los miembros de su implementación se ejecutan en hosts diferentes, especificar el --bind_ip.

También puedes especificar estas opciones en el archivo de configuración:

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

Exportar a archivo JSON

Para habilitar la auditoría y registrar los eventos de auditoría en un archivo formato JSON, especifique las siguientes opciones:

Por ejemplo, lo siguiente habilita la auditoría y registra los eventos de auditoría en un archivo con el nombre de ruta relativa de data/db/auditLog.json:

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

Incluir opciones adicionales según sea necesario para la configuración. Por ejemplo, si se desea que los clientes remotos se conecten a su implementación o si los miembros de su implementación se ejecutan en hosts diferentes, especificar el --bind_ip.

El archivo de auditoría puede rotarse con el comando logRotate, ya sea junto con el registro del servidor o de forma independiente. Las especificidades de la rotación pueden configurarse con la opción del archivo de configuración systemLog.logRotate o la opción de línea de comandos --logRotate.

También puedes especificar estas opciones en el archivo de configuración:

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

Salida a un archivo BSON

Para habilitar la auditoría y enviar los eventos de auditoría a un archivo en formato binario BSON, especifica las siguientes opciones:

Por ejemplo, lo siguiente habilita la auditoría y registra los eventos de auditoría en un archivo BSON con el nombre de ruta relativa de data/db/auditLog.bson:

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

Incluir opciones adicionales según sea necesario para la configuración. Por ejemplo, si se desea que los clientes remotos se conecten a su implementación o si los miembros de su implementación se ejecutan en hosts diferentes, especificar el --bind_ip.

El archivo de auditoría es rotated al mismo tiempo que la entrada de registro del servidor. Los detalles de la rotación pueden configurarse con la opción de archivo de configuración systemLog.logRotate o la opción de línea de comandos --logRotate.

También puedes especificar estas opciones en el archivo de configuración:

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

El siguiente ejemplo convierte el registro de auditoría en una forma legible utilizando bsondump y produce el resultado:

bsondump data/db/auditLog.bson

Separación de responsabilidades

Antes de MongoDB 5.0, cualquier persona que auditara una instancia de MongoDB mongod o mongos tenía que poseer acceso de escritura al sistema de archivos del servidor host para poder actualizar los filtros de auditoría. La gestión de filtros de auditoría en tiempo de ejecución mejora la seguridad al separar el acceso a la auditoría del acceso administrativo.

Utilizar la gestión de filtros de auditoría en tiempo de ejecución en lugar de editar directamente los archivos de configuración significa:

• No se requiere acceso al sistema de archivos, por lo que un auditor no necesita acceso al servidor host mongod ni al mongos.

• No hay acceso directo al archivo de configuración de la instancia mongod o mongos.

• La Gestión del Filtro de Auditoría en Tiempo de Ejecución solo expone filtros de auditoría y el parámetro auditAuthorizationSuccess.

Configurabilidad en tiempo de ejecución

A partir de MongoDB 5.0, cuando la gestión de filtros de auditoría en tiempo de ejecución está habilitada, la auditoría puede reconfigurarse en tiempo de ejecución sin reiniciar la mongod o la instancia de mongos. Una instancia configurada estáticamente debe reiniciarse para actualizar su configuración de auditoría.

Las modificaciones del filtro de auditoría realizadas en tiempo de ejecución se mantienen cuando una instancia se apaga y reinicia.

coherencia

Dentro de un clúster, si todos los mongod y mongos nodos participantes están configurados para usar la Gestión de Filtros de Auditoría en Tiempo de Ejecución, entonces todos los nodos usarán los mismos filtros de auditoría. En contraste, si cada nodo tiene sus propios filtros de auditoría configurados localmente, no hay garantía de coherencia de filtros de auditoría entre nodos.

Activar la gestión de filtros de auditoría en tiempo de ejecución

A partir de MongoDB 5.0, las configuraciones de auditoría para los nodos mongod y mongos pueden configurarse en tiempo de ejecución. Un grupo de estos nodos puede participar en una configuración de auditoría distribuida.

Para incluir un nodo en una configuración de auditoría distribuida, se debe actualizar el archivo de configuración del nodo de la siguiente manera y reiniciar el servidor.

El servidor registra un error y no puede iniciarse si:

• runtimeConfiguration es true y

• O bien auditLog.filter o auditAuthorizationSuccess está establecido.

Para modificar los filtros de auditoría y el parámetro auditAuthorizationSuccess en tiempo de ejecución, consultar setAuditConfig.