Configurações de administrador: SMTP

A página SMTP (Simple Mail Transfer Protocol) 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, além de 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 ver 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 Testar 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 um e-mail mais seguro. 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 do 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 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.