Profile File 'application-mas.yml'

enaio® mail-archive-service 12.0 »

The application-mas.yml profile file contains parameters for accessing Microsoft Exchange Online or Microsoft Exchange on-premises and storage parameters. The profile is assigned to the services of enaio® mail-archive-service in the servicewatcher-sw.yml file.

The profile file is available for download as a template and must be saved in the \config\ directory of enaio® service-manager.

Configuration values such as user name, password, and IDs can be specified in the encrypted configuration file.

Microsoft Exchange Online

Parameter

Type

Description

For example

Default

mas.exchange-online.access.client-id

String

Client ID of the Azure portal.

  -

mas.exchange-online.access.tenant-id

String

Tenant ID of the Azure portal.

 

-

mas.exchange-online.access.secret

String

Client secret of the Azure portal.

 

-

mas.mailbox-related-storage.folder-name-config.domains Comma-separated list

Specifies the domains from which e-mail addresses are used to create reference documents.

The specified domains must exist in AD, otherwise the health check will result in an error.

Multiple domains are specified using comma separation.

If no domains are specified, then no reference documents will be created.

devtest.de,test-syst.com -
mas.mailbox-related-storage.folder-name-config.property String

Specifies which data from the user management of an Office 365 Active Directory is used as the value for folder indexing reference documents.

Values:

  • USERNAME

  • FIRST_NAME

  • LAST_NAME

  • DISPLAY_NAME

  • SAM_ACCOUNT_NAME

An error is logged and the e-mail address is used if the data is not available.

DISPLAY_NAME USERNAME
monitoring.trace.enabled Boolean Activates the metrics log for all MAS services. true false

 

Microsoft Exchange on-premises

Parameter

Type

Description

For example

Default

mas.exchange-onprem.access.uri

String

URI of the EWS API

https://mail.testenv.org/EWS/Exchange.asmx -

mas.exchange-onprem.access.username

String

Basic authentication:

User with impersonation role

mailaccess@testenv.org

-

mas.exchange-onprem.access.password

String

Basic authentication:

Password for the user with impersonation role

pw

-

mas.exchange-onprem.access.authority String

OAuth authentication:

Permission to receive an OAuth token

For hybrid installations: https://login.microsoftonline.com/<tenantId>

For on-premises installations: https://<ADFS-server>/adfs/

https://login.microsoftonline.com/450aaaaa-bbb0-4ccc-8111-7abcd55a515a/ -
mas.exchange-onprem.access.scope String

OAuth authentication:

Scope requested for OAuth tokens

For hybrid installations: .default

For on-premises installations: .user_impersonation

https://mail.osdevtest.org/.default -
mas.exchange-onprem.access.client-id String

OAuth authentication:

Client ID for retrieving the OAuth token
df5WNph -
mas.exchange-onprem.access.client-certificate String

OAuth authentication:

Client certificate (in PEM format) for retrieving the OAuth token

The content of the certificate must be specified exactly with line breaks and headers.

Use '|' for formatting.

  -
mas.exchange-onprem.access.client-private-key String

OAuth authentication:

Client key (in PEM format) for retrieving the OAuth token

The content of the key must be specified exactly with line breaks and headers.

Use '|' for formatting.

  -
mas.exchange-onprem.access.technical-user String

OAuth authentication:

Technical user with impersonation role for the use of the OAuth token

mailaccess@testenv.org -
mas.exchange-onprem.access.version String

Version of the Exchange Server for EWS connection

Exchange 2025 Exchange 2019
mas.onprem-mailbox-related-storage.folder-name-config.domains String

Domains for restricting address resolution.

Used to retrieve the correct folder for reference documents of each e-mail that belong to the configured domains.

Due to technical limitations, it is not possible to check the existence of domains within the configured AD.

The entries must therefore be valid.

testenv.de,opt-syst.com

-

No restriction

mas.onprem-mailbox-related-storage.folder-name-config.property String

Specifies which data from the user management of an Office 365 Active Directory is used as the value for folder indexing reference documents.

Values:

  • USERNAME

  • FIRST_NAME

  • LAST_NAME

  • DISPLAY_NAME

  • SAM_ACCOUNT_NAME

An error is logged and the e-mail address is used if the data is not available.

DISPLAY_NAME USERNAME
monitoring.trace.enabled Boolean Activates the metrics log for all MAS services. true false