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

Can I exclude Domain Rewrite for specific recipients?

Some external applications process workflows and approvals with automated emails and require the sender’s email address to match what is configured in the application.  For these applications, you can add an exclusion to the transport rules created by On Demand to prevent Domain Rewrite from occurring on these messages.

LightbulbImportant Tip: When adding exclusions to an On Demand Domain Rewrite transport rule, do not delete any of the pre-configured parameters. Disabling, changing priority, or modifying transport rules incorrectly can cause Domain Rewrite to stop working.

Add exclusion to On Demand Rewrite transport rule

  • Log in to Exchange Online Admin Center and view the Transport Rules

  • Select the Rule “BT-IntegrationPro-Out-S-Internet” and click the Edit icon

  • Click “Add Exception”

  • Hover over “The recipient…”

  • Select “domain is”

How do I install and configure Directory Sync agents?

A Directory Sync agent must be installed in every forest that is attached to a tenant used in a Domain Rewrite project.

Manage Agents in On Demand Domain Rewrite Project

  • Log in to On Demand

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

  • Select the Domain Rewrite project previously configured.

  • Click on the Settings icon in the upper right.

  • Click the Directory Integration tab

Download and install the agent 

From this page, you can download the agent installer, check the status of your current agents, add new agents, archive old agents, and view the run history for each agent. The Registration URL and the Registration Key are displayed so that you can copy and paste them during the install of the agent.

LightbulbImportant Tip: The downloadable executable is the same for all projects, the Registration URL is unique to each On Demand region, and the Registration Key is unique to each local environment.

When installing the agent on a server that meets the On Demand requirements, you will enter the credentials of the Domain Account that has read/write access to the domain along with the Registration URL and Registration Key copied previously.

How do I uninstall an agent?

How do I uninstall an agent?  

If you need to uninstall an agent from any machine, you must first delete the registry folder located at HKEY_LOCAL_MACHINE> SOFTWARE> Quest > Agent and then uninstall.

If you need to reinstall the agent, create a new agent from the Directory Integration screen in the On Demand Domain Rewrite project, which will generate a new Registration Key.  Then you can reinstall on the same machine or on a different machine. The old agent (with the old registration key) can be archived in On Demand.

Does Domain Rewrite modify messages sent between the Source and Target tenants?

The expected rewrite behavior is based on which rewrite mode is enabled – “Rewrite with Target Address” or “Rewrite with Source Address”. Both modes rewrite messages sent to external users that do not belong to either tenant and do not rewrite messages sent to internal users in the sending user’s tenant. For messages sent between the source and target tenants, the behavior is as follows:

 

Rewrite with Target Address - Outbound

Messages sent from a rewrite-enabled user in the source tenant to a user in the target tenant will be rewritten just like messages sent to fully external recipients. If you do not want these messages rewritten, you can add an exclusion to the rule “BT-IntegrationPro-Out-S-Internet” for the domain(s) in the target tenant.

 

Rewrite with Source Address - Outbound

Messages sent from a rewrite-enabled user in the target tenant to a user in the source tenant will not be rewritten. If you want those messages rewritten, you must create contacts in the target tenant for each source user and then add the contacts to the distribution list “BT-IntegrationPro-{Source Tenant GUID}”.

Related Documents

The document was helpful.

Select Rating

I easily found the information I needed.

Select Rating