4.7 Address Transformation Manager

Address Transformation Manager allows you to transform an incoming or outgoing email address to a different email address. Very useful for mergers and acquisitions or other name changes.

Address Transformation Manager is not OU aware, it needs to know what the addresses are independently of the OU, we need all the address information. This does not change the MIME file, it just changes the SMTP transactions and routes to the new domain.

Address transformation appears to the interface only, not the filtering engine. The filter will get the original address. You may need to create a filter for both the original and target transformed recipient.

There are two parts: The transformation and the interface. Once a transformation has been created it needs to be enabled in an interface, currently only the SMTP interface is supported.

This feature is found under Module Management | Address Transformation Manager.

Add New: Click the “Add New” button to create a new address transformation.

Provide the transformation a name: For example, “gwava to microfocus” or “icecream2custard” or “left>right”.

Enable rewrite rule: Enable or disable the rule.

Notes: A text field for a reminder to your future self on why you set this up.

Serviced interfaces: Enable the interface the rule should be applied to or enable in the Interface.

Apply to the inbound mail: Enable to apply to inbound mail.

Apply to the outbound mail: Enable to apply to outbound mail.

Apply to sender: Enable to apply to senders.

Apply to recipient(s): Enable to apply to the recipient.

Rewrite rules section

The rule matches a pattern and then replaces the pattern according to the rules you set.

Match pattern

Patterns can be matched with a complete email address such as “user.oldLastName@myDomain.com” or with wildcards such as “*.yourDomain”. You may even use “*@*” to transform everything that comes in.

Replace pattern

The replace pattern depends on the match pattern you entered.

Examples:

Transform a Domain: If you merged with another company, you may find the need to transform the old email addresses to the new ones. You would use:

Match: *@oldDomain.com with Replace: $1@newDomain.com

Transforms user@oldDomain.com into user@newDomain.com

Transform a Single Email Address: If a user changed their name, you can transform any incoming mail to their old name to their new name.

Match: userOriginalAddress@myDomain.com with Replace: userNewAddress@myDomain.com

Transforms userOldLastName@myDomain.com into userNewLastName@myDomain.com

Change Domain Case: To change the case of your domain.

Match: *@DOMAIN.ORG with Replace: $1@domain.org

Transforms user1@DOMAIN.ORG into user1@domain.org. What is happening is $1 = the wildcard “*” and $2 = “@DOMAIN.ORG”.

Change Domain TLD: If you have changed your TLD you can transform the address and move the old TLD so you know who is still using the old address.

Match: user@Domain.* with Replace: $2/$1com to preserve domain case structure or $2/user@domain.com to also change the domain case structure at the same time.

Transforms user@Domain.org with org/user@Domain.com. What is happening is $1 = “user@Domain.” and $2 = the wildcard “*”.

Transforming everything: You may use wildcards in all parts of the email address for transformations. Each wildcard transition becomes a variable.

* @ * . *

[$1][$2][$3][$4][$5]

Save the changes.

Enable Address Transformation in the SMTP Interface SMTP Interface, if not enabled under Serviced Interfaces above.

Message direction can be controlled on a per interface level in the SMTP Interface Manager. You can have one SMTP interface handle all the transformations.

In the SMTP Interface Manager, you can control Inbound, Outbound, Sender, and/or Recipient and override on a per interface level.

In the Address Transformation Manager, you generally would have a single rule to handle all address transformations. You would create additional rules when you want a rule to apply to only a single interface to make change tracking easier.