Configurações de administrador: SMTP

A página SMTP (SMTP significa protocolo SMTP) na seção Plataforma do menu Admin permite configurar as definições de e-mail. As instâncias do Looker enviam e-mails em muitas situações, incluindo notificações de novos usuários, redefinições de senha e notificações administrativas, bem como quando os usuários entregam conteúdo, como painéis e Looks.

Configurações do e-mail

No painel Admin do Looker, escolha SMTP para conferir e mudar as configurações de SMTP da sua instância. Você pode usar as configurações de e-mail padrão para aproveitar o serviço de e-mail do Looker sem precisar de configuração adicional.

Para usar um serviço de e-mail diferente, selecione Usar configurações de e-mail personalizadas. O Looker oferece suporte a dois métodos de autenticação para SMTP personalizado: autenticação básica (nome de usuário e senha) e OAuth 2.0.

As configurações de e-mail personalizadas podem ser configuradas para servidores SMTP que oferecem suporte aos PLAIN e LOGIN protocolos de autenticação ou OAuth 2.0.

Configurações de e-mail personalizadas

Insira os valores apropriados para as configurações de SMTP do seu serviço de e-mail:

  • Servidor de e-mail: o URL do seu servidor SMTP. Todas as mudanças nessa configuração exigem que o administrador do Looker também mude a senha do servidor SMTP.
  • De: o nome a ser exibido como remetente dos e-mails do Looker. Consulte um exemplo em Testar configurações de e-mail personalizadas. Você pode inserir uma string de nome e um endereço de e-mail entre colchetes angulares (por exemplo, Nome de exibição <email@address.com>) ou um endereço de e-mail sem colchetes angulares (por exemplo, email@address.com). Caracteres especiais, que não sejam o símbolo @ em um endereço de e-mail e os colchetes angulares ao redor, se aplicável, não são aceitos.
  • Nome de usuário: o nome de usuário necessário para acessar o servidor SMTP.
  • Senha: a senha necessária para acessar o servidor SMTP.

  • Porta: a porta a ser usada para o servidor SMTP. Todas as mudanças nessa configuração exigem que o administrador do Looker também mude a senha do servidor SMTP.

  • TLS/SSL: se o servidor SMTP usar os protocolos TLS ou SSL para e-mails mais seguros, selecione essa opção. O Looker mostra um menu suspenso de versões TLS e SSL compatíveis. Selecione a versão do protocolo. Para TLS, é recomendável usar o TLS 1.2.

  • Tipo de autenticação: selecione Autenticação básica para configurar um nome de usuário e uma senha para autenticar no servidor SMTP ou selecione OAuth para configurar a autenticação OAuth 2.0.

Autenticação básica

Insira o nome de usuário e a senha necessários para autenticar no servidor SMTP.

Autenticação do OAuth 2.0

Selecione essa opção se o provedor de SMTP usar o OAuth 2.0 para autenticar. Esse método é necessário para serviços como o Microsoft Office 365, que está descontinuando a autenticação básica.

Insira as seguintes informações do seu provedor de e-mail:

  • ID do cliente: o ID do cliente do aplicativo que você criou no Admin Console do provedor de e-mail.
  • Chave secreta do cliente: a chave secreta do cliente do aplicativo.
  • URL do token: o URL em que o Looker vai trocar credenciais por um token de acesso.
  • Escopos: os URLs dos escopos exigidos pelo provedor de e-mail. Por exemplo, para atribuir o escopo .default da plataforma de identidade da Microsoft, insira https://outlook.office365.com/.default.

Gerar credenciais do OAuth

Você precisará criar um aplicativo na plataforma do provedor de e-mail para gerar o ID do cliente, a chave secreta do cliente e o URL do token. Para mais informações sobre como criar um aplicativo, consulte as seguintes páginas:

Salvar configurações de SMTP

Depois de inserir as configurações de SMTP, clique no botão Salvar para salvar a configuração. Você também pode testar as configurações ou atualizar a página para conferir se a configuração tem erros.

O Looker restringe a frequência com que os administradores do Looker podem salvar ou testar as configurações de SMTP para evitar o uso desse recurso para verificar portas abertas.

Testar configurações de e-mail personalizadas

Para testar a configuração de e-mail personalizada, use o botão Enviar e-mail de teste. Esse teste funciona para as configurações de autenticação básica e OAuth 2.0. O Looker vai tentar enviar um e-mail de teste para o usuário que pressionou o botão. O e-mail de teste tem os seguintes atributos:

  • O remetente é admin@looker.com.
  • O assunto é Looker Mail Test.
  • O texto do corpo do e-mail é Looker mail is working!

Para impedir que agentes maliciosos verifiquem portas abertas, o Looker restringe a frequência com que os administradores do Looker podem testar as configurações de SMTP.

Mensagens de erro SMTP

Se houver problemas com a configuração de SMTP, o Looker vai alertar todos os administradores nos seguintes locais:

  • Uma mensagem de aviso na página SMTP
  • Um ícone de aviso ao lado da listagem SMTP na barra lateral Admin

Esses erros ficam visíveis para todos os administradores na instância do Looker. Você pode verificar erros imediatamente atualizando a página depois de salvar as configurações de e-mail personalizadas.

Os erros relacionados aos testes de configurações de e-mail personalizadas aparecem abaixo dos botões Salvar e Enviar e-mail de teste na parte de baixo da página SMTP.