Administratoreinstellungen – SMTP

Auf der Seite SMTP (SMTP steht für Simple Mail Transfer Protocol) im Bereich Plattform des Menüs Admin können Sie Ihre E‑Mail-Einstellungen konfigurieren. Looker-Instanzen senden in vielen Situationen E‑Mails, z. B. bei Benachrichtigungen für neue Nutzer, Passwortzurücksetzungen und administrativen Benachrichtigungen sowie wenn Nutzer Inhalte wie Dashboards und Looksbereitstellen.

E‑Mail-Einstellungen

Wählen Sie im Admin -Bereich von Looker die Option SMTP aus, um die SMTP-Einstellungen Ihrer Instanz aufzurufen und zu ändern. Sie können die Standardeinstellungen für E‑Mails verwenden, um den E‑Mail-Dienst von Looker zu nutzen, ohne dass eine zusätzliche Konfiguration erforderlich ist.

Wenn Sie einen anderen E‑Mail-Dienst verwenden möchten, wählen Sie Benutzerdefinierte E‑Mail-Einstellungen verwenden aus. Looker unterstützt zwei Authentifizierungsmethoden für benutzerdefiniertes SMTP: Basisauthentifizierung (Nutzername und Passwort) und OAuth 2.0.

Benutzerdefinierte E‑Mail-Einstellungen können für SMTP-Server konfiguriert werden, die die PLAIN und LOGIN Authentifizierungsprotokolle oder OAuth 2.0 unterstützen.

Benutzerdefinierte E‑Mail-Einstellungen

Geben Sie die entsprechenden Werte für die SMTP-Einstellungen Ihres E‑Mail-Dienstes ein:

  • Mailserver: Die URL Ihres SMTP-Servers. Bei Änderungen an dieser Einstellung muss der Looker-Administrator auch das SMTP-Serverpasswort ändern.
  • Von: Der Name, der als Absender Ihrer Looker-E‑Mails angezeigt werden soll (ein Beispiel finden Sie unter Benutzerdefinierte E‑Mail-Einstellungen testen). Sie können eine Namensstring und eine E‑Mail-Adresse in spitzen Klammern eingeben (z. B. Anzeigename <email@address.com> ) oder eine E‑Mail-Adresse ohne spitze Klammern (z. B. email@address.com). Andere Sonderzeichen als das Symbol @ in einer E‑Mail-Adresse und die umgebenden spitzen Klammern (falls zutreffend) werden nicht unterstützt.
  • Nutzername: Der Nutzername, der für den Zugriff auf Ihren SMTP-Server erforderlich ist.
  • Passwort: Das Passwort, das für den Zugriff auf Ihren SMTP-Server erforderlich ist.
  • Port: Der Port, der für Ihren SMTP-Server verwendet werden soll. Bei Änderungen an dieser Einstellung muss der Looker-Administrator auch das SMTP-Serverpasswort ändern.

  • TLS/SSL: Wählen Sie diese Option aus, wenn Ihr SMTP-Server die Protokolle TLS oder SSL für sicherere E‑Mails verwendet. Looker zeigt ein Drop-down-Menü mit unterstützten TLS- und SSL-Versionen an. Wählen Sie Ihre Protokollversion aus. Für TLS wird TLS 1.2 empfohlen.

  • Authentifizierungstyp: Wählen Sie Basisauthentifizierung aus, um einen Nutzernamen und ein Passwort für die Authentifizierung bei Ihrem SMTP-Server zu konfigurieren, oder wählen Sie OAuth aus, um die OAuth 2.0-Authentifizierung zu konfigurieren.

Basisauthentifizierung

Geben Sie den Nutzernamen und das Passwort ein, die für die Authentifizierung bei Ihrem SMTP-Server erforderlich sind.

Authentifizierung mit OAuth 2.0

Wählen Sie diese Option aus, wenn Ihr SMTP-Anbieter OAuth 2.0 zur Authentifizierung verwendet. Diese Methode ist für Dienste wie Microsoft Office 365 erforderlich, bei denen die Basisauthentifizierung eingestellt wird.

Geben Sie die folgenden Informationen von Ihrem E‑Mail-Anbieter ein:

  • Client-ID: Die Client-ID der Anwendung, die Sie in der Admin-Konsole Ihres E‑Mail-Anbieters erstellt haben.
  • Clientschlüssel: Der Clientschlüssel für die Anwendung.
  • Token-URL: Die URL, unter der Looker Anmeldedaten gegen ein Zugriffstoken austauscht.
  • Bereiche: Die URLs der Bereiche, die von Ihrem E‑Mail-Anbieter erforderlich sind. Wenn Sie beispielsweise den Bereich .default der Microsoft-Identitätsplattform zuweisen möchten, geben Sie https://outlook.office365.com/.default ein.

OAuth-Anmeldedaten generieren

Sie müssen eine Anwendung auf der Plattform Ihres E‑Mail-Anbieters erstellen, um die Client-ID, den Clientschlüssel und die Token-URL zu generieren. Weitere Informationen zum Erstellen einer Anwendung finden Sie auf den folgenden Seiten:

SMTP-Einstellungen speichern

Nachdem Sie die SMTP-Einstellungen eingegeben haben, klicken Sie auf die Schaltfläche Speichern , um die Konfiguration zu speichern. Sie können die Einstellungen auch testen oder die Seite aktualisieren, um zu prüfen, ob Fehler in der Konfiguration vorhanden sind.

Looker beschränkt, wie oft Looker-Administratoren die SMTP-Einstellungen speichern oder testen können, um zu verhindern, dass diese Funktion zum Scannen nach offenen Ports verwendet wird.

Benutzerdefinierte E‑Mail-Einstellungen testen

Verwenden Sie die Schaltfläche Test-E‑Mail senden, um Ihre benutzerdefinierte E‑Mail-Einrichtung zu testen. Dieser Test funktioniert sowohl für die Basisauthentifizierung als auch für die OAuth 2.0 -Einstellungen. Looker versucht, eine Test-E‑Mail an den Nutzer zu senden, der auf die Schaltfläche geklickt hat. Die Test-E‑Mail hat die folgenden Attribute:

  • Der Absender ist admin@looker.com.
  • Der Betreff ist Looker Mail Test.
  • Der Text der E‑Mail lautet Looker mail is working!.

Um zu verhindern, dass böswillige Akteure nach offenen Ports suchen, beschränkt Looker, wie oft Looker-Administratoren die SMTP-Einstellungen testen können.

SMTP-Fehlermeldungen

Wenn Probleme mit der SMTP-Konfiguration auftreten, benachrichtigt Looker alle Administratoren an den folgenden Stellen:

  • Eine Warnmeldung auf der Seite SMTP
  • Ein Warnsymbol neben dem Eintrag SMTP in der Seitenleiste Admin

Diese Fehler sind für alle Administratoren in Ihrer Looker-Instanz sichtbar. Sie können sofort nach Fehlern suchen, indem Sie die Seite nach dem Speichern der benutzerdefinierten E‑Mail-Einstellungen aktualisieren.

Fehler im Zusammenhang mit Tests benutzerdefinierter E‑Mail-Einstellungen werden unten auf der Seite SMTP unter den Schaltflächen Speichern und Test-E‑Mail senden angezeigt.