Definições de administrador – SMTP

A página SMTP (SMTP significa Simple Mail Transfer Protocol) na secção Plataforma do menu Administração permite-lhe configurar as definições de email. As instâncias do Looker enviam emails em muitas situações, incluindo notificações de novos utilizadores, reposições de palavras-passe e notificações administrativas, bem como quando os utilizadores entregam conteúdo, como painéis de controlo e Looks.

Nota: se tiver uma autorização que conceda acesso apenas a páginas selecionadas no painel de administração, como manage_schedules, manage_themes ou see_admin, mas não tiver a função de administrador, a página ou as páginas descritas aqui podem não estar visíveis no painel de administração.

Definições de correio

Obsoleto: para instâncias do Looker alojadas pelo cliente, o serviço de email do Looker predefinido não está disponível e as opções de SMTP não são visíveis. Tem de configurar um serviço de email diferente para todas as novas instâncias alojadas pelo cliente.

No painel Administração do Looker, escolha SMTP para ver e alterar as definições de SMTP da sua instância. Pode usar as definições de correio predefinidas para tirar partido do serviço de email do Looker, sem necessidade de configuração adicional.

Para usar um serviço de email diferente, selecione Usar definições de correio personalizadas. O Looker suporta dois métodos de autenticação para SMTP personalizado: autenticação básica (nome de utilizador e palavra-passe) e OAuth 2.0.

As definições de correio personalizadas podem ser configuradas para servidores SMTP que suportam os PLAIN e LOGIN protocolos de autenticação ou o OAuth 2.0.

Definições de correio personalizadas

Introduza os valores adequados para as definições de SMTP do seu serviço de email:

• Servidor de correio: o URL do seu servidor SMTP. Quaisquer alterações a esta definição exigem que o administrador do Looker também altere a palavra-passe do servidor SMTP.
• De: o nome a apresentar como remetente dos seus emails do Looker (consulte o artigo Testar definições de email personalizadas para ver um exemplo). Pode introduzir uma string de nome e um endereço de email entre parênteses angulares (por exemplo, Nome a apresentar <[e-mail]>) ou um endereço de email sem parênteses angulares (por exemplo, [e-mail]). Não são suportados carateres especiais, exceto o símbolo @ num endereço de email e os parênteses angulares circundantes, se aplicável.
• Nome de utilizador: o nome de utilizador necessário para aceder ao seu servidor SMTP.
• Palavra-passe: a palavra-passe necessária para aceder ao seu servidor SMTP.

• Porta: a porta a usar para o seu servidor SMTP. Quaisquer alterações a esta definição exigem que o administrador do Looker também altere a palavra-passe do servidor SMTP.

  Nota: as instâncias do Looker alojadas no Google Cloud não podem usar a porta 25 para SMTP. Google Cloud bloqueia todo o tráfego na porta 25. Para mais informações, consulte a página Enviar email a partir de uma instância na Google Cloud documentação. A utilização da porta 25 para SMTP em instâncias do Looker alojadas no Microsoft Azure não é recomendada e pode resultar em erros. Para mais informações, consulte a página Resolução de problemas de conetividade SMTP de saída na documentação do Azure.

• TLS/SSL: se o seu servidor SMTP usar os protocolos TLS ou SSL para um email mais seguro, selecione esta opção. O Looker apresenta um menu pendente das versões de TLS e SSL suportadas. Selecione a versão do protocolo. Para o TLS, recomenda-se o TLS 1.2.

• Tipo de autenticação: selecione Autenticação básica para configurar um nome de utilizador e uma palavra-passe para autenticação no seu servidor SMTP ou selecione OAuth para configurar a autenticação OAuth 2.0.

  Nota: pode alternar entre os tipos de autenticação sem interromper o serviço de email.

Autenticação básica

Introduza o nome de utilizador e a palavra-passe necessários para a autenticação no seu servidor SMTP.

Autenticação OAuth 2.0

Selecione esta opção se o seu fornecedor de SMTP usar o OAuth 2.0 para autenticar. Este método é necessário para serviços como o Microsoft Office 365, que está a descontinuar a autenticação básica.

Introduza as seguintes informações do seu fornecedor de email:

• ID de cliente: o ID de cliente da aplicação que criou na consola de administração do seu fornecedor de email.
• Segredo do cliente: o segredo do cliente da aplicação.
• URL do token: o URL onde o Looker troca credenciais por um token de acesso.
• Âmbitos: os URLs dos âmbitos que o seu fornecedor de email requer. Por exemplo, para atribuir o âmbito da plataforma de identidade da Microsoft .default, introduza https://outlook.office365.com/.default.

A gerar credenciais OAuth

Tem de criar uma aplicação na plataforma do seu fornecedor de email para gerar o ID do cliente, o segredo do cliente e o URL do token. Para mais informações sobre como criar uma aplicação, consulte as seguintes páginas:

• Utilizar o OAuth 2.0 para aceder às APIs Google
• Tipos de aplicações para a plataforma de identidades da Microsoft

A guardar as definições de SMTP

Depois de introduzir as definições de SMTP, clique no botão Guardar para guardar a configuração. Também pode testar as suas definições ou atualizar a página para verificar se a configuração tem erros.

Nota: se estiver a usar definições de correio personalizadas para SMTP, adicione os endereços IP do Looker à lista de autorizações de IPs do seu servidor SMTP para que o servidor SMTP permita o tráfego de entrada do Looker.

O Looker restringe a frequência com que os administradores do Looker podem guardar ou testar as definições de SMTP para evitar a utilização desta funcionalidade para procurar portas abertas.

Testar definições de email personalizado

Para testar a configuração de email personalizado, use o botão Enviar email de teste. Este teste funciona para as definições de autenticação básica e OAuth 2.0. O Looker tenta enviar um email de teste ao utilizador que premir o botão. O email de teste tem os seguintes atributos:

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

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

Mensagens de erro de SMTP

Se existirem problemas com a configuração SMTP, o Looker alerta todos os administradores nas seguintes localizações:

• Uma mensagem de aviso na página SMTP
• Um ícone de aviso junto à listagem SMTP na barra lateral Administração

Estes erros são visíveis para todos os administradores na sua instância do Looker. Pode verificar imediatamente se existem erros atualizando a página depois de guardar as definições de correio personalizadas.

Os erros relacionados com os testes de definições de email personalizadas são apresentados abaixo dos botões Guardar e Enviar email de teste na parte inferior da página SMTP.