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 supporto:
- Vai a Avvisi > Tipi di supporto.
- Fai clic su Crea tipo di supporto (oppure fai clic su Email nell'elenco dei tipi di supporto predefiniti).
La scheda Tipo di supporto contiene gli attributi generali del tipo di supporto:
Tutti i campi di input obbligatori sono contrassegnati con un asterisco rosso.
La password viene esportata in chiaro quando si esporta la configurazione del tipo di supporto email.
I seguenti parametri sono specifici del tipo di supporto email:
| Parameter | Description |
|---|---|
| Email provider | Seleziona il provider email: SMTP generico, Gmail, Gmail relay, Office365 oppure Office365 relay. Se selezioni le opzioni relative a Gmail/Office365, dovrai fornire solo l'indirizzo email del mittente e la password; opzioni come Server SMTP, Porta del server SMTP, SMTP helo e Sicurezza della connessione verranno compilate automaticamente da Zabbix. Vedi anche: Tipi di supporto Gmail/Office365 automatizzati. |
| SMTP server | Imposta un server SMTP per gestire i messaggi in uscita. Questo campo è disponibile se SMTP generico è selezionato come provider email. |
| SMTP server port | Imposta la porta del server SMTP per gestire i messaggi in uscita. Questo campo è disponibile se SMTP generico è selezionato come provider email. |
| L'indirizzo inserito qui verrà utilizzato come indirizzo Da 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. Esistono alcune restrizioni sui nomi visualizzati nelle email di Zabbix rispetto a quanto consentito da RFC 5322, come illustrato dagli esempi: 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 intorno 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 il nome host del server verrà inviato come dominio per il comando HELO.Questo campo è disponibile se SMTP generico è selezionato come provider email. |
| Connection security | Seleziona il livello di sicurezza della connessione: Nessuna - non utilizzare l'opzione CURLOPT_USE_SSL STARTTLS - utilizzare l'opzione CURLOPT_USE_SSL con il 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: Nessuna - non viene impostata alcuna opzione cURL Nome utente e 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 utilizzare per l'autenticazione. Questo imposta il valore di CURLOPT_USERNAME. Macro utente supportate. |
| Password | Password da utilizzare per l'autenticazione. Questo imposta il valore di CURLOPT_PASSWORD. Macro utente supportate. Il valore inserito qui viene esportato così com'è quando viene esportata la configurazione del tipo di supporto. Per evitare di esporre credenziali sensibili nei file esportati, utilizza invece una macro utente (ad esempio {$EMAIL_SMTP_PASSWORD}) al posto di una password letterale: verrà esportato il riferimento alla macro, mentre il valore segreto dovrà essere (ri)configurato nel sistema di destinazione. |
| OAuth tokens | Fai clic su Configura per impostare i parametri per il recupero degli 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 Testo semplice - 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 supporto 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.