SMTP Addresses Tab: Swap Proxy
Created: 2012-04-20 08:09:59Modified: 2023-03-30 10:31:59
Tags: Active Directory AD LDS ADAM Address Manipulation Exchange 20xx UnitySync
When syncing LDAP directories, you have the option to manipulate proxyaddress, swapping a secondary smtp up to be the primary *SMTP**.
Typically an Exchange mailbox is given a primary SMTP address. This address is the user’s reply-to address. Secondary smtp addresses can be added that allow the user to receive email using other addresses.
UnitySync’s Swap Proxy function reads through the proxyaddresses using a rule-set. If a match occurs, that address becomes the primary address and the old primary address is pushed into the proxy list.
The swapping logic looks like this:
Read the domain part of each proxy addresses and compare, in order, against those you have supplied in the Swap Proxy parameter.
When a match is found:
- Swap the matching secondary smtp proxyaddress, making it the Primary SMTP address.
AND - Swap the original Primary SMTP address making it a secondary smtp proxyaddresses
- Swap the matching secondary smtp proxyaddress, making it the Primary SMTP address.
Note, when a Swap takes place, mail and targetaddress are also set using the swapped address.
Example of Standard Swap Proxy Usage
Assume the following three records exist on your Source.
SMTP:jsmith@aol.com
smtp:james@zoomit.com
smtp:support@p.com
smtp:jim@home.com
SMTP:tsmith@aol.com
smtp:tom@zoomit.com
smtp:tommy@home.com
SMTP:bubba@slow.net
smtp:Charles@fast.net
On the ProxyAddresses tab, the Swap Proxy field is set to:
@p.com,@home.com
When a match is found:
Swap the matching smtp, making it the primary SMTP address.
Resulting three Destination Records:
SMTP: support@p.com
smtp:james@zoomit.com
smtp:jsmith@aol.com
smtp:jim@home.com
SMTP:tommy@home.com
smtp:tom@zoomit.com
smtp:tsmith@aol.com
SMTP:bubba@slow.net
smtp:Charles@fast.net (nothing is swapped)
Notes about Swap Proxy Syntax
It may or may not be necessary to include the @ prefix in the Swap Proxy domains you specify. An example of when it IS necessary is if you have two incoming domains that look like this:
EricN@DomainXYZ.com
Eric@XYZ.com
If you specify a SwapProxy of simply XYZ.com, then both smtp addresses above qualify for swapping. Which ever is returned first will be swapped to the primary. If you specifically want the @XYZ.com domain to be primary, then you need to specify the Swap Proxy value as @XYZ.com.
There are some guidelines to the rule-set:
- The order of the swap proxy list sets the order of the search through the secondary addresses.
- The swap proxy list is done by subtring matching (no wildcards should be used)
- If a proxy is not matched the addresses are left alone.
- UnitySync will use the first proxy it matches.