Configurações de administrador: SMTP

A página SMTP (protocolo SMTP) na seção Plataforma do menu Administrador 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.

Observação: se você tiver uma permissão que dá acesso apenas a algumas páginas no painel de administração, como manage_schedules, manage_themes ou see_admin, mas não tiver a função de administrador, as páginas descritas aqui podem não aparecer no painel de administração.

Configurações do e-mail

Descontinuado: para instâncias do Looker hospedadas pelo cliente, o serviço de e-mail padrão do Looker não está disponível, e as opções de SMTP não aparecem. É necessário configurar um serviço de e-mail diferente para todas as novas instâncias hospedadas pelo cliente.

No painel Administrador do Looker, escolha SMTP para conferir e mudar as configurações de SMTP da sua instância. É possível 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 outro serviço de e-mail, selecione Usar configurações de e-mail personalizadas. O Looker é compatível com 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 protocolos de autenticação PLAIN e LOGIN ou OAuth 2.0.

Configurações de e-mail personalizadas

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

• Servidor de e-mail: o URL do seu servidor SMTP. Qualquer mudança nessa configuração exige que o administrador do Looker também mude a senha do servidor SMTP.
• De: o nome a ser exibido como remetente dos seus e-mails do Looker. Consulte Teste das configurações de e-mail personalizadas para ver um exemplo. Você pode inserir uma string de nome e um endereço de e-mail entre colchetes angulares (por exemplo, Nome de exibição <[e-mail]>) ou um endereço de e-mail sem colchetes angulares (por exemplo, [e-mail]). Caracteres especiais, exceto 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. Qualquer mudança nessa configuração exige que o administrador do Looker também mude a senha do servidor SMTP.

  Observação: as instâncias do Looker hospedadas em Google Cloud não podem usar a porta 25 para SMTP.O Google Cloud bloqueia todo o tráfego na porta 25. Para mais informações, consulte a página Como enviar e-mails de uma instância na documentação do Google Cloud . Não é recomendável usar a porta 25 para SMTP em instâncias do Looker hospedadas no Microsoft Azure, e isso pode resultar em erros. Para mais informações, consulte a página Solução de problemas de conectividade SMTP de saída na documentação do Azure.

• TLS/SSL: selecione essa opção se o servidor SMTP usar os protocolos TLS ou SSL para e-mails mais seguros. O Looker mostra um menu suspenso com as versões compatíveis de TLS e SSL. 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.

  Observação: é possível alternar entre os tipos de autenticação sem interromper o serviço de e-mail.

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.

Digite 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 seu 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 seu 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 seu 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:

• Como usar o OAuth 2.0 para acessar as APIs do Google
• Tipos de aplicativos para a plataforma de identidade da Microsoft

Salvando as 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 suas configurações ou atualizar a página para ver se a configuração tem erros.

Observação: se você estiver usando configurações de e-mail personalizadas para SMTP, adicione os endereços IP do Looker à lista de permissões de IP do servidor SMTP para que ele permita o tráfego de entrada do Looker.

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

Testar configurações de e-mail personalizadas

Para testar sua 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 clicou no botão. O e-mail de teste tem os seguintes atributos:

• O remetente é [e-mail].
• O assunto é Looker Mail Test.
• O texto do corpo do e-mail é Looker mail is working!

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

Mensagens de erro SMTP

Se houver problemas com a configuração do 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 Administrador

Esses erros ficam visíveis para todos os administradores na sua instância do Looker. Para verificar se há erros imediatamente, atualize 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.