MMM-Mail

---

Table of contents

1. tl;dr
2. Config JSON Fragment
3. Proprietà (Config Section)
4. Screenshots
5. Supporto Provider
6. Host IMAP
7. Accesso Low Level Security
8. Password per App

---

tl;dr

Il seguente modulo permette di consultare in lettura la tua casella di posta elettronica.

---

Config JSON Fragment

{
	"module": "MMM-Mail",
	"position": "bottom_left",
	"header": "Email",
	"config": {
		"user": "YOUR_EMAIL_ADDRESS_HERE",
		"pass": "YOUR_EMAIL_PASSWORD_HERE",
		"host": "imap.gmail.com",
		"port": 993,
		"numberOfEmails": 5,
		"fade": true,
		"subjectlength": 50
	}
}

---

Proprietà (Config Section)

Proprietà	Tipo	Valori	Valore Default	Inderogabilità	Descrizione
user	String	Indirizzo email casella postale.	---	REQUIRED	Indirizzo email di cui si vogliono vedere le ultime N mail.
pass	String	Password della casella postale.	---	REQUIRED	Password della casella postale.
host	String	Nome host IMAP. (vedi sotto per ulteriori dettagli)	---	REQUIRED	Nome host IMAP.
port	Number	Porta. (vedi sotto per ulteriori dettagli)	---	REQUIRED	Numero della porta che l’host IMAP utilizza.
numberOfEmails	Number	Qualsiasi valore > 0.	5	OPTIONAL	Numero di mail da visualizzare.
fade	Boolean	true: Effetto dissolvenza mail più vecchie attivato false: Effetto dissolvenza mail più vecchie disattivato	true	OPTIONAL	Attiva / Disattiva l’effetto dissolvenza delle mail più vecchie.
subjectlength	Number	Qualsiasi valore > 0.	---	OPTIONAL	Lunchezza massima per la visualizzazione di una mail.

---

Screenshots

Questa è la visualizzazione del modulo in situazione di funzionamento corretto:

---

Supporto Provider

Il modulo è in continuo aggiornamento con lo scopo di includere il numero maggiore possibile di provider di posta elettronica compatibili. Di seguito un elenco riassuntivo dello stato di compatibilità ed inclusione:

Provider	Supporto	Necessario Low Level Security (App)	Necessaria Password per app	Necessario rejectUnauthorized	Dettagli
GMAIL	NO	—	—	—	—
MICROSOFT 365, OUTLOOK, HOTMAIL, LIVE	SI	NO	NO	NO	Riceve email e visualizza relativa notifica, ma la lista a schermo delle email NON viene compilata (aka: rimane vuota).
YAHOO	SI	NO	SI	NO	—
LIBERO	SI	NO	NO	NO	—
ICLOUD	SI	NO	SI	NO	—

---

Host IMAP

In base al provider di posta elettronica utilizzato, le impostazioni qui di seguito elencate possono variare. Attenersi ai valori qui riportati per garantire il corretto funzionamento del modulo. Se il provider da te cercato non è riportato nell’elenco, è facilmente reperibile dal web (con una ricerca del tipo: {nome_provider} imap settings):

GMAIL

Proprietà	Valore
host	"imap.gmail.com"
port	993

MICROSOFT 365 OUTLOOK HOTMAIL LIVE

Proprietà	Valore
host	"outlook.office365.com"
port	993

YAHOO

Proprietà	Valore
host	"imap.mail.yahoo.com"
port	993

LIBERO

Proprietà	Valore
host	"imapmail.libero.it"
port	993

ICLOUD

Proprietà	Valore
host	"imap.mail.me.com"
port	993

---

Accesso Low Level Security

Il seguente modulo, a causa di svariate limitazioni e complicazioni qui omesse per semplicità, NON SUPPORTA l’autenticazione sicura OAUTH o OAUTH2. Come diretta conseguenza, esso viene etichettato dai provider di posta elettronica come Less secure app (italiano: App meno sicura).

Dunque, per garantire il corretto funzionalmento del modulo, sarà necessario consentire l’accesso ad App meno sicure all’account email.

Generalizzare questa procedura è complicato dato l’elevato numero di provider di posta elettronica. E’ facilmente possibile trovare informazioni sul web. Riportiamo qui di seguito la procedura da effettuare con GMAIL, uno dei provider più utilizzati:

1. Recarsi nella pagina di configurazione del proprio account Google:

   https://myaccount.google.com/

   

2. Recarsi nella tab Sicurezza e selezionare / cliccare Attiva accesso (sconsigliato) nella opzione Accesso app meno sicure:

   

3. Attivare l’opzione Consenti app meno sicure:

   

---

Password per App

Molti provider, per tutelare l’account del cliente utilizzatore, NON permettono l’utilizzo della vera password dell’account di quest’ultimo in app di terze parti non riconosciute e / o verificate dal provider stesso. Ovviamente, per non causare un fenomeno di incompatibilità di massa, i provider mettono a disposizione il sistema delle: Password per App. Brevemente, questo sistema permette di generare password univoche per ogni app di terze parti con la quale si vuole utilizzare l’account utente del provider. Ovviamente le password generate sono univoche, differenti dalla vera password dell’account e funzionali sono per l’app di terze parti target della generazione. Con questo semplice metodo, è possibile tutelare (in gran parte) l’account utente (in quanto stiamo tutelando la vera password). Inoltre, questo metodo è essenziale per interagire con app che non supportano fattori di autenticazione avanzati che, invece, il provider prevede per l’accesso ai suoi servizi.

Generalizzare la procedura per generare la password univoca per app di terze parti è complicato dato l’elevato numero di provider (di posta elettronica e non solo). E’ facilmente possibile trovare informazioni sul web.