Konfiguration 'mas-mailbox'

enaio® mail-archive-service • 12.0 »

Konfigurationsparameter der Datei masmailbox-prod.yml für das Journaling und die Postfach-Archivierung.

Die Konfigurationsparameter für Microsoft Exchange Online und für Microsoft Exchange on-premises unterscheiden sich. Für hybride Installationen werden die Parameter in die gleiche Datei masmailbox-prod.yml eingetragen.

Konfigurationswerte wie Benutzername und Passwort können in der Konfigurationsdatei verschlüsselt angegeben werden.

Als Basis der Konfiguration für Microsoft Exchange Online steht eine Konfigurationsdatei zum Download bereit, die Sie anpassen können.

Microsoft Exchange Online

Parameter

Typ

Beschreibung

Beispiel

Standard

mas.graph.service.page-size

Zahl

Optional: Maximale Größe der Ergebnisse pro Graph API-Anfrage.

Der Wert sollte nicht größer als 999 sein.

999

999

mas-mailbox.health-cache-duration

 Zahl Aufwendige Health Checks zur Auflösung von Postfächern gegen Active Directorys werden zwischengespeichert. Angabe in Stunden. 6 6

mas-mailbox.journaling.mailboxes

String

Optional: Konfiguration eines alternativen Journalpostfachs.

Erforderlich für die Angabe:

  • mailbox - E-Mailadresse eines Postfachs.

  • read‑folder - Postfachordner, aus dem gelesen wird - case senitiv.

  • message‑mode - Legt fest, welche Art von Nachrichten aus dem Postfach gelesen werden. Verfügbare Werte:

    • JOURNAL
      Wird verwendet, wenn das Postfach Journalberichte speichert.
    • ALTERNATE
      Wird verwendet, wenn das Postfach Non-Delivery Reports speichert.
    • NORMAL
      Wird verwendet, wenn das Postfach herkömmliche E-Mails speichert.

Zusätzlich können weitere Postfächer hier angegeben werden.

 
journaling-mailboxes
  - mailbox: name@muster.de
    read-folder: Inbox
    message-mode: ALTERNATE
  - mailbox: user@muster.de
    read-folder: Inbox
    message-mode: JOURNAL
 -
mas-mailbox.categories.archived String

Postfach-Archivierung:

Kategorie für eine E-Mail, die erfolgreich verarbeitet wurde.		 Archiviert Archived
mas-mailbox.categories.error String

Postfach-Archivierung:

Kategorie für eine E-Mail, die aufgrund von Fehlern nicht verarbeitet werden konnte.		 Archivierungsfehler Error
mas-mailbox.archiving.mailboxes String Liste der primären Postfächer, gemeinsamen Postfächer und Verteilerlisten für die Archivierung.

- name@muster.de

- group@muster.de

 -
mas-mailbox.archiving.groups Kommaseparierte Liste Liste von Active Directory-Gruppen vom Typ 'Verteilergruppe' für die Archivierung.

Team group,Developers group

 -
mas-mailbox.archiving.whitelist Kommaseparierte Liste Postfachordner, aus denen E-Mails aus Postfächern zur Archivierung abgeholte werden - case sensitive. Inbox,Sent -
mas-mailbox.archiving.blacklist Kommaseparierte Liste Postfachordner, aus denen keine E-Mails abgeholte werden - case sensitive. Outbox,Personal -
mas-mailbox.archiving.rules.mail-date Kommaseparierte Liste

Zeitbasierte Regel für das Abholen von E-Mails.

Werte:

  • BEFORE

    E-Mails die vor einem Datum empfangen wurden.

  • AFTER

    E-Mails die an oder nach einem Datum empfangen wurden.

Datumsformat: DD-MM-YYYY

Wert und Datum werden durch '|' getrennt.

 BEFORE|01-01-2025 -
mas-mailbox.archiving.rules.mail-size Kommaseparierte Liste

Größenbasierte Regel für das Abholen von E-Mails.

Werte in MB:

  • LT

    E-Mails die kleiner als angegeben sind.

  • GTE

    E-Mails die größer oder gleich groß wie angegeben sind.

Wert und Größe werden durch '|' getrennt.

 LT|10 -
mas-mailbox.archiving.rules.mail-state Kommaseparierte Liste

Lesestatusbasierte Regel für das Abholen von E-Mails.

Werte

  • ALL

    Alle E-Mails.

  • READ

    Gelesene E-Mails.

  • UNREAD

    Ungelesene E-Mails.

 READ ALL
mas-mailbox.archiving-exclusions.mailboxes Kommaseparierte Liste

Online und on-premises:

Postfächer, die in E-Mails als 'An', 'Von' oder 'CC' vorkommen und aus denen E-Mails nicht abgeholt werden - case insensitive.

 example@mail.com, example2@mail.com -
mas-mailbox.archiving-exclusions.subject-keywords Kommaseparierte Liste

Online und on-premises:

Schlüsselbegriffe, die im Betreff von E-Mails vorkommen, die nicht abgeholt werden - case insensitive.

 keyword1, keyword2, keyword3 -
mas-mailbox.archiving-exclusions.exclusion-category String

Online und on-premises:

Kategorie für E-Mails, die durch die 'exclusion'-Einschränkungen nicht abgeholt wurden.

 Archivierung übersprungen Skipped archiving
mas-mailbox.archiving.retention-policy.age-condition String

Retentionszeit: erfolgreich archivierte E-Mails werden nach einer Zeitspanne aus den Postfächern löscht.

Angabe in Tagen (D), Monaten (M), Jahren (Y), getrennt durch '|'.

 Y|5 -
mas-mailbox.archiving.retention-policy.deletion-schedule String

Zeitpunkt im 6-stelligen Cron-Format, zu dem das Löschen täglich ausgeführt wird.

Angabe in einfachen Anführungszeichen.

 '0 * * * * *' '0 0 2 * * *'
Anlagen extrahieren
mas-mailbox.attachment-extraction.mode String

Modus der Extraktion von Anlagen:

  • NONE

    Keine Extraktion.

  • LINKS

    Extraktion und enaio® webclient-Link auf Anlagen-Dokument einfügen.

  • FILES

    Extraktion und enaio® client-Link auf Anlagen-Dokument einfügen.

  • BOTH

    Extraktion und enaio® webclient- und enaio® client-Link auf Anlagen-Dokument einfügen.

 LINKS NONE
mas-mailbox.attachment-extraction.schedule String

Zeitpunkt im 6-stelligen Cron-Format, zu dem das Extrahieren täglich ausgeführt wird.

Angabe in einfachen Anführungszeichen.

 '0 * * * * *' '0 0 3 * * *'
mas-mailbox.attachment-extraction.delay String

Zeitspanne, nachdem das Extrahieren für erfolgreich angelegte E-Mails frühestens ausgeführt wird.

Angabe in Tagen (D), Monaten (M), Jahren (Y), getrennt durch '|'.

Als Standard wird das Extrahieren direkt nach der erfolgreichen Anlage ausgeführt.

 D|30

0
mas-mailbox.attachment-extraction.categories.success String Kategorie für E-Mails, deren Anlage erfolgreich extrahiert wurde. Anlage extrahiert AttExtracted
mas-mailbox.attachment-extraction.categories.error String Kategorie für E-Mails, deren Anlage nicht extrahiert werden konnte. Anlage nicht extrahiert AttNotExtracted

Microsoft Exchange on-premises

Parameter

Typ

Beschreibung

Beispiel

Standard

mas-mailbox.onprem.health-cache-duration

 Zahl Aufwendige Health Checks zur Auflösung von Postfächern gegen Active Directorys werden zwischengespeichert. Angabe in Stunden. 6 6

mas-mailbox.onprem.journaling.mailboxes

String

Optional: Konfiguration eines alternativen Journalpostfachs.

Erforderlich für die Angabe:

  • mailbox - E-Mailadresse eines Postfachs.

  • read‑folder - Postfachordner, aus dem gelesen wird - case senitiv.

  • message‑mode - Legt fest, welche Art von Nachrichten aus dem Postfach gelesen werden. Verfügbare Werte:

    • JOURNAL
      Wird verwendet, wenn das Postfach Journalberichte speichert.
    • ALTERNATE
      Wird verwendet, wenn das Postfach Non-Delivery Reports speichert.
    • NORMAL
      Wird verwendet, wenn das Postfach herkömmliche E-Mails speichert.

Zusätzlich können weitere Postfächer hier angegeben werden.

 
mas-mailbox:
onprem:
  journaling:
    mailboxes:
      - mailbox: name@muster.de
        read-folder: Inbox
        message-mode: NORMAL   
      - mailbox: journal@muster.de
        read-folder: Posteingang
        message-mode: JOURNAL
 -
mas-mailbox.onprem.categories.archived String

Postfach-Archivierung:

Kategorie für eine E-Mail, die erfolgreich verarbeitet wurde		 Archived Archived
mas-mailbox.onprem.categories.error String

Postfach-Archivierung:

Kategorie für eine E-Mail, die aufgrund von Fehlern nicht verarbeitet werden konnte.		 ErrorArchive Error
mas-mailbox.onprem.archiving.mailboxes String Liste der primären Postfächer, gemeinsamen Postfächer und Verteilerlisten für die Archivierung.

- name@muster.de

- group@muster.de

 -
mas-mailbox.onprem.archiving.groups Kommaseparierte Liste Liste von Active Directory-Gruppen vom Typ 'Verteilergruppe' für die Archivierung.

group@muster.de,dev@muster.de

 -
mas-mailbox.onprem.archiving.whitelist Kommaseparierte Liste

Postfachordner, aus denen E-Mails aus Postfächern zur Archivierung abgeholte werden - case sensitive.

 Inbox,Sent -
mas-mailbox.onprem.archiving.blacklist Kommaseparierte Liste

Postfachordner, aus denen keine E-Mails abgeholte werden - case sensitive.

 Outbox,Personal -
mas-mailbox.onprem.archiving.rules.mail-date Kommaseparierte Liste

Zeitbasierte Regel für das Abholen von E-Mails.

Werte:

  • BEFORE

    E-Mails die vor einem Datum empfangen wurden.

  • AFTER

    E-Mails die an oder nach einem Datum empfangen wurden.

Datumsformat: DD-MM-YYYY

Wert und Datum werden durch '|' getrennt.

 BEFORE|01-01-2025 -
mas-mailbox.onprem.archiving.rules.mail-size Kommaseparierte Liste

Größenbasierte Regel für das Abholen von E-Mails.

Werte in MB:

  • LT

    E-Mails die kleiner als angegeben sind.

  • GTE

    E-Mails die größer oder gleich groß wie angegeben sind.

Wert und Größe werden durch '|' getrennt.

 LT|10 -
mas-mailbox.onprem.archiving.rules.mail-state Kommaseparierte Liste

Lesestatusbasierte Regel für das Abholen von E-Mails.

Werte

  • ALL

    Alle E-Mails.

  • READ

    Gelesene E-Mails.

  • UNREAD

    Ungelesene E-Mails.

 READ ALL
mas-mailbox.archiving-exclusions.mailboxes Kommaseparierte Liste

Online und on-premises:

Postfächer, die in E-Mails als 'An', 'Von' oder 'CC' vorkommen und aus denen E-Mails nicht abgeholt werden - case insensitive.

 example@mail.com, example2@mail.com -
mas-mailbox.archiving-exclusions.subject-keywords Kommaseparierte Liste

Online und on-premises:

Schlüsselbegriffe, die im Betreff von E-Mails vorkommen und nicht abgeholt werden - case insensitive.

 keyword1, keyword2, keyword3 -
mas-mailbox.archiving-exclusions.exclusion-category String

Online und on-premises:

Kategorie für E-Mails, die durch die 'exclusion'-Einschränkungen nicht abgeholt wurden.

 Archivierung übersprungen Skipped archiving
mas.onprem-mailbox-related-storage.folder-name-config.domains Kommaseparierte Liste

Falls angegeben, müssen alle Postfächer Teil der angegebenen Domänen sein.

Andernfalls meldet der Health Check den Status DOWN.

 test.de, dev.org -
mas.onprem-mailbox-related-storage.folder-name-config.property String

Wert, der für Ordner-Indexierungen verwendet wird, wenn andere Daten nicht vorliegen.

Werte: USERNAME, DISPLAY_NAME, FIRST_NAME, LAST_NAME

 LAST NAME USERNAME
mas-mailbox.onprem.archiving.retention-policy.age-condition String

Retentionszeit: erfolgreich archivierte E-Mails werden nach einer Zeitspanne aus den Postfächern löscht.

Angabe in Tagen (D), Monaten (M), Jahren (Y), getrennt durch '|'.

 Y|5 -
mas-mailbox.onprem.archiving.retention-policy.deletion-schedule String

Zeitpunkt im 6-stelligen Cron-Format, zu dem das Löschen täglich ausgeführt wird.

Angabe in einfachen Anführungszeichen.

 '0 * * * * *' '0 0 2 * * *'
Anlagen extrahieren
mas-mailbox.onprem.attachment-extraction.mode String

Modus der Extraktion von Anlagen:

  • NONE

    Keine Extraktion.

  • LINKS

    Extraktion und enaio® webclient-Links auf Anlagen-Dokumente einfügen.

  • FILES

    Extraktion und enaio® client-Links auf Anlagen-Dokumente einfügen.

  • BOTH

    Extraktion und enaio® webclient- und enaio® client-Links auf Anlagen-Dokumente einfügen.

 LINKS NONE
mas-mailbox.onprem.attachment-extraction.schedule String

Zeitpunkt im 6-stelligen Cron-Format, zu dem das Extrahieren täglich ausgeführt wird.

Angabe in einfachen Anführungszeichen.

 '0 * * * * *' '0 0 3 * * *'
mas-mailbox.onprem.attachment-extraction.delay String

Zeitspanne, nachdem das Extrahieren für erfolgreich angelegte E-Mails frühestens ausgeführt wird.

Angabe in Tagen (D), Monaten (M), Jahren (Y), getrennt durch '|'.

Als Standard wird das Extrahieren direkt nach der erfolgreichen Anlage ausgeführt.

 D|30

0
mas-mailbox.onprem.attachment-extraction.categories.success String Kategorie für E-Mails, deren Anlage erfolgreich extrahiert wurde. Anlage extrahiert AttExtracted
mas-mailbox.onprem.attachment-extraction.categories.error String Kategorie für E-Mails, deren Anlage nicht extrahiert werden konnte. Anlage nicht extrahiert AttNotExtracted