This is an automated email from the ASF dual-hosted git repository. btellier pushed a commit to branch master in repository https://gitbox.apache.org/repos/asf/james-project.git
commit b8c45f8a83967215d29d5871c0e377f350c29c6f Author: Khanh Le <[email protected]> AuthorDate: Tue Jul 23 17:31:26 2019 +0700 JAMES-2842 AddressMappingRoutes markdown documentation --- src/site/markdown/server/manage-webadmin.md | 31 ++++++++++++++++++++++++++++- 1 file changed, 30 insertions(+), 1 deletion(-) diff --git a/src/site/markdown/server/manage-webadmin.md b/src/site/markdown/server/manage-webadmin.md index 848de88..bc9a08b 100644 --- a/src/site/markdown/server/manage-webadmin.md +++ b/src/site/markdown/server/manage-webadmin.md @@ -1548,7 +1548,22 @@ Response codes: ## Address Mappings +You can use **webadmin** to define address mappings. + +When a specific email is sent to the base mail address, every destination addresses will receive it. + +This feature uses [Recipients rewrite table](/server/config-recipientrewritetable.html) and requires +the [RecipientRewriteTable mailet](https://github.com/apache/james-project/blob/master/server/mailet/mailets/src/main/java/org/apache/james/transport/mailets/RecipientRewriteTable.java) +to be configured. + +Note that email addresses are restricted to ASCII character set. Mail addresses not matching this criteria will be rejected. + +Please use address mappings with caution, as it's not a typed address. If you know the type of your address (forward, alias, domain, group, etc), prefer using the corresponding routes to those types. + +Here are the following actions available on address mappings: + - [List all address mappings](#List_all_address_mappinig) + - [Add an address mapping](#Add_an_address_mapping) ### List all address mappings @@ -1599,6 +1614,20 @@ Response body: Response code: - 200: OK +### Add an address mapping + +``` +curl -XPOST http://ip:port/mappings/address/{mappingSource}/targets/{destinationAddress} +``` +Add an address mapping to the [Recipients rewrite table](/server/config-recipientrewritetable.html) +Mapping source is the value of {mappingSource} +Mapping destination is the value of {destinationAddress} +Type of mapping destination is Address + +Respond code: +- 204: NO CONTENT +- 400: INVALID PARAMETERS + ## Administrating mail repositories - [Create a mail repository](#Create_a_mail_repository) @@ -2924,7 +2953,7 @@ Messages in the Deleted Messages Vault of a specified user that are matched with } ``` - - For restoring all deleted messages, passing a query json with an empty criterion list to represent `matching all deleted messages`: + - For restoring all deleted messages, passing a query json with an empty criterion list to represent `matching all deleted messages`: ``` { --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]
