[comment]: # ({473c0010-d40475f4})
# 1 E-mail
[comment]: # ({/473c0010-d40475f4})
[comment]: # ({860d77dd-9d59e93d})
#### Panoramica
Per configurare l'email come canale di consegna dei messaggi, è necessario configurare l'email come tipo di supporto e assegnare indirizzi specifici agli utenti.
::: noteclassic
Le notifiche multiple per un singolo evento verranno raggruppate nello stesso thread email.
:::
[comment]: # ({/860d77dd-9d59e93d})
[comment]: # ({259509d6-3711e99d})
#### Configurazione
Per configurare l'email come tipo di media:
1. Vai su *Alerts > Media types*.
2. Fai clic su *Create media type* (oppure fai clic su *Email* nell'elenco dei tipi di media predefiniti).
La scheda **Media type** contiene gli attributi generali del tipo di media:
{width="600"}
Tutti i campi di input obbligatori sono contrassegnati da un asterisco rosso.
:::notewarning
La password viene esportata in testo in chiaro quando si esporta la configurazione del tipo di media email.
:::
I seguenti parametri sono specifici per il tipo di media email:
|Parameter|Description|
|--|--------|
|*Email provider*|Seleziona il provider email: *Generic SMTP*, *Gmail*, *Gmail relay*, *Office365* o *Office365 relay*.
Se selezioni le opzioni relative a Gmail/Office365, dovrai fornire solo l'indirizzo email del mittente e la password; opzioni come *SMTP server*, *SMTP server port*, *SMTP helo* e *Connection security* verranno compilate automaticamente da Zabbix. Vedi anche: [Automated Gmail/Office365 media types](/manual/config/notifications/media/email/gmail_office). |
|*SMTP server*|Imposta un server SMTP per gestire i messaggi in uscita.
Questo campo è disponibile se come provider email è selezionato *Generic SMTP*.|
|*SMTP server port*|Imposta la porta del server SMTP per gestire i messaggi in uscita.
Questo campo è disponibile se come provider email è selezionato *Generic SMTP*.|
|*Email*|L'indirizzo inserito qui verrà usato come indirizzo **From** per i messaggi inviati.
È supportata l'aggiunta di un nome visualizzato del mittente (come "Zabbix\_info" in *Zabbix\_info * nello screenshot sopra) insieme all'indirizzo email effettivo.
In Zabbix esistono alcune restrizioni sui nomi visualizzati nelle email rispetto a quanto consentito da RFC 5322, come illustrato dagli esempi seguenti:
Esempi validi:
*zabbix\@company.com* (solo indirizzo email, non è necessario usare le parentesi angolari)
*Zabbix\_info * (nome visualizzato e indirizzo email tra parentesi angolari)
*∑Ω-monitoring * (caratteri UTF-8 nel nome visualizzato)
Esempi non validi:
*Zabbix HQ zabbix\@company.com* (nome visualizzato presente ma senza parentesi angolari attorno all'indirizzo email)
*"Zabbix\\@\\" * (sebbene valido secondo RFC 5322, le coppie tra virgolette e i commenti non sono supportati nelle email di Zabbix)|
|*SMTP helo*|Imposta un valore SMTP helo corretto, normalmente un nome di dominio.
Se vuoto, verrà inviato il nome di dominio dell'email (cioè ciò che segue `@` nel campo *Email*). Se non è possibile recuperare il nome di dominio, verrà registrato un avviso a livello debug e verrà inviato il nome host del server come dominio per il comando HELO.
Questo campo è disponibile se come provider email è selezionato *Generic SMTP*.|
|*Connection security*|Seleziona il livello di sicurezza della connessione:
**None** - non usare l'opzione [CURLOPT\_USE\_SSL](http://curl.haxx.se/libcurl/c/CURLOPT_USE_SSL.html)
**STARTTLS** - usa l'opzione CURLOPT\_USE\_SSL con valore CURLUSESSL\_ALL
**SSL/TLS** - l'uso di CURLOPT\_USE\_SSL è facoltativo|
|*SSL verify peer*|Seleziona la casella per verificare il certificato SSL del server SMTP.
Il valore della direttiva di configurazione del server "SSLCALocation" deve essere inserito in [CURLOPT\_CAPATH](http://curl.haxx.se/libcurl/c/CURLOPT_CAPATH.html) per la convalida del certificato.
Questo imposta l'opzione cURL [CURLOPT\_SSL\_VERIFYPEER](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYPEER.html).|
|*SSL verify host*|Seleziona la casella per verificare che il campo *Common Name* o il campo *Subject Alternate Name* del certificato del server SMTP corrisponda.
Questo imposta l'opzione cURL [CURLOPT\_SSL\_VERIFYHOST](http://curl.haxx.se/libcurl/c/CURLOPT_SSL_VERIFYHOST.html).|
|*Authentication*|Seleziona il livello di autenticazione:
**None** - non vengono impostate opzioni cURL
**Username and password** - implica "AUTH=\*" lasciando a cURL la scelta del meccanismo di autenticazione
**OAuth** - autenticazione OAuth
L'autenticazione OAuth non è supportata per il provider email *Office365 relay*.|
|*Username*|Nome utente da usare nell'autenticazione.
Questo imposta il valore di [CURLOPT\_USERNAME](http://curl.haxx.se/libcurl/c/CURLOPT_USERNAME.html).
[User macros](/manual/appendix/macros/supported_by_location_user#other-locations) supportate.|
|*Password*|Password da usare nell'autenticazione.
Questo imposta il valore di [CURLOPT\_PASSWORD](http://curl.haxx.se/libcurl/c/CURLOPT_PASSWORD.html).
[User macros](/manual/appendix/macros/supported_by_location_user#other-locations) supportate.
Il valore inserito qui viene esportato così com'è quando viene esportata la configurazione del tipo di media. Per evitare di esporre credenziali sensibili nei file esportati, usa una user macro (ad esempio `{$EMAIL_SMTP_PASSWORD}`) invece di una password letterale: il riferimento alla macro verrà esportato mentre il valore segreto dovrà essere (ri)configurato sul sistema di destinazione.|
|*OAuth tokens*|Fai clic su *Configure* per impostare i parametri per il recupero dei [OAuth tokens](#oauth-tokens) in una nuova finestra.
Questo campo è disponibile solo se nel campo *Authentication* è selezionato "OAuth".|
|*Message format*|Seleziona il formato del messaggio:
**HTML** - invia come HTML
**Plain text** - invia come testo semplice|
::: noteimportant
Per abilitare l'autenticazione SMTP, Zabbix server deve essere compilato con l'opzione di [compilazione](/manual/installation/install#configure-the-sources) `--with-libcurl`, che richiede libcurl (vedi i requisiti di [server](/manual/installation/requirements#serverproxy) per i dettagli sulla versione).
:::
Vedi anche i [parametri comuni del tipo di media](/manual/config/notifications/media#common-parameters) per i dettagli su come configurare i messaggi predefiniti e le opzioni di elaborazione degli avvisi.
[comment]: # ({/259509d6-3711e99d})
[comment]: # ({6f74aa36-61f2be67})
#### Token OAuth
Per recuperare i token OAuth sono richiesti i seguenti parametri:
{width="600"}
|Parametro|Descrizione|
|--|--------|
|*Endpoint di reindirizzamento*|Inserire l'URL del frontend di Zabbix a cui il servizio OAuth reindirizzerà l'autorizzazione OAuth (utilizzando il formato `https:///zabbix.php?action=oauth.authorize`).
Viene impostato automaticamente per un nuovo tipo di supporto email quando è definito l'[URL del frontend](/manual/web_interface/frontend_sections/administration/general#other).|
|*ID client*|Inserire l'identificatore univoco dell'app client registrata nel server di autorizzazione OAuth.|
|*Segreto client*|Inserire il segreto privato dell'app client registrata nel server di autorizzazione OAuth.|
|*Endpoint di autorizzazione*|Inserire l'URL del server di autorizzazione OAuth per richiedere l'autorizzazione dell'utente.|
|*Parametri di autorizzazione*|Inserire i parametri per l'endpoint di autorizzazione.|
|*Codice di autorizzazione*|Inserire il codice di autorizzazione:
**Automatico** - il codice verrà recuperato automaticamente tramite una pagina di reindirizzamento
**Manuale** - inserire il codice manualmente se il recupero automatico non riesce|
|*Endpoint del token*|Inserire l'URL del server di autorizzazione OAuth per scambiare il codice di autorizzazione con token di accesso e di aggiornamento.|
|*Parametri del token*|Inserire i parametri per il token di accesso.|
:::notetip
Il recupero dei token OAuth dispone di [funzionalità automatizzate](/manual/config/notifications/media/email/gmail_office#oauth-tokens) per i provider email **Gmail**, **Gmail relay** e **Office365**. È necessario fornire solo i valori dei parametri *Endpoint di reindirizzamento*, *ID client* e *Segreto client*. Zabbix compilerà automaticamente gli altri valori richiesti (vedere [Valori predefiniti degli URL OAuth per provider](/manual/config/notifications/media/email/gmail_office#oauth-url-defaults-by-provider)).
:::
[comment]: # ({/6f74aa36-61f2be67})
[comment]: # ({cdcb5c81-7bf715f0})
##### Recupero dei token di accesso e di aggiornamento OAuth
Dopo aver inviato i parametri OAuth:
1. Si apre una finestra popup del browser che reindirizza l'utente all'*endpoint di autorizzazione*.
2. L'utente autorizza Zabbix nel servizio OAuth.
3. Il servizio OAuth reindirizza l'utente all'azione `oauth.authorize` del frontend di Zabbix con il codice di autorizzazione e il valore dello scope.
4. In risposta, Zabbix invierà una richiesta all'*endpoint del token* per scambiare il codice di autorizzazione con i token di accesso e di aggiornamento.
[comment]: # ({/cdcb5c81-7bf715f0})
[comment]: # ({50e8f033-98f29ec0})
#### Test
Per verificare se un tipo di supporto email configurato funziona correttamente:
1. Individua l'email pertinente nell'[elenco](/manual/config/notifications/media#overview) dei tipi di supporto.
2. Fai clic su *Test* nell'ultima colonna dell'elenco (si aprirà una finestra di test).
3. Inserisci un indirizzo del destinatario in *Send to*, il corpo del messaggio e, facoltativamente, l'oggetto.
4. Fai clic su *Test* per inviare un messaggio di prova.
Nella stessa finestra verrà visualizzato un messaggio di esito positivo o negativo del test:
{width="600"}
[comment]: # ({/50e8f033-98f29ec0})
[comment]: # ({859be4b6-5e74f274})
#### Supporti utente
Una volta configurato il tipo di supporto email, andare alla sezione *Utenti > Utenti* e modificare il profilo utente per assegnare il supporto email all'utente.
I passaggi per configurare i supporti utente, comuni a tutti i tipi di supporto, sono descritti nella pagina [Tipi di supporto](/manual/config/notifications/media#user-media).
[comment]: # ({/859be4b6-5e74f274})