change README.md

This commit is contained in:
2022-01-10 17:19:27 +01:00
parent 6e9a280864
commit 3ff33aadf8

View File

@@ -47,9 +47,8 @@ Global config options:
### Rule ### Rule
Rule config options: Rule config options:
* **name** (optional) * **name**
Name of the rule. Name of the rule.
Default: **Rule #n**
* **actions** * **actions**
A list of action objects which are processed in the given order. A list of action objects which are processed in the given order.
* **conditions** (optional) * **conditions** (optional)
@@ -61,13 +60,12 @@ Rule config options:
### Action ### Action
Action config options: Action config options:
* **name** (optional) * **name**
Name of the action. Name of the action.
Default: **Action #n**
* **type** * **type**
See section [Actions](#Actions). See section [Actions](#Actions).
* **options** * **options**
Options for the action according to action type (as described below). Options for the action according to action type (see section [Actions](#Actions)).
* **conditions** (optional) * **conditions** (optional)
A list of conditions which all have to be true to process the action. A list of conditions which all have to be true to process the action.
* **loglevel** (optional) * **loglevel** (optional)
@@ -76,7 +74,7 @@ Action config options:
See section [Global](#Global). See section [Global](#Global).
### Actions ### Actions
The following action types are available. The following action types and options are available.
* **add_header** * **add_header**
Add new header. Add new header.
* **field** * **field**
@@ -126,12 +124,44 @@ The following action types are available.
* **store** * **store**
Store e-mail. Store e-mail.
* **type** * **type**
Storage type. Possible values are: See section [Storages](#Storages).
* **file**
* **original** (optional) * **original** (optional)
If set to true, store the message as received by the MTA instead of storing the current state of the message, that may was modified already by other actions. If set to true, store the message as received by the MTA instead of storing the current state of the message, that may was modified already by other actions.
Default: **false** Default: **false**
* **metadata** (optional)
Store metadata.
Default: **false**
* **metavar** (optional)
If set, some information (e.g. storage id) is saved as meta variables for later use.
* **notify**
Send notification to receiver.
* **type**
See section [Notifications](#Notifications).
* **quarantine**
Quarantine e-mail.
* **store**
Options for e-mail storage (see action **store** in section [Actions](#Actions)).
* **smtp_host**
SMTP host used to release e-mails from quarantine.
* **smtp_port**
SMTP port used to release e-mails from quarantine.
* **notify** (optional)
Options for e-mail notifications (see action **notify** in section [Actions](#Actions)).
* **milter_action** (optional)
Milter action to perform. Possible values are:
* **ACCEPT** (Tell MTA to accept the e-mail, skip following rules/actions.)
* **REJECT** (Tell MTA to reject the e-mail.)
* **DISCARD** (Tell MTA to discard the e-mail.)
* **reject_reason** (optional)
Reject message if milter_action is set to reject.
Default: **Message rejected**
* **whitelist** (optional)
Options for a whitelist (see **whitelist** in section [Conditions](#Conditions)).
### Storages
The following storage types are and options are available:
* **file** * **file**
* **directory** * **directory**
Directory used to store e-mails. Directory used to store e-mails.
@@ -139,20 +169,28 @@ The following action types are available.
Store metadata file. Store metadata file.
Default: **false** Default: **false**
* **mode** (optional) * **mode** (optional)
Set file mode. File mode when new files are created.
Default: system default Default: mode set by the system
* **metavar** (optional)
If set, some information (e.g. storage id) is saved as meta variables for later use.
* **notify**
Send notification to receiver.
* **quarantine**
Quarantine message.
* **rewrite_links**
Rewrite links in html body part.
### Notifications
The following notification types and options are available:
* **email**
* **smtp_host**
SMTP host used to send notifications.
* **smtp_port**
SMTP port used to send notifications.
* **envelope_from**
Envelope-From address.
* **from_header**
Value of the From header.
* **subject**
Subject of the notification.
* **template**
Notification template.
* **repl_img** (optional)
Replacement image used to replace all images in the e-mail body.
* **embed_imgs** (optional)
List of images to embed into the notification e-mail.
### Conditions ### Conditions
Config options for **conditions** objects: Config options for **conditions** objects:
@@ -164,7 +202,10 @@ Config options for **conditions** objects:
A regular expression to match against the evenlope-from addresses for which the rule should be executed. A regular expression to match against the evenlope-from addresses for which the rule should be executed.
* **envto** (optional) * **envto** (optional)
A regular expression to match against all evenlope-to addresses. All addresses must match to fulfill the condition. A regular expression to match against all evenlope-to addresses. All addresses must match to fulfill the condition.
* **headers** (optional)
* **whitelist** (optional)
* **var** (optional)
* **metavar** (optional)
## Developer information ## Developer information
Everyone who wants to improve or extend this project is very welcome. Everyone who wants to improve or extend this project is very welcome.