1 E-mail
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.
Le notifiche multiple per un singolo evento verranno raggruppate nello stesso thread email.
Configurazione
Per configurare l'email come tipo di media:
- Vai su Alerts > Media types.
- 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:
Tutti i campi di input obbligatori sono contrassegnati da un asterisco rosso.
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. |
| 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. |
| 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 zabbix\@company.com 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 zabbix\@company.com (nome visualizzato e indirizzo email tra parentesi angolari) ∑Ω-monitoring zabbix\@company.com (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\@\<H(comment)Q\>" zabbix\@company.com (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 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 per la convalida del certificato. Questo imposta l'opzione cURL CURLOPT_SSL_VERIFYPEER. |
| 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. |
| 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. User macros supportate. |
| Password | Password da usare nell'autenticazione. Questo imposta il valore di CURLOPT_PASSWORD. User macros 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 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 |
Per abilitare l'autenticazione SMTP, Zabbix server deve essere compilato con l'opzione di compilazione --with-libcurl, che richiede libcurl (vedi i requisiti di server per i dettagli sulla versione).
Vedi anche i parametri comuni del tipo di media per i dettagli su come configurare i messaggi predefiniti e le opzioni di elaborazione degli avvisi.
Token OAuth
Per recuperare i token OAuth sono richiesti i seguenti parametri:
| 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-frontend-url>/zabbix.php?action=oauth.authorize).Viene impostato automaticamente per un nuovo tipo di supporto email quando è definito l'URL del frontend. |
| 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. |
Il recupero dei token OAuth dispone di funzionalità automatizzate 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).
Recupero dei token di accesso e di aggiornamento OAuth
Dopo aver inviato i parametri OAuth:
-
Si apre una finestra popup del browser che reindirizza l'utente all'endpoint di autorizzazione.
-
L'utente autorizza Zabbix nel servizio OAuth.
-
Il servizio OAuth reindirizza l'utente all'azione
oauth.authorizedel frontend di Zabbix con il codice di autorizzazione e il valore dello scope. -
In risposta, Zabbix invierà una richiesta all'endpoint del token per scambiare il codice di autorizzazione con i token di accesso e di aggiornamento.
Test
Per verificare se un tipo di supporto email configurato funziona correttamente:
- Individua l'email pertinente nell'elenco dei tipi di supporto.
- Fai clic su Test nell'ultima colonna dell'elenco (si aprirà una finestra di test).
- Inserisci un indirizzo del destinatario in Send to, il corpo del messaggio e, facoltativamente, l'oggetto.
- Fai clic su Test per inviare un messaggio di prova.
Nella stessa finestra verrà visualizzato un messaggio di esito positivo o negativo del test:
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.