Impostazioni amministratore - SMTP

La pagina SMTP (SMTP sta per Simple Mail Transfer Protocol) nella sezione Piattaforma del menu Amministrazione ti consente di configurare le impostazioni email. Le istanze di Looker inviano email in molte situazioni, tra cui notifiche per nuovi utenti, reimpostazioni della password e notifiche amministrative, nonché quando gli utenti distribuiscono contenuti come dashboard e Look.

Nota: se disponi di un'autorizzazione che fornisce l'accesso solo a determinate pagine nel pannello di amministrazione, ad esempio manage_schedules, manage_themes o see_admin, ma non disponi del ruolo Amministratore, la pagina o le pagine descritte qui potrebbero non essere visibili nel pannello di amministrazione.

Mail Settings (Impostazioni posta)

Ritirato :per le istanze Looker ospitate dal cliente, il servizio email predefinito di Looker non è disponibile e le opzioni SMTP non sono visibili. Devi configurare un servizio email diverso per tutte le nuove istanze ospitate dal cliente.

Nel pannello Amministrazione di Looker, scegli SMTP per visualizzare e modificare le impostazioni SMTP della tua istanza. Puoi utilizzare le impostazioni di posta predefinite per usufruire del servizio email di Looker senza necessità di configurazioni aggiuntive.

Per utilizzare un altro servizio email, seleziona Utilizza impostazioni di posta personalizzate. Looker supporta due metodi di autenticazione per SMTP personalizzato: autenticazione di base (nome utente e password) e OAuth 2.0.

Le impostazioni di posta personalizzate possono essere configurate per i server SMTP che supportano i protocolli di autenticazione PLAIN e LOGIN o OAuth 2.0.

Impostazioni di posta personalizzate

Inserisci i valori appropriati per le impostazioni SMTP del tuo servizio email:

• Server di posta: l'URL del server SMTP. Qualsiasi modifica a questa impostazione richiede che l'amministratore di Looker modifichi anche la password del server SMTP.
• Da: il nome da visualizzare come mittente delle email di Looker (vedi Testare le impostazioni email personalizzate per un esempio). Puoi inserire una stringa di nome e un indirizzo email racchiusi tra parentesi angolari (ad esempio, Nome visualizzato <[e-mail]>) o un indirizzo email senza parentesi angolari (ad esempio, [e-mail]). I caratteri speciali, ad eccezione del simbolo @ in un indirizzo email e delle parentesi angolari circostanti, se applicabili, non sono supportati.
• Nome utente: il nome utente necessario per accedere al server SMTP.
• Password: la password necessaria per accedere al server SMTP.

• Porta: la porta da utilizzare per il server SMTP. Qualsiasi modifica a questa impostazione richiede che l'amministratore di Looker modifichi anche la password del server SMTP.

  Nota: le istanze di Looker ospitate su Google Cloud non possono utilizzare la porta 25 per SMTP. Google Cloud blocca tutto il traffico sulla porta 25. Per saperne di più, consulta la pagina Invio di email da un'istanza nella documentazione di Google Cloud . L'utilizzo della porta 25 per SMTP sulle istanze Looker ospitate su Microsoft Azure non è consigliato e potrebbe causare errori. Per ulteriori informazioni, consulta la pagina Risoluzione dei problemi di connettività SMTP in uscita nella documentazione di Azure.

• TLS/SSL: se il server SMTP utilizza i protocolli TLS o SSL per email più sicure, seleziona questa opzione. Looker mostra un menu a discesa delle versioni TLS e SSL supportate. Seleziona la versione del protocollo. Per TLS, è consigliata la versione 1.2.

• Tipo di autenticazione: seleziona Autenticazione di base per configurare un nome utente e una password per l'autenticazione al server SMTP oppure seleziona OAuth per configurare l'autenticazione OAuth 2.0.

  Nota: puoi passare da un tipo di autenticazione all'altro senza interrompere il servizio email.

Autenticazione di base

Inserisci il nome utente e la password richiesti per l'autenticazione al server SMTP.

Autenticazione OAuth 2.0

Seleziona questa opzione se il tuo provider SMTP utilizza OAuth 2.0 per l'autenticazione. Questo metodo è obbligatorio per servizi come Microsoft Office 365, che sta ritirando l'autenticazione di base.

Inserisci le seguenti informazioni del tuo provider email:

• ID client: l'ID client dell'applicazione che hai creato nella Console di amministrazione del tuo provider di posta elettronica.
• Client secret: il client secret per l'applicazione.
• URL token: l'URL in cui Looker scambierà le credenziali con un token di accesso.
• Ambiti: gli URL degli ambiti richiesti dal tuo provider email. Ad esempio, per assegnare l'ambito .default di Microsoft identity platform, inserisci https://outlook.office365.com/.default.

Generazione delle credenziali OAuth

Per generare l'ID client, il client secret e l'URL token, devi creare un'applicazione all'interno della piattaforma del tuo provider di posta elettronica. Per saperne di più sulla creazione di un'applicazione, consulta le seguenti pagine:

• Utilizzare OAuth 2.0 per accedere alle API di Google
• Tipi di applicazioni per Microsoft identity Platform

Salvataggio delle impostazioni SMTP

Una volta inserite le impostazioni SMTP, fai clic sul pulsante Salva per salvare la configurazione. Puoi anche testare le impostazioni o aggiornare la pagina per verificare se la configurazione presenta errori.

Nota: se utilizzi impostazioni di posta personalizzate per SMTP, aggiungi gli indirizzi IP di Looker alla lista degli indirizzi IP consentiti del server SMTP in modo che il server SMTP consenta il traffico in entrata da Looker.

Looker limita la frequenza con cui gli amministratori di Looker possono salvare o testare le impostazioni SMTP per impedire l'utilizzo di questa funzionalità per la scansione di porte aperte.

Testare le impostazioni email personalizzate

Per testare la configurazione dell'email personalizzata, utilizza il pulsante Invia email di prova. Questo test funziona sia per le impostazioni di autenticazione di base sia per quelle di OAuth 2.0. Looker tenterà di inviare un'email di test all'utente che ha premuto il pulsante. L'email di test ha i seguenti attributi:

• Il mittente è [e-mail].
• L'oggetto è Looker Mail Test.
• Il corpo del testo dell'email è Looker mail is working!

Per impedire agli agenti dannosi di eseguire la scansione delle porte aperte, Looker limita la frequenza con cui gli amministratori di Looker possono testare le impostazioni SMTP.

Messaggi di errore SMTP

Se si verificano problemi con la configurazione SMTP, Looker avvisa tutti gli amministratori nelle seguenti posizioni:

• Un messaggio di avviso nella pagina SMTP
• Un'icona di avviso accanto all'elenco SMTP nella barra laterale Amministrazione

Questi errori sono visibili a tutti gli amministratori dell'istanza di Looker. Puoi verificare immediatamente la presenza di errori aggiornando la pagina dopo aver salvato le impostazioni di posta personalizzate.

Gli errori relativi ai test delle impostazioni email personalizzate vengono visualizzati sotto i pulsanti Salva e Invia email di prova nella parte inferiore della pagina SMTP.