UC_SMTP_MYSERVER - SMTP-Variable

Diese statische Variable ermöglicht es Ihnen, mehrere SMTP(S)-Server zu konfigurieren, um die erforderliche Verbindung zum Senden von E-Mails über die Automation Engine oder einen Agenten herzustellen, wenn Sie die Script-Funktion SEND_MAIL verwenden. Sie wird mit Mandant 0 bereitgestellt und kann nach Bedarf in andere Mandanten kopiert und angepasst werden.

Dafür definieren Sie eine Variable UC_SMTP_MYSERVER für jeden Server (UC_SMTP_MYSERVER1, UC_SMTP_MYSERVER2) und ersetzen dabei MYSERVER durch den entsprechenden Servernamen (z. B. UC_SMTP_LOCALHOST). Der Servername, den Sie für eine Variable definieren, muss mit dem Parameter MYSERVER übereinstimmen, der in der Script-Funktion SEND_MAIL verwendet wird. Weitere Informationen finden Sie unter SEND_MAIL und Einrichten von E-Mail-Verbindungen.

Wichtig!

  • Die Schlüssel SMTP_SERVER und SMTP_FROM_ADDR sind immer obligatorisch.

  • Wenn Sie die Protokolle STARTTLS oder TLS auswählen, ist das Definieren des Schlüssels SMTPS_CERT ebenfalls obligatorisch. Stellen Sie sicher, dass das relevante Zertifikat im Speicherobjekt UC_TRUSTEDCERTS in Mandant 0 verfügbar ist. Weitere Informationen finden Sie unter UC_TRUSTEDCERTS - Speicherobjekt.

  • Nicht alle Agenten unterstützen das Senden (sicherer) E-Mails. Weitere Informationen finden Sie unter Einrichten von E-Mail-Verbindungen.

  • Agenten, die SMTP, aber nicht SMTPS unterstützen, ignorieren die Schlüssel, die für TLS relevant sind. Wenn sie E-Mails senden können, tun sie dies unter Verwendung des Protokolls PLAIN, der Definition des Schlüssels SMTP_SERVER und der Standarddefinition von SMTP_PORT (25). Dadurch wird Abwärtskompatibilität mit Agenten gesichert, die das Senden von sicheren E-Mails nicht unterstützen.

Diese Variable deckt die folgenden SMTP(S)-Parameter ab:

SMTP_FROM_ADDR

  • Beschreibung: (obligatorisch) E-Mail-Adresse des Absenders.

  • Neustart erforderlich: Nein

SMTP_LOGIN

  • Beschreibung: (Optional) Der Name des Login-Objekts, das zur Anmeldung am SMTP-Server verwendet wird.

  • Neustart erforderlich: Nein

SMTP_MAX_ATTACHMENT_SIZE

  • Beschreibung: (Optional) Maximale Größe in Byte der Berichtsdatei, die per E-Mail gesendet wird. Dies gilt nur für Berichte, die per E-Mail gesendet werden, aber nicht für andere Typen von Anhängen.

    Geben Sie auf der Seite Benachrichtigung eines Benachrichtigungsobjekts die RunID der relevanten Aufgabe an, damit die entsprechenden Berichte an die Nachricht angehängt werden können. Weitere Informationen finden Sie unter Benachrichtigung (CALL).

  • Zulässige Werte: 400–50000

    Wenn die Reportdatei den Maximalwert überschreitet, wird nur die zulässige Größe gelesen und gesendet. Das Dateiende enthält den folgenden Hinweis: Truncated through SMTP_MAX_ATTACHMENT_SIZE limit.

  • Standardwert: 8000

  • Neustart erforderlich: Nein

SMTP_PORT

  • Beschreibung: (Optional) Port des SMTP(S)-Servers, der verwendet wird, um eine Verbindung zum E-Mail-Server herzustellen.

    Ein Port, der TLS unterstützt, ist möglicherweise erforderlich, wenn STARTTLS oder TLS unter SMTP_PROTOCOL festgelegt sind.

  • Standardwert: 25

  • Neustart erforderlich: Nein

SMTP_PROTOCOL

  • Beschreibung: (Optional) Das Protokoll, das Sie verwenden möchten, um die Kommunikation zu herstellen.

  • Zulässige Werte: Großbuchstaben, Kleinbuchstaben und eine Mischung aus Groß- und Kleinbuchstaben

    • PLAIN (Standard)

      Sendet E-Mails über eine unverschlüsselte Verbindung.

    • STARTTLS

      Sendet E-Mails über eine opportunistische TLS-Verbindung. Abhängig davon, wie Ihr SMTP-Server konfiguriert ist, müssen Sie möglicherweise auch das Standardverhalten von SMTP_PORT ändern.

    • TLS

      Sendet E-Mails über eine erzwungene TLS-Verbindung. In diesem Fall benötigen Sie einen Port, der TLS unterstützt.

    Wenn Sie STARTTLS oder TLS auswählen, ist es obligatorisch, den Parameter SMTPS_CERT zu definieren und auf das Zertifikat zu verweisen, das Sie verwenden möchten. Stellen Sie sicher, dass das relevante Zertifikat in das Speicherobjekt UC_TRUSTEDCERTS in Mandant 0 hochgeladen wurde. Weitere Informationen finden Sie unter UC_TRUSTEDCERTS - Speicherobjekt.

  • Neustart erforderlich: Nein

SMTP_REPLY_TO

  • Beschreibung: (Optional) E-Mail-Adresse für die Antwort.

  • Neustart erforderlich: Nein

SMTP_SERVER

  • Beschreibung: (Obligatorisch) Hostname des SMTP- Servers.

  • Neustart erforderlich: Nein

SMTP_TIMEOUT

  • Beschreibung: (Optional) Maximale Zeit in Sekunden, die das System auf die Antwort eines SMTP-Servers wartet.

  • Zulässige Werte: 0–999

  • Standardwert: 20

  • Neustart erforderlich: Nein

SMTPS_CERT

  • Beschreibung: (Obligatorisch, wenn STARTTLS oder TLS für SMTP_PROTOCOL festgelegt ist)

    Name des Zertifikats, das im Speicherobjekt UC_TRUSTEDCERTS in Mandant 0 gespeichert ist. Weitere Informationen finden Sie unter UC_TRUSTEDCERTS - Speicherobjekt.

    Wenn Sie einen Agenten verwenden, um sichere E-Mails zu senden, sucht das System im Speicherobjekt UC_TRUSTEDCERTS nach dem Zertifikat, das im Schlüssel SMTPS_CERT definiert wurde. Die AE sendet diese Datei an den Agenten, der sie verwendet, um eine E-Mail an den SMTP-Server zu senden. Jedoch speichert der Agent das Zertifikat im Cache und erhält nur dann ein neues, wenn Änderungen am Speicherobjekt UC_TRUSTEDCERTS vorgenommen werden (Änderungen lösen eine Löschung des Cache aus).

  • Neustart erforderlich: Nein

Siehe auch: