MailService Properties

Service Konfiguration

Am Service muss ein BaseChannel konfiguriert werden, da es sonst zu Fehlern (Nullpointer-Exception) innerhalb der ChannelDistribution kommt.

Klasse: org.b2bbp.services.inbound.mail.MailService

Properties für den MailService

Wichtige Werte

Eigenschaft Beispielwert Erklärung
B3P_MAIL_PROTOCOL POP3,POP3S,IMAP,IMAPS Welches Protokoll spricht der Mailserver. Fehlt diese Eigenschaft, wird als Protokoll POP3 oder IMAP angenommen.
B3P_MAILBOX2CRAWL Testuser@domain.tld E-Mail-Adresse des Postfachs, dessen Nachrichten abgeholt werden sollen (wird zum Dokumentationszweck benutzt aber nicht aktiv verwendet.)
B3P_MAIL_AUTH_PWD Vlc4ZIHi7oc= Base64-kodiertes Passwort
B3P_MAIL_AUTH_USER Testuser Benutzername
B3P_SPAM_FORWARD spam@domain.tld E-Mail-Adresse für Spam
B3P_SMTP_HOST smtp.domain.tld Adresse des Postausgangsservers
B3P_SMTP_PORT 25 Port des Postausgangsservers

Protokoll-Spezifische Eigenschaften

POP3

Eigenschaft Beispielwert Standard Erklärung
B3P_POP3_HOST pop3.domain.tld oder IP   Adresse des Posteingangsservers
B3P_POP3_PORT 8110 110 Port für den Posteingangsserver
B3P_SSL_SOCKET_FACTORY true false OBSOLET. Falls POP3 mit TLS/SSL erwünscht wird, soll stattdessen B3P_MAIL_PROTOCOL = POP3S gesetzt werden.
B3P_POP3_TIMEOUT 60000 10000 Timeout in Millisekunden

POP3S

Eigenschaft Beispielwert Standard Erklärung
B3P_POP3_HOST pop3.domain.tld oder IP   Adresse des Posteingangsservers
B3P_POP3_PORT 995 110 MUSS Port für den Posteingangsserver. Sollte normalerweise auf 995 gesetzt werden. Wenn nicht gesetzt, wird 110 verwendet!
B3P_SSL_PROTOCOL TLSv1.1 TLSv1.2 TLSv1.2 das verwendete TLS/SSL Protokoll (meherer Möglich, mit Leerzeichen getrennt)
B3P_SSL_TRUST_ALWAYS true false true: Allen zur Signierung verwendeten Zertifikaten wird vertraut
false: die Zertifikatskette des verwendeten Zertifikats muss der B2B vorliegen, um ihm zu vertrauen
B3P_POP3_TIMEOUT 60000 10000 Timeout in Millisekunden

IMAP

Eigenschaft Beispielwert Standard Erklärung
B3P_IMAP_HOST imap.domain.tld oder IP   Adresse des Posteingangsservers
B3P_IMAP_PORT 8143 143 Port für den Posteingangsserver

Timeout

Standardmäßig wird kein Timeout gesetzt. Mit folgenden Eigenschaften kann man die Timeouts auf 10 Minuten setzen:

B3P_SESSION_PROP_mail.imap.connectiontimeout = 600000
B3P_SESSION_PROP_mail.imap.timeout = 600000
B3P_SESSION_PROP_mail.imap.writetimeout = 600000

IMAPS

Eigenschaft Beispielwert Standard Erklärung
B3P_IMAP_HOST imap.domain.tld oder IP   Adresse des Posteingangsservers
B3P_IMAP_PORT 993   Port für den Posteingangsserver (Sollte normalerweise auf 993 gesetzt werden)

Timeout

Standardmäßig wird kein Timeout gesetzt. Mit folgenden Eigenschaften kann man die Timeouts auf 10 Minuten setzen:

B3P_SESSION_PROP_mail.imaps.connectiontimeout = 600000
B3P_SESSION_PROP_mail.imaps.timeout = 600000
B3P_SESSION_PROP_mail.imaps.writetimeout = 600000

Optionale Werte

Eigenschaft Beispielwert Erklärung
B3P_POLL_INTERVAL 15 Zeitraum (in Sekunden), den der Service pausiert, bevor er auf neue Nachrichten prüft
FORWARD_ORIGINAL_MESSAGE true true: Falls eine Nachricht weitergeleitet werden soll (SPAM, COPY-Postfach), wird diese unverändert weitergeleitet. Das heißt auch, dass sich die Sender- und Empfänger-Adresse nicht ändern. false: Die Nachricht kann verändert sein, z. B. eine andere Empfänger-Adresse haben.
B3P_SET_ORIG_RECEIVED_DATE false/true true: Als Startzeit in der B2B wird die Eingangszeit der Nachricht auf dem Mailserver gesetzt. false: Als Startzeit in der B2B wird die Eingangszeit der Nachricht in die B2B gesetzt.
DEBUG_MIMETEXT 1 /0 1: Falls eine Nachricht weitergeleitet werden soll (SPAM Postfach), wird in der Mailbody der Clearingmail nicht nur den Text “Weitergeleitete Nachricht im Anhang” und Emailinfo, sonder auch noch Spamgrundtext reingeschrieben. Diese Propertie greift nur dann, wenn FORWARD_ORIGINAL_MESSAGE nicht aktiv oder false ist.
MAX_SUPPORTED_MAIL_SIZE 11000000 / 0 11000000: Nachrichten, die größer sind als dieser Wert, gemessen in Bytes, werden als SPAM ausgesteuert. Dies entspricht der Vorgabe für die Verarbeitung nach der Bundesnetzagentur
Außerdem werden Nachrichten nur bis zu dieser Gesamtgröße zeitgleich aus dem Postfach abgeholt.
0: Nachrichten werden nicht aufgrund einer bestimmten Größe als Spam ausgesteuert und es wird immer die maximale Anzahl an nachrichten aus dem Postfach abgeholt.
B3P_MAIL_MAX_FETCH_SIZE 10 Die maximale Anzahl an E-Mails, die mit einem Mal aus dem E-Mail-Postfach abgeholt werden
B3P_SMTP_AUTH false / true SMTP Authentifizierung aktiv (für Weiterleitungen)
B3P_MAIL_SMTP_AUTH_USER Testuser Benutzername
B3P_MAIL_SMTP_AUTH_PWD Vlc4ZIHi7oc= Base64-kodiertes Passwort
B3P_MAIL_SMTP_STARTTLS_ENABLE false/true Aktiviere STARTTLS beim SMTP-Versand
B3P_MAIL_FORWARD_SILENTLY false/true Ein Fehler beim Weiterleiten von Spam-Emails bewirkt keinen Verarbeitungsabbruch. Die Spam-Mail wird danach vom Mailserver gelöscht, auch wenn sie nicht ins Spam-Postfach weitergeleitet werden konnte!
B3P_LOAD_MSGS_PARALLEL false/true Verbessert die Performance bei Abruf über IMAP/IMAPS Protokollen. Bei anderen Protokollen bringt keine Verbesserung und sollte nicht gesetzt werden.
B3P_SESSION_PROP_<XXX> B3P_SESSION_PROP_mail.imap.timeout = 600000 Andere Protokollspezifische Properties können hiermit gesetzt werden. Der Property wird der Prefix “B3P_SESSION_PROP_” vorgesetzt. Die Auflistung aller vorhandener Properties ist hier zu finden: POP3, IMAP, SMTP.

Unbedingte Weiterleitung in Kopie

Der MailService kann auch alle eingehenden Nachrichten in Kopie an ein zusätzliches Postfach schicken. Wenn es bei dem Senden der Kopie ein Problem gibt, wird die Verarbeitung der betroffenen Nachricht abgebrochen und sie gilt nicht als verarbeitet. Dies kann zu Verstopfung des Eingangspostfach führen.

Eigenschaft Beispielwert Erklärung
B3P_MAIL_FORWARD false/true Leite alle Mails weiter an das Zielpostfach
B3P_MAILBOX2COPY copy@domain.tld An dieses Postfach werden die Nachrichten in Kopie weitergeleitet
B3P_MAIL_FORWARD_SILENTLY false/true Ein Fehler beim Weiterleiten bewirkt keinen Verarbeitungsabbruch. Diese Einstellung wirkt gleichsam auf die Weiterleitung der Spam-Emails. Die Spam-Mail kann somit vom Mailserver gelöscht werden, obwohl sie nicht ins Spam-Postfach weitergeleitet werden konnte!

Mail Duplikatscheck

Der MailService baut einen Cache auf, in dem die Message-IDs der zuletzt verarbeiteten E-Mails zwischengespeichert werden. Die Größe dieses Caches beträgt standardmäßig das Dreifache der Eigenschaft B3P_MAIL_MAX_FETCH_SIZE. Jeder Knoten und jeder MailService hat seinen eigenen Cache, es findet keine Synchronisierung statt. Wird beim Eingang einer E-Mail festgestellt, dass sich die Message-ID bereits im Cache befindet, wird ein Systemfehler erzeugt und die E-Mail wird nicht weiter bearbeitet. Es ist möglich diese doppelt auftretenden E-Mails an eine E-Mail-Adresse weiterzuleiten.

Eigenschaft Beispielwert Erklärung
B3P_NO_MESSAGE_DUPLICATE_CHECK false/true Deaktiviert den Message-ID-Duplikatcheck, wenn auf true gesetzt
B3P_PROCESS_MESSAGE_WITHOUT_DUPLICATE_CHECK_WHEN_MAIL_ID_UNKNOWN false/true Deaktiviert den Message-ID-Duplikatcheck nur für Mails ohne Message-ID, wenn auf true gesetzt
B3P_MAILBOX2DUPLICATE duplicate@domain.tld Wird diese Eigenschaft gesetzt, werden über die Message-ID identifizierte Duplikate an die gesetzte E-Mail-Adresse weitergeleitet
DUPLICATE_CHECK_CACHE_SIZE 100 Überschreibt die Cachegröße. Standardmäßig beträgt diese das Dreifache der Eigenschaft B3P_MAIL_MAX_FETCH_SIZE.

Properties für den MailServiceCrypto

Eigenschaft Beispielwert Erklärung
ABORT_PROCCESSING_ON_TECHNICAL_CRYPTO_ERROR true true: Falls es bei der Kommunikation mit dem Cryptoserver zu einem technischen Fehler kommt, werden die Nachrichten im Postfach belassen. false: Die Nachricht landet in der B2B im Channel CRYPTO_ERROR
View Me   Edit Me