# MailConfigurationType (Complex Type)

### Namespace: http://midpoint.evolveum.com/xml/ns/public/common/common-3

Supertype: NotificationTransportConfigurationType
Where and how to send mail notifications (or any other mail messages). DEPRECATED: Use new messageTransportConfiguration instead.

Item Summary
Name | Type | Multiplicity | Description
--- | --- | --- | ---
debug | property boolean | [0,1] | Enables debugging specific for a given transport (if supported by it).
redirectToFile | property string | [0,1] | When this transport don't have definition blackList, whiteList or recipient FilterExpression, instead of sending message via this transport, writes it to a file.
logToFile | property string | [0,1] | In addition to sending message via this transport, writes it to a file.
blackList | property string | [0,-1] | Addresses that are on a "black list".
whiteList | property string | [0,-1] | Addresses that are on a "white list".
recipientFilterExpression | property ExpressionType | [0,1] | An expression that decides whether the recipient address is allowed to pass through or it should be blacklisted.
server | property MailServerConfigurationType | [0,-1] | Configuration of a particular mail server host.
defaultFrom | property string | [0,1] | What to put into "From" field of mail messages (unless overridden by specific situation).

- ### Items

  - #### debug

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Display order:

    Enables debugging specific for a given transport (if supported by it). For example, when used for mail transport it enables debugging of javamail - sending diagnostics to standard output (console).

  - #### redirectToFile

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Display order:

    When this transport don't have definition blackList, whiteList or recipient FilterExpression, instead of sending message via this transport, writes it to a file. Useful for debugging. When is defined one of whiteList, blackList or recipientFilterExpression, the messages for allowed recipient are sent, and the messages for forbidden recipients are written to a file.

  - #### logToFile

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Display order:

    In addition to sending message via this transport, writes it to a file. Useful for debugging.

  - #### blackList

    Flags: RAM,runtime

    Multiplicity: [0,-1]

    Display order:

    Addresses that are on a "black list". If a message contains one or more addresses that are blacklisted, it is stored into file specified in "redirectToFile" and either not sent at all (if no other addresses remain) or sent without blacklisted addresses. An address can contain "*" character, that matches any substring, e.g. "*@acme.org". At most one of "blackList", "whiteList" and "recipientFilterExpression" can be used.

  - #### whiteList

    Flags: RAM,runtime

    Multiplicity: [0,-1]

    Display order:

    Addresses that are on a "white list". If specified, then all addresses are blacklisted, except for those that match a white list entry. An address can contain "*" character, that matches any substring, e.g. "*@acme.org". At most one of "blackList", "whiteList" and "recipientFilterExpression" can be used.

  - #### recipientFilterExpression

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Display order:

    An expression that decides whether the recipient address is allowed to pass through or it should be blacklisted. The expression expects input value in "recipientAddress" variable (usually a String), and should provide a boolean value: "true" means "pass through", "false" means "block". At most one of "blackList", "whiteList" and "recipientFilterExpression" can be used.

  - #### server

    Flags: RAM,runtime

    Multiplicity: [0,-1]

    Display order:

    Configuration of a particular mail server host. If there are more of them, they are tried one after another. If there is none, mail notifications are not sent.

  - #### defaultFrom

    Flags: RAM,runtime

    Multiplicity: [0,1]

    Display order:

    What to put into "From" field of mail messages (unless overridden by specific situation).