unemi-audi-kafka 1.0.3

Una aplicación reutilizable de Django para auditar modelos automáticamente con integración con Kafka.

Unemi Audit Kafka

unemi-audi-kafka es una aplicacion reutilizable de Django que audita automaticamente los cambios en los modelos (creacion, actualizacion, eliminacion) en todos los modelos de tu proyecto Django. Se integra con Kafka para el envio de logs y permite una auditoria configurable para los modelos importantes. La aplicacion captura metadatos utiles como el usuario que realizo los cambios, la IP de la solicitud, la URL y mas.

Caracteristicas

• Auditoria Automatica: Registra automaticamente todos los modelos de Django para el registro de auditoria.
• Integracion con Kafka: Utiliza confluent_kafka para enviar los registros de auditoria a los temas de Kafka.
• Auditoria de Configuracion: Registra manualmente modelos importantes para la auditoria de configuracion.
• Middleware de Contexto de Usuario: Captura informacion sobre el usuario, la IP de la solicitud y el agente de usuario a traves de middleware.
• Personalizable: Puedes extender o sobrescribir middleware, y controlar el comportamiento del productor de Kafka.

Instalacion

1. INSTALAR la libreria usando pip:

   pip install unemi-audi-kafka
   

2. Agregar la libreria en Django INSTALLED_APPS:

   En tu settings.py, configura las aplicaciones:

   INSTALLED_APPS = [
      # Other installed apps
      'audit_logger',
   ]
   

3. Agregar el MIDDLEWARE:

   En tu settings.py, configura las middlewares:

   MIDDLEWARE = [
      # Other middlewares
      'audit_logger.middlewares.AuditUserMiddleware',
   ]
   

4. Agregar CONFIGURACIONES DE KAFKA:

   En tu settings.py, configurar los Kafka broker y topics:

   KAFKA_BROKER_URL = '35.212.2.202:9092'  # Replace with your Kafka broker URL
   KAFKA_TOPIC_LOGS = 'audit_logs'      # Topic for log auditing
   KAFKA_TOPIC_ERRORS = 'audit_errors'  # Topic for error logging
   KAFKA_TOPIC_CONFIG = 'audit_config'  # Topic for configuration auditing
   

5. Agregar REQUEST en el LOGIN:

   En tu decorators_helper.py, agregar en la funcion de login_required:

   from audit_logger.middlewares import set_current_request
   
   def login_required(f):
      def new_f(view, request):
        # code for decoded token
        set_current_request(request)
        return f(view, request)
   

Opcional

Si deseas guardar las configuraciones de tu aplicacion, la puedes separar de los otras tablas con:

En tu models.py, agregar modelo manualmente:

from audit_logger import AuditLogger

 class Configuracion(ModelBase):
 nombre = models.CharField(unique=True, max_length=100, verbose_name=u'Nombre')

# Registrar Configuracion
AuditLogger.register_auditoria_config(Configuracion)