Documentazione KSIDol > Moduli KSIDol > Notifica di accesso

Guida del modulo: Notifica di accesso

Guida all'uso non tecnica: a cosa serve il modulo, come utilizzarlo e come si integra con Dolibarr.

AttivazioneA ogni accesso riuscito

Contenuto dell'emailIdentità, data/ora, IP, istanza

Modalità di invio3 (PHP mail, Dolibarr, SMTP)

Core di Dolibarr0 modifiche

1. Panoramica del modulo

Il modulo Notifica di accesso (loginnotify) sorveglia gli accessi al vostro Dolibarr: ogni volta che un utente accede con successo, ricevete automaticamente un'email di avviso. È uno strumento di monitoraggio semplice, particolarmente utile per tenere d'occhio chi entra in un'istanza di dimostrazione o di produzione, senza dover consultare alcun registro tecnico. Il modulo resta volutamente leggero e discreto: non modifica mai il core di Dolibarr e si basa sul meccanismo standard dei trigger (attivatori). Non aggiunge né menu, né nuove sezioni, né schermate supplementari al lavoro quotidiano: una volta attivato e impostato da un amministratore, funziona da solo in background.

Ricevete un'email automatica a ogni accesso di un utente alla vostra istanza Dolibarr
Ideale per sorvegliare senza sforzo gli accessi di una demo o di una produzione
Funziona in background, senza cambiare le abitudini degli utenti
Nessuna modifica al core di Dolibarr: installazione pulita e reversibile
Impostazione centralizzata su un'unica pagina di configurazione riservata agli amministratori

2. Notifica automatica a ogni accesso

È la funzione centrale del modulo. Non appena un utente apre una sessione in Dolibarr, il modulo si attiva e prepara l'invio di un'email di avviso all'indirizzo che avete scelto.

L'avviso si attiva a ogni accesso riuscito, qualunque sia l'utente interessato
L'attivazione è del tutto automatica: nulla da fare per l'utente che accede
Un interruttore generale permette di attivare o sospendere l'invio delle email in qualsiasi momento
Se il modulo è disattivato o l'invio è interrotto, l'accesso si svolge normalmente senza email

3. Contenuto dell'email di notifica

Ogni email ricevuta riassume l'essenziale dell'accesso, in modo chiaro, per permettervi di identificare subito chi si è connesso, quando e da dove.

L'oggetto indica l'accesso e l'identificativo dell'utente interessato
L'identità dell'utente: il suo identificativo di accesso e il suo nome completo
La data e l'ora precise dell'accesso
L'indirizzo IP dal quale è avvenuto l'accesso
L'indirizzo (URL) dell'istanza Dolibarr interessata, utile se sorvegliate più istanze

4. Scelta dell'indirizzo di ricezione

Decidete liberamente chi riceve gli avvisi di accesso. L'indirizzo si imposta nella pagina di configurazione del modulo.

Inserimento di uno o più indirizzi email di destinazione (separati da una virgola; il punto e virgola è pienamente supportato solo in modalità SMTP manuale)
La pagina di configurazione precompila il campo destinatario con l'email della società definita in Dolibarr; in fase di esecuzione, se non è memorizzato alcun indirizzo di destinazione, non viene inviata alcuna email
Senza un indirizzo valido, non viene inviata alcuna email (l'accesso, invece, resta normale)

5. Scelta della modalità di invio dell'email

A seconda del vostro hosting e della vostra configurazione di posta, scegliete il modo in cui le email vengono inviate. Sono proposte tre modalità per adattarsi alla maggior parte delle situazioni.

Modalità PHP mail(): invio diretto tramite la funzione di posta del server, la più semplice
Modalità configurazione Dolibarr: riutilizza le impostazioni email già configurate nel vostro Dolibarr
Modalità SMTP manuale: inserite i vostri parametri del server di invio (host, porta, identificativo, password, sicurezza TLS/SSL, modalità di autenticazione)
È possibile definire un indirizzo mittente personalizzato; viene utilizzato qualunque sia la modalità di invio
Ripiego automatico: se l'invio diretto fallisce o non è disponibile, il modulo passa alla configurazione email di Dolibarr per massimizzare le possibilità di consegna

6. Invio di un'email di prova

Per verificare che tutto sia impostato correttamente prima di affidarvi agli avvisi, la pagina di configurazione propone un pulsante di prova.

Un pulsante invia immediatamente un'email di prova all'indirizzo di ricezione indicato
Viene visualizzato un messaggio di conferma in caso di successo, o un messaggio di errore se l'invio fallisce
Un avviso segnala quando Dolibarr è impostato per reindirizzare tutte le email verso un indirizzo imposto, al fine di evitare qualsiasi confusione sul destinatario reale

7. Registrazione degli errori

Per facilitare la diagnosi quando un'email non parte, il modulo può registrare gli incidenti di invio nel registro di Dolibarr.

Opzione attivabile per registrare gli errori di invio nei registri tecnici di Dolibarr
Aiuta l'amministratore o il fornitore a comprendere un problema di posta senza bloccare l'utilizzo
Anche gli avvisi di ripiego (passaggio da una modalità di invio a un'altra) vi vengono annotati

8. Configurazione e adattamento del modulo

Tutte le impostazioni sono raggruppate in un'unica pagina di configurazione, accessibile solo agli amministratori dall'elenco dei moduli. Nessuna impostazione è richiesta agli utenti.

Attivare o disattivare l'invio delle email di accesso
Definire l'indirizzo o gli indirizzi di ricezione degli avvisi
Scegliere la modalità di invio (PHP mail, configurazione Dolibarr o SMTP manuale) e, se necessario, il mittente
Inserire i parametri SMTP in modalità manuale (host, porta, identificativo, password, sicurezza, autenticazione)
Attivare la registrazione degli errori
Testare l'invio e salvare la configurazione

9. Collegamenti con Dolibarr

Il modulo non funziona in modo isolato: si integra con i blocchi nativi di Dolibarr.

Utenti Dolibarr : Il modulo si basa sull'evento nativo di accesso degli account utente di Dolibarr. L'email riprende l'identificativo e il nome completo della persona che si è appena connessa, così come sono registrati nella sua scheda utente.
Sistema di email di Dolibarr : La modalità di invio Dolibarr riutilizza la configurazione di posta già impostata nella vostra istanza (lo stesso motore di invio delle altre email di Dolibarr). Questa modalità funge anche da soluzione di ripiego automatico se l'invio diretto fallisce.
Scheda società (parametri generali) : In assenza di un indirizzo di ricezione o di un mittente personalizzato, il modulo riprende automaticamente l'indirizzo email della società definito nei parametri generali di Dolibarr, per restare coerente con il resto dell'applicazione.
Registri tecnici di Dolibarr : Quando la registrazione è attivata, gli errori e i passaggi di invio vengono scritti nei registri (syslog) nativi di Dolibarr, il che consente di diagnosticare un problema di posta tramite gli strumenti standard dell'ERP.
Preferenze di invio email (reindirizzamento) : Il modulo rispetta l'impostazione di Dolibarr che forza il reindirizzamento di tutte le email verso un unico indirizzo: ne avvisa l'amministratore nella pagina di configurazione per evitare qualsiasi confusione sul destinatario reale degli avvisi.