Metadata-Version: 2.1
Name: unemi-audi-kafka
Version: 1.1.10
Summary: Una aplicación reutilizable de Django para auditar modelos automáticamente con integración con Kafka.
Home-page: https://github.com/marcosdaniel2002/django-audit-kafkalogger
Author: Marcos Daniel
Author-email: mteranc@unemi.edu.ec
License: MIT
Platform: UNKNOWN
Classifier: Framework :: Django
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# 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**:

   ```bash
   pip install unemi-audi-kafka

   ```

2. **Agregar la libreria en Django INSTALLED_APPS**:

   En tu `settings.py`, configura las aplicaciones:

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

   ```

3. **Agregar el MIDDLEWARE**:

   En tu `settings.py`, configura las middlewares:

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

   ```

4. **Agregar CONFIGURACIONES DE KAFKA**:

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

   ```python
   KAFKA_BROKERS_URLS = ['35.212.2.202:9092']

   ```

5. **Agregar REQUEST en el LOGIN**:

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

   ```python
   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 auditar tablas de configuracion

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

En tu `models.py`, agregar modelo manualmente:

```python
    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)
```

O tambiÃ©n podrÃ­as auditarlos en un archivo aparte para saber que modelos se encuentran allÃ­.
crear un archivo audit_config_models.py ubicado en la misma carpeta donde se encuentra el archivo settings.py

```python
   # audit_config_models.py

    # Importa los modelos que deseas auditar
    from myapp.models import MyModel1, MyModel2
    from anotherapp.models import AnotherModel

    # Define una lista con los modelos que quieres auditar
    CONFIG_MODELS = [
    MyModel1,  # Modelo 1 de la aplicaciÃ³n myapp
    MyModel2,  # Modelo 2 de la aplicaciÃ³n myapp
    AnotherModel,  # Modelo de otra aplicaciÃ³n
    ]

```

## Opcional auditar tablas de manejo de errores

Si deseas auditar errores crÃ­ticos en algÃºn punto del cÃ³digo, lo puedes hacer con la excepciÃ³n dentro de un catch.

```python
   from audit_logger import AuditLogger

    try:
        # CODIGO RIESGOSO
    except Exception as ex:
        AuditLogger.register_auditoria_errors(ex)

```


