Documentacion KSIDol > Modulos KSIDol > Notificación de inicio de sesión

Guia del modulo: Notificación de inicio de sesión

Guía de uso no técnica: para qué sirve el módulo, cómo utilizarlo y cómo se articula con Dolibarr.

ActivaciónEn cada inicio de sesión correcto

Contenido del correoIdentidad, fecha/hora, IP, instancia

Modos de envío3 (PHP mail, Dolibarr, SMTP)

Núcleo de Dolibarr0 modificaciones

1. Descripcion del modulo

El módulo Notificación de inicio de sesión (loginnotify) supervisa los accesos a su Dolibarr: cada vez que un usuario inicia sesión correctamente, usted recibe automáticamente un correo de alerta. Es una herramienta de seguimiento sencilla, especialmente útil para vigilar quién entra en una instancia de demostración o de producción, sin necesidad de consultar ningún registro técnico. El módulo se mantiene deliberadamente ligero y discreto: nunca modifica el núcleo de Dolibarr y se apoya en el mecanismo estándar de los disparadores (triggers). No añade ningún menú, ninguna sección nueva ni ninguna pantalla adicional al trabajo diario: una vez activado y configurado por un administrador, funciona solo en segundo plano.

Reciba un correo automático en cada inicio de sesión de un usuario en su instancia de Dolibarr
Ideal para supervisar sin esfuerzo los accesos de una demo o de una producción
Funciona en segundo plano, sin cambiar los hábitos de los usuarios
Ninguna modificación del núcleo de Dolibarr: instalación limpia y reversible
Configuración centralizada en una única página reservada a los administradores

2. Notificación automática en cada inicio de sesión

Es la función central del módulo. En cuanto un usuario abre una sesión en Dolibarr, el módulo se activa y prepara el envío de un correo de alerta a la dirección que usted haya elegido.

La alerta se activa en cada inicio de sesión correcto, sea cual sea el usuario implicado
La activación es totalmente automática: el usuario que inicia sesión no tiene que hacer nada
Un interruptor general permite activar o suspender el envío de correos en cualquier momento
Si el módulo está desactivado o el envío cortado, el inicio de sesión se desarrolla normalmente sin correo

3. Contenido del correo de notificación

Cada correo recibido resume lo esencial del inicio de sesión, con claridad, para permitirle identificar de inmediato quién se ha conectado, cuándo y desde dónde.

El asunto indica el inicio de sesión y el identificador del usuario implicado
La identidad del usuario: su identificador de conexión y su nombre completo
La fecha y la hora exactas del inicio de sesión
La dirección IP desde la que se ha realizado el inicio de sesión
La dirección (URL) de la instancia de Dolibarr afectada, útil si supervisa varias instancias

4. Elección de la dirección de recepción

Usted decide libremente quién recibe las alertas de inicio de sesión. La dirección se configura en la página de configuración del módulo.

Introducción de una o varias direcciones de correo de destino (separadas por una coma; el punto y coma solo se admite plenamente en modo SMTP manual)
La página de configuración rellena previamente el campo del destinatario con el correo de la empresa definido en Dolibarr; en el momento de la ejecución, si no hay ninguna dirección de destino guardada, no se envía ningún correo
Sin una dirección válida, no se envía ningún correo (el inicio de sesión, en cambio, sigue siendo normal)

5. Elección del modo de envío del correo

Según su alojamiento y su configuración de correo, usted elige la manera en que se envían los correos. Se proponen tres modos para adaptarse a la mayoría de las situaciones.

Modo PHP mail(): envío directo mediante la función de correo del servidor, el más sencillo
Modo configuración Dolibarr: reutiliza los ajustes de correo ya configurados en su Dolibarr
Modo SMTP manual: usted introduce sus propios parámetros de servidor de envío (host, puerto, identificador, contraseña, seguridad TLS/SSL, modo de autenticación)
Se puede definir una dirección de remitente personalizada; se utiliza sea cual sea el modo de envío
Recuperación automática: si el envío directo falla o no está disponible, el módulo cambia a la configuración de correo de Dolibarr para maximizar las posibilidades de entrega

6. Envío de un correo de prueba

Para comprobar que todo está correctamente configurado antes de confiar en las alertas, la página de configuración ofrece un botón de prueba.

Un botón envía inmediatamente un correo de prueba a la dirección de recepción indicada
Se muestra un mensaje de confirmación en caso de éxito, o un mensaje de error si el envío falla
Una advertencia avisa cuando Dolibarr está configurado para redirigir todos los correos a una dirección impuesta, con el fin de evitar cualquier confusión sobre el destinatario real

7. Registro de los errores

Para facilitar el diagnóstico si un correo no sale, el módulo puede consignar los incidentes de envío en el registro de Dolibarr.

Opción activable para registrar los errores de envío en los registros técnicos de Dolibarr
Ayuda al administrador o al proveedor a comprender un problema de correo sin bloquear el uso
Las alertas de recuperación (cambio de un modo de envío a otro) también se anotan en ellos

8. Configuración y adaptación del módulo

Todos los ajustes se agrupan en una única página de configuración, accesible únicamente para los administradores desde la lista de módulos. No se solicita ningún ajuste a los usuarios.

Activar o desactivar el envío de los correos de inicio de sesión
Definir la o las direcciones de recepción de las alertas
Elegir el modo de envío (PHP mail, configuración Dolibarr o SMTP manual) y, en su caso, el remitente
Indicar los parámetros SMTP en modo manual (host, puerto, identificador, contraseña, seguridad, autenticación)
Activar el registro de los errores
Probar el envío y guardar la configuración

9. Vinculos con Dolibarr

El modulo no funciona de forma aislada: se integra con los bloques nativos de Dolibarr.

Usuarios de Dolibarr : El módulo se apoya en el evento nativo de inicio de sesión de las cuentas de usuario de Dolibarr. El correo recoge el identificador y el nombre completo de la persona que acaba de conectarse, tal como están registrados en su ficha de usuario.
Sistema de correo de Dolibarr : El modo de envío Dolibarr reutiliza la configuración de correo ya establecida en su instancia (el mismo motor de envío que los demás correos de Dolibarr). Este modo sirve también como solución de recuperación automática si el envío directo falla.
Ficha de la empresa (parámetros generales) : A falta de una dirección de recepción o de un remitente personalizado, el módulo recoge automáticamente la dirección de correo de la empresa definida en los parámetros generales de Dolibarr, para mantener la coherencia con el resto de la aplicación.
Registros técnicos de Dolibarr : Cuando el registro está activado, los errores y los cambios de envío se escriben en los registros (syslog) nativos de Dolibarr, lo que permite diagnosticar un problema de correo mediante las herramientas estándar del ERP.
Preferencias de envío de correos (redirección) : El módulo respeta el ajuste de Dolibarr que fuerza la redirección de todos los correos a una única dirección: avisa al administrador en la página de configuración para evitar cualquier confusión sobre el destinatario real de las alertas.