haraka-plugin-domain-aliases

This plugin is derived from "aliases" plugin: https://github.com/haraka/haraka-plugin-aliases

Every functionality of haraka-plugin-aliases is available in haraka-plugin-domain-aliases. Additionally, with this plugin, it is possible to convey all the incoming e-mails for a domain to another domain.

& IMPORTANT: this plugin must appear in config/plugins before other plugins that run on hook_rcpt

& WARNING: DO NOT USE THIS PLUGIN WITH queue/smtp_proxy.

Configuration

Available actions:

• drop
• alias
  • to (required)
• domain-alias
  • to (required)

Aliases

JSON file inside the config folder must be filled with pre-determined types of "actions". Example:

{ "test1" : { "action" : "drop" } }

Aliases of 'user', '@host' and 'user@host' possible:

{ "demo" : { "action" : "drop" } }

{ "@example.com" : { "action": "alias", "to": ["[email protected]"] } }

{ "[email protected]" : { "alias", "to": ["[email protected]"] } }

For more information, please check: https://github.com/haraka/haraka-plugin-aliases.

Domain Aliases

Maps the alias domain to the domain specified in the "to" option. Both the original alias and the recipient (target) alias should only consist of host, in the form of @host. Example:

{ "@haraka.test" : { "action" : "domain-alias", "to" : "@domain.com" } }

This configuration will forward any e-mail sent to [email protected] to [email protected].

Alias matching order

Larger and more specific aliases match first and "alias" action has precedence over "domain-alias".

{
 "[email protected]" : { "action" : "alias", "to" : "[email protected]" },
 "@haraka.test" : { "action" : "domain-alias", "to" : "@example.com" }
}
or
{
 "@haraka.test" : { "action" : "domain-alias", "to" : "@example.com" },
 "[email protected]" : { "action" : "alias", "to" : "[email protected]" }
}

Both configurations above will work the same. If the recipient's e-mail address of the sent mail is [email protected], the mail will be forwarded to [email protected]. However, if the address is [email protected], it will be forwarded to [email protected].

Example Configuration

{
    "test1" : { "action" : "drop" },
    "test2" : { "action" : "alias", "to" : "non-test2" },
    "test3" : { "action" : "alias", "to" : "test3" },
    "test4" : { "action" : "alias", "to" : "[email protected]" },
    "[email protected]" : { "action" : "alias", "to" : "[email protected]" }
    "[email protected]" : { "action" : "alias", "to" : "[email protected]" },
    "@domain.com" : { "action" : "domain-alias", "to" : "@example.com" }
}