Setting server mail rules
You can create content filtering rules for that define actions to take on certain messages. When a new message that meets a specified condition is deposited in MAIL.BOX, Domino® automatically performs the designated action. Possible actions include journaling a message, moving it to a database, refusing to accept or deliver a message, changing the routing state of a message, or stopping the processing of subsequent rules. Rule conditions are based on content in the message headers or in the message body.
About this task
Mail rules automatically handle mail in a variety of
situations. By configuring a set of conditions and actions, you can
customize rules to block spam mail or intercept messages with questionable
content. For example, you could create a rule that rejects mail that
includes a suspicious subject line, such as MAKE_MONEY_FAST!!!
,
or messages originating from a known spam vendor. Similarly you can
restrict users from receiving message attachments that do not have
a business purpose by setting up a rule to intercept messages that
contain attachments of certain file types (EXE, VBS, VBE, SCR, and
so forth) and redirect them to a quarantine database where they could
be reviewed by an administrator and optionally sent on to the intended
recipient.
Except where a rule action explicitly indicates, Domino does not notify the sender or recipient if a rule prevents a message from reaching its destination. For example, if a rule results in a message being routed to a graveyard database, Domino does not generate a delivery failure report or indicate to the intended recipients that a message for them has been intercepted. By contrast, if a message triggers a rule with the specified two-part action Don't deliver message/ Send NDR, the sender receives a delivery failure report stating that the message was rejected for policy reasons.
Mail rules are not intended to serve as an anti-virus solution and should not be considered a replacement for anti-virus software. Although you can configure rules to quarantine messages with known virus attachments, the available rule actions do not include typical anti-virus features such as generating warnings upon detecting a virus or automatically disinfecting files.
Domino stores the mail rules you create in the Configuration Settings document. On startup, each server retrieves from the appropriate Configuration Settings document and registers them as monitors on each MAIL.BOX database in use.
Whenever MAIL.BOX receives a new message from any source -- the SMTP process, the Router on another server, or a client depositing a message -- the server evaluates the various message fields against the registered mail rules. Each message is evaluated only once. Additional updates occurring after a message is added to MAIL.BOX -- such as updates to reflect the number of recipients handled -- do not cause reevaluation of the rules.
Stopping the processing of a mail rule
About this task
When setting up mail rules, you can use a stop processing action to stop processing all of the rules that follow the one that contains the stop processing action. You can use the stop processing action alone, that is, as the only action in a mail rule, or you can use it with another action in a rule, and it can also be in one rule that is in a series of rules. This is especially useful when more than one rule could apply to a message, but you want execution of mail rules to stop after the first action is executed. For example, you can define the following rules:
- Rule 1) If Subject contains Marketing Move to database Marketing Information and Stop Processing Rules
- Rule 2) If Subject contains Sales Don't deliver message
Result: If the subject line contains the subject Marketing and Sales, the message is moved to the Marketing Information database and processing stops. No other action is taken on the message.
When multiple mail rules are enabled, you can set their relative priority by moving them up and down in the list.
Putting new rules into effectThe Configuration Settings document displays new mail rules only if the document has been previously saved.
When you add a new rule, it takes effect only after the server reloads the mail rules. A reload is automatically triggered if the Server task detects a rule change when performing its routine check of the Configuration Settings document. This check occurs approximately every five minutes.
You can force the server to reload rules, using a console command.
Enter the following command at the server console:
set rulesTo create a new mail rule
About this task
Procedure
Results
If MAIL.BOX receives an encrypted message (Notes encrypted, S/MIME, PGP, and so forth), the server mail rules process any rule conditions that are based on unencrypted information in the message envelope, such as the sender, importance, and recipients, but do not process conditions based on the encrypted portion of the message body. Most rule conditions are based on information in the message envelope. The server does not log instances in which rules are unable to process a message.
Specifying the message form in a condition
About this task
You can specify which types of messages a rule acts on by specifying the message form type in the rule condition. When evaluating the form type, the server checks the Notes message form used (the Form item displayed in the Document properties); it does not use form information defined in MIME items in the message. All messages deposited in MAIL.BOX are rendered as Notes documents, including inbound Internet messages in native MIME format. By default, messages received over SMTP use the Memo form, except for SMTP Nondelivery reports, which Domino renders using the NonDelivery Report form. Common Notes form names include:
- Appointment
- Delivery Report
- Memo
- NonDelivery Report
- Notice
- Reply
- Return Receipt
- Trace Report