Configuring Address Alteration Definitions and Policies

Document created by user.oxriBaJeN4 Employee on Sep 11, 2015Last modified by user.oxriBaJeN4 Employee on Apr 2, 2019
Version 21Show Document
  • View in full screen mode

An Address Alterations policy modifies the email address that inbound or outbound messages are sent to, as they are processed for delivery. For example:

  • A merger requires all messages going to the acquired company, to be sent to the acquiring company's domain.
  • Your organization needs to modify address information based on mail flow (e.g. inbound messages destined for '' should be delivered to '').
  • Any sender from a Support Desk group sending an outbound email, needs the 'From' address to appear as if it's sent from the '' group address.


Configuring Address Alteration Definitions




Consider the following before creating a definition:

  • Address Alteration definitions can be created in any folder, including the Root folder. This determines if a policy is required:
    Root FolderNo policy is required. Anytime a match is found, the address is rewritten.
    Sub FolderCreate a definition if you only want certain addresses to be amended in certain traffic flows. In this instance, an Address Alteration policy must be configured to specify when the address alteration applies.
  • The destination server must be configured to accept inbound email with the altered address.
  • If messages with rewritten addresses cannot be delivered to the next hop mail server, the postmaster sends the Non-Delivery Report (NDR) to the new rewritten address (not the original address).
  • Address rewrites can support the concept of specificity. In a rewrite set, ‘one to one’ email addresses take preference over local part policies, which in turn take preference over domain level rewrites.
  • When searching the archive, you must search for the address specified in the 'New Address' field of the Address Alteration definition. The search is unable to find the 'Old Address'.


Configuring One Address Alteration Definition


To configure one Address Alteration definition:

  1. Log on to the Administration Console.
  2. Click on the Administration menu item. A menu drop down is displayed.
  3. Click on the Gateway | Policies menu item.
  4. Click on the Definitions drop down. A list of the definition types is displayed.
    Definition List
  5. Click on the Address Alteration Sets definition type from the list. The list of definitions is displayed.
  6. Click either:
    • The definition to be changed.
    • The New Address Alteration button to create a definition.
  7. Complete the Address Alteration Properties as follows:
    Field / OptionDescription
    Original AddressEnter the original email address.
    New AddressEnter the new email address.
    Applied RouteSpecifies the route for inbound, outbound, or inbound and outbound messages.
    Address TypeSpecify what address type will be altered. The options are:
    Address TypeDescription
    Applies to All AddressesAll header and envelope addresses are modified.
    Envelope FROM AddressOnly the main sender SMTP address is modified.
    Envelope TO AddressOnly the main recipient SMTP address is modified.
    Header [From] AddressOnly the main sender header address is modified.
    Header [Reply-To] AddressOnly the reply to header address is modified. This can be used where the address details must not be modified, unless the recipient chooses to reply to a message. In this instance the message can be sent to a different email address / domain.
    Header [To/Cc/Bcc] Address(es)The header addresses contained in any of the To, CC, or BCC fields are modified.
    Header [Sender} AddressThe header address contained in the sender field is modified.
  8. Click on the Save and Exit button.
    An asterisk (*) can be used in the "Original Address" and "New Address" fields, to substitute email address information. For example, if * is entered in the Original Address field, all the company's email addresses will be altered to the value specified in the New Address field.

Configuring Multiple Address Alteration Definitions


To configure multiple Address Alteration definitions:

  1. Follow steps 1-5 in the "Configuring One Address Alteration Definition" section above.
  2. Click on the Build button. A drop down is displayed.
  3. Click on the Bulk Addition menu item. 
  4. Add each definition's detail on a separate line using the following format:
    FieldDescriptionValues AllowedValue Descriptions
    The "all" value allows you to specify both inbound and outbound traffic.
    2Address Typeall
    The "all" value allows you to create a rewrite entry that works on all addresses regardless of envelope or header.

    The [ ] brackets specifically indicates the envelope FROM, rather than the header FROM.

    No brackets indicate the header address.
    3Old Addresslocalpart@domainpart
    4New Addresslocalpart@domainpart
  5. Click on the Save and Exit button.
You may find it easier create a Microsoft Excel file with no header row and four columns. Export the file in a tab delimited (.TXT) format, and copy / paste the content into the text box in step 4. While simple spaces between columns are accepted, double quotes aren't.

Configuring Address Alteration Policies




Consider the following before configuring a policy:

  • Address Alteration policies must only be used if the address alterations are required for certain routes of traffic.
  • If the address alteration is specifically for the recipient address, the message is delivered to the new address only.
  • As a cloud service, we cannot affect internal emails routed in an organization's infrastructure.
  • Each policy is created based on the:
    • Header (sender or recipient) email address.
    • Envelope email address information.


Configuring an Address Alteration Policy


To configure an Address Alteration policy:

  1. Log on to the Administration Console.
  2. Click on the Administration menu item. A menu drop down is displayed.
  3. Click on the Gateway | Policies menu item. The Gateway Policy Editor is displayed.
  4. Click on Address Alterations. A list of policies is displayed.
  5. Either select the:
    • Policy to be changed.
    • New Policy button to create a policy.
  6. Complete the Options section as required:
    Field / OptionDescription
    Policy NarrativeProvide a description for the policy to allow you to easily identify it in the future.
    Select Address Alteration SetUse the Lookup button to select the required Address Alteration definition for the policy.
  7. Complete the Emails From and Emails To sections as required:
    Field / OptionDescription
    Addresses Based OnSpecify the email address characteristics the policy is based on. This option is only available in the "Emails From" section. The options are:
    The Return Address (Mail Envelope From)This default setting applies the policy to the SMTP address match, based on the message's envelope or true address (i.e. the address used during SMTP transmission).
    The Message From Address (Message Header From)Applies the policy based on the masked address used in the message's header.
    BothApplies the policy based on either the Mail Envelope From or Message Header From whichever matches. When both match the specified value, Message Header From is used.
    Applies From / ToSpecify the sender characteristics the policy is based on. For multiple policies, you should apply them from the most to least specific. The options are:
    EveryoneIncludes all email users (i.e. both internal and external). This option is only available in the "Emails From" section.
    Internal AddressIncludes only internal organization addresses.
    External AddressIncludes only external organization addresses. This option is only available in the "Emails From" section.
    Email DomainEnables you to specify a domain name to which this policy is applied. The domain name is entered in the Specifically field.
    Address GroupsEnables you to specify a predefined directory or local group. The group is selected from the Profile Group field. Click on the Lookup button to specify the group it is applicable to. Click on the Show Location field to display the path of the directory group or profile group.
    Address AttributesEnables you to specify a predefined Attribute. The attribute is selected from the Where Attribute drop down list. Once the Attribute is specified, an Attribute value must be entered in the Is Equal To field. This can only be used if attributes have been configured for user accounts.
    Individual Email AddressEnables you to specify an SMTP address. The email address is entered in the Specifically field.
  8. Complete the Validity section as required:
    Field / OptionDescription
    Enable / DisableUse this option to enable (default) or disable a policy. Disabling the policy allows you to prevent it from being applied without having to delete or back date the policy. Should the configured date range of a policy be reached the policy will become disabled automatically.
    Set Policy as PerpetualSpecifies that the policy's start and end dates are set to "Eternal", meaning the policy never expires.
    Date RangeSpecify a start and end date for the policy. This automatically deselects the "Eternal" option.
    Policy OverrideSelect this option to override the default order that policies are applied. If there are multiple applicable policies, this policy is applied first unless more specific policies of the same type have also been configured with an override.
    Bi-DirectionalIf selected, the policy also applies when the policy's recipient is the sender and the sender is the recipient.
    Source IP Ranges (n.n.n.n/x)Enter any required Source IP Ranges for the policy. These only apply if the source IP address used to transmit the message data, falls inside or matches the range(s) configured. IP ranges should be entered in CIDR notation.
  9. Click on the Save and Exit button.

See Also...