'mas-mailbox' Configuration

enaio® mail-archive-service • 11.0 »

Configuration parameters of the masmailbox-prod.yml file for journaling and mailbox archiving.

A customizable configuration file is available to download, which you can use as a basis for the configuration.

Parameter

Type

Description

For example

Default

mas.graph.service.page-size

Number

Optional: maximum size of results per Graph API query. The value should not be greater than 999.

999

999

mas-mailbox.health-cache-duration

 Number Elaborate health checks for resolving mailboxes contrary to active directories are cached. UR information in hours. 6 6

mas-mailbox.journaling.mailboxes

String

Optional: configuration of an alternative journal mailbox.

Specification requirements:

  • mailbox – a mailbox’s e-mail address

  • read-folder – mailbox folder to read from – case sensitive.

  • message‑mode – specifies what type of messages are read from the mailbox. Available values:

    • JOURNAL
      Used when the mailbox stores journal reports.
    • ALTERNATE
      Used when the mailbox stores non-delivery reports.
    • NORMAL
      Used when the mailbox stores normal e-mails.

Additional mailboxes can also be specified here.

 
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

Mailbox archiving:

category for an e-mail that has been successfully processed.		 Archived Archived
mas-mailbox.categories.error String

Mailbox archiving:

Category for an e-mail that could not be processed due to errors.		 ErrorArchive Error
mas-mailbox.archiving.mailboxes String List of primary mailboxes, shared mailboxes, and distribution lists for archiving

- name@example.de

- group@example.de

 -
mas-mailbox.archiving.groups Comma-separated list List of Active Directory groups of type 'Distribution group' for archiving

Team group,Developers group

 -
mas-mailbox.archiving.whitelist Comma-separated list Mailbox folders from which e-mails are retrieved from mailboxes for archiving – case sensitive. Inbox,Sent -
mas-mailbox.archiving.blacklist Comma-separated list Mailbox folders from which no e-mails are retrieved – case sensitive Outbox,Personal -

Encryption of Configuration Values

The configuration values in the masmailbox-prod.yml file located in the \config\ directory of enaio® service-manager can be encrypted:

  • Open the command prompt as the administrator and change to the \service-manager\tools\encryption\ directory.

  • Run the following command: encode.bat "value" -W.

    The encrypted value is displayed in round brackets with 'ENC' before it: ENC(encryptedvalue).

  • Copy the encrypted value with the leading 'ENC' and with the round brackets and enter it into the configuration file.

  • Save the configuration and restart the service, if necessary.

If the value to be encrypted contains quotation marks or ends with a backslash, these characters must be preceded by the backslash.
Example: encode.bat "passwordwith\"quotation\"marks" -W

IP Filters

IP filters can be set up, both for access to services and for access to management endpoints, in order to access individual or even all services.

Configurations for individual services have priority over configurations for all services via the application-prod.yml configuration file.