Zum Inhalt springen

SMTP in Jitterbit App Builder konfigurieren

Übersicht

Um E-Mails aus einer App Builder-App zu versenden, müssen Sie zunächst die SMTP-Einstellungen konfigurieren.

Simple Mail Transfer Protocol (SMTP) ist das Standardprotokoll zum Versenden von E-Mails über das Internet. App Builder unterstützt SMTP nativ. Szenarien, in denen App Builder E-Mails versendet, sind beispielsweise Workflow-Benachrichtigungen oder solche, die von der Funktion Passwort zurücksetzen versendet werden. Um E-Mails aus App Builder zu versenden, müssen Sie zunächst die SMTP-Einstellungen konfigurieren.

SMTP-Konfigurationstabelle

Der SMTP-Server wird als Benachrichtigungsserver registriert. App Builder wird mit einem einzelnen SMTP-Benachrichtigungsserver ausgeliefert, den Administratoren konfigurieren müssen, um SMTP-Vorgänge zu aktivieren.

Eigenschaft Wert
URI smtp://mail.example.com:PORT

Hinweis

Obwohl optional, wird ein PORT am Ende des URI fast immer angegeben. Falls nicht angegeben, ist der Standard 25.

UserName Ein Benutzername.
Password Ein Passwort.
From Address Eine gültige E-Mail-Adresse, die zum Versenden von E-Mails über den angegebenen Host berechtigt ist.

SMTP in App Builder konfigurieren

Um die Werte URI und From Address zu konfigurieren, führen Sie folgende Schritte aus:

  1. Navigieren Sie zur IDE.

  2. Klicken Sie in den Connect-Optionen auf die Schaltfläche Notification Servers.

  3. Doppelklicken Sie für den SMTP-Eintrag auf die Zeile oder klicken Sie auf das Symbol Open record. Ein Popup Notification Server wird geöffnet:

    smtp_config.png

  4. Legen Sie die folgenden Werte fest:

    • From Address: Dies muss eine gültige Adresse über den angegebenen Host sein. Falls eine Benachrichtigungsregel keine From-Adresse angibt, wird die in diesem Feld eingegebene Adresse verwendet.

    • URI: Das Format dieses Werts ist kritisch und sollte entweder smtp://<hostname> oder smtps://<hostname> sein. Siehe die Liste der unterstützten Protokolle. Wenn Sie E-Mails von einem Server versenden, der in der AWS-Region US-East-1 gehostet wird, geben Sie beispielsweise smtps://email-smtp.us-east-1.amazonaws.com ein.

  5. (Optional) Erweitern Sie den Abschnitt Security und legen Sie die folgenden Werte fest:

  6. (Optional) Erweitern Sie den Abschnitt Testing, legen Sie Werte für From und To fest und klicken Sie auf Test Email.

  7. Schließen Sie das Popup.

Unterstützte Protokolle

Protokoll Definition
SMTP Simple Mail Transfer Protocol (SMTP) ist ein Internetstandard für die elektronische Mailübertragung. Standardports: 25, 587, 465
SMTPS Simple Mail Transfer Protocol Secure (SMTPS) ist eine veraltete Methode zum Sichern von SMTP-Verbindungen mit Transport Layer Security (TLS).

Wichtig

App Builder unterstützt OAuth 2.0 nicht für die SMTP-Serverauthentifizierung.

Fehlerbehebung

Fehler: "Argument passed in is not serializable. Parameter name: value"
Dieser Fehler kann darauf hindeuten, dass App Builder die SMTP-Einstellungen nicht authentifizieren kann, insbesondere die Standard-From-Adresse. Überprüfen Sie die Eigenschaft From Address des Benachrichtigungsservers und stellen Sie sicher, dass sie eine gültige E-Mail-Adresse für den angegebenen Host verwendet.

Fehler: "Value cannot be null. ParameterName: From Address"
Dieser Fehler kann darauf hindeuten, dass App Builder die SMTP-Einstellungen nicht authentifizieren kann, insbesondere die standardmäßige From Address. Überprüfen Sie die Eigenschaft From Address für den Benachrichtigungsserver und stellen Sie sicher, dass sie eine gültige E-Mail-Adresse für den angegebenen Host verwendet und nicht null oder leer ist.

Fehler: "Unknown URI scheme. Parameter name: uri"
Dieser Fehler kann darauf hindeuten, dass App Builder die SMTP-Einstellungen nicht authentifizieren kann, insbesondere den Uri-Wert. Überprüfen Sie die Eigenschaft Uri für den Benachrichtigungsserver und stellen Sie sicher, dass sie einen gültigen Uri-Wert verwendet.

Fehler: "Authentication required"
Dieser Fehler kann darauf hindeuten, dass App Builder die SMTP-Einstellungen nicht authentifizieren kann, insbesondere entweder die Eigenschaft UserName oder Password in Bezug auf die SMTP-Konfiguration. Überprüfen Sie, dass die Benachrichtigungsserver-Einstellungen die korrekten Werte für UserName und Password haben.

Weitere Informationen zur Fehlerbehebung finden Sie in den folgenden Abschnitten im App Builder-Leitfaden zur Fehlerbehebung: