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 in 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:
| Parametro | Descrizione |
|---|---|
| Provider email | Seleziona il provider email: SMTP generico, Gmail, Relay Gmail, Office365 oppure Relay Office365. Se selezioni le opzioni relative a Gmail/Office365, dovrai fornire solo l'indirizzo email del mittente e la password; opzioni come Server SMTP, Porta server SMTP, SMTP helo e Sicurezza della connessione verranno compilate automaticamente da Zabbix. Vedi anche: Tipi di supporto Gmail/Office365 automatizzati. |
| Server SMTP | Imposta un server SMTP per gestire i messaggi in uscita. Questo campo è disponibile se come provider email è selezionato SMTP generico. |
| Porta server SMTP | Imposta la porta del server SMTP per gestire i messaggi in uscita. Questo campo è disponibile se come provider email è selezionato SMTP generico. |
| L'indirizzo inserito qui verrà usato 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 limitazioni per i 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 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 il nome host del server verrà inviato come dominio per il comando HELO.Questo campo è disponibile se come provider email è selezionato SMTP generico. |
| Sicurezza della connessione | Seleziona il livello di sicurezza della connessione: Nessuna - 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 |
| Verifica peer SSL | 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. |
| Verifica host SSL | 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. |
| Autenticazione | 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 Relay Office365. |
| Nome utente | Nome utente da usare per l'autenticazione. Questo imposta il valore di CURLOPT_USERNAME. Macro utente supportate. |
| Password | Password da usare 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, usa 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. |
| Token OAuth | Fai clic su Configura per impostare i parametri per il recupero dei token OAuth in una nuova finestra. Questo campo è disponibile solo se nel campo Autenticazione è selezionato "OAuth". |
| Formato del messaggio | Seleziona il formato del messaggio: HTML - invia come HTML Testo normale - invia come testo normale |
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 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, vai alla sezione Users > Users e modifica 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 Media types.