Chat now with support
Chat with Support

NOTICE! We are upgrading our support telephone services, implementing Genesys, starting the week of May 19, 2025

On Demand Migration Current - Active Directory Domain Rewrite Quick Start Guide

Validation

Validation

This section explains how to validate end users mail flow after On Demand Migration Domain Rewrite service has enabled.  For the purpose of this guide, we have configured both Rewrite Target Address and Rewrite Source Address for our test users.  Users with rewrite enabled will have their email address will be rewritten based on the rewrite mode as described below:

Rewrite with Target Address – Email sent by the user’s active mailbox in the source tenant will have the address rewritten for both outbound and inbound messages.  Demo2MBX1@Demo2.MCSLab.qsftdemo.com is the source mailbox, all external recipients will see the email address rewritten as Demo2MBX1@Demo3.MCSLab.qsftdemo.com.  

Rewrite with Source Address – Email sent by the user’s active mailbox in the target tenant will have the address rewritten for both outbound and inbound messages.  Demo2MBX2@Demo3.MCSLab.qsftdemo.com is the target mailbox, all external recipients will see the email address rewritten as Demo2MBX1@Demo2.MCSLab.qsftdemo.com.  

Be sure to review the Frequently Asked Questions section.

  1. Log in to On Demand

  2. Navigate to Migration, select the project and click on Domain Rewrite.

  3. Select the Domain Rewrite project previously configured.

  4. Click on the Total Users link.  Select “Enabled Rewrite” filter option to display all users have Rewrite enabled.  For the purpose of this guide, following users will have the below rewrite status.

    1. Rewrite with Target Address:

      1. Source User Email Address Demo2MBX1@demo2.mcslab.qsftdemo.com rewritten to Demo2MBX1@demo3.mcslab.qsftdemo.com

      2. Source User Email Address Demo2MBX3@demo2.mcslab.qsftdemo.com rewritten to Demo2MBX3@demo3.mcslab.qsftdemo.com

    2. Rewrite with Source Address:

      1. Target User Email Address Demo2MBX2@demo3.mcslab.qsftdemo.com rewritten to Demo2MBX2@demo2.mcslab.qsftdemo.com

  5. Setup Outlook Profile for one of the users with Rewrite Target Address enabled.

  6. Send an email from the source user and add the following users as the recipient

    1. An External User

    2. An user without Email Rewrite enabled in the target tenant

    3. An user with Rewrite Source Address enabled in the target tenant

  7. Log onto the external user and verify the sender email address domain name is “demo3.mcslab.qsftdemo.com”

  8. Log onto the external user and verify the recipient email address domain name for rewrite source address enabled is “demo2.mcslab.qsftdemo.com”.

  9. Log onto the target user with rewrite target address enabled and verify the sender email address domain name is “demo3.mcslab.qsftdemo.com”

  10. Log onto the target user with rewrite target address enabled and verify the recipient email address domain name for rewrite source address enabled is “demo3.mcslab.qsftdemo.com”. 

  11. Reply to the email from the external recipient and be sure to include all recipients.  Log onto Outlook Profile for source user with rewrite target address and verify all rewrite users have the email domain address rewritten back to “demo2.mcslab.qsftdemo.com”. 

 

Disable Rewrite

This section explains how disable domain rewrite service for your users using On Demand Migration Domain Rewrite.

  1. Log in to On Demand

  2. Navigate to Migration, select the project and click on Domain Rewrite.

  3. Select the Domain Rewrite project previously configured.

  4. Click on the Total Users link.  Select a user with Rewrite Source Address enabled and select Disable Email Address Rewrite from the drop down action menu and click Apply.

  5. Select Disable Email Address Rewrite and ensure the Keep Mailbox Fowarding Rule In Place option is un-selected.  Click on Submit.

  6. Allow the Email Rewrite Prepare job to finish.  After the job is completed, the User Status should be set to Disabled Rewrite, and Rewrite Status should be set to No Rewrite.

  7. Review the prepare job log and validate the following:

    1. The Source tenant mailbox’s forwarding rule should be cleared per job setting.

    2. Send an email from the target mailbox to an external user and verify the sender’s email address is not rewritten as the rewrite has been disabled.

  8. Click on the Total Users link.  Select a user with Rewrite Target Address enabled and select Disable Email Address Rewrite from the drop down action menu and click Apply.

  9. Select Disable Email Address Rewrite and ensure the Keep Mailbox Fowarding Rule In Place option is selected.  Click on Submit.

  10. Allow the Email Rewrite Prepare job to finish.  After the job has completed, the User Status should be set to Disabled Rewrite, and Rewrite Status should be set to No Rewrite.

  11. Review the prepare job log and validate the following:

    1. The Source tenant mailbox’s forwarding rule should still be configured and pointed to the source mailbox per job setting.

    2. Send an email from the source mailbox to an external user and verify the sender’s email address is not rewritten as the rewrite has been disabled.

Frequently Asked Questions

Can I use a wild card certificate for Domain Rewrite Service?

Advanced Email Relay Service requires a single subject SSL certificate with both private and public keys attached. Wild Card certificates are not supported.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating