Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

Configure the E-mail Router

This content applies to both the on-premises deployment of Microsoft Dynamics CRM 2011 and Microsoft Dynamics CRM Online. Content for a specific deployment will be noted.

After the E-mail Router has been installed, you can configure it. Some of these configuration tasks are mandatory. Others are optional in that you use them to enable the following functionality:

Configuration Task 1: Set up profiles and (optionally) set up deployments, by using the E-mail Router Configuration Manager. For more information, see "E-mail Router Configuration Manager" later in this topic.

Configuration Task 2: Microsoft Dynamics CRM users must have their incoming email access type set to E-mail Router. For more information, see "Set e-mail access type" later in this topic.

Configuration Task 3: (Optional) As part of configuration, you can deploy rules. For more information, see "Deploy Inbox Rules" later in this topic.

Configuration Task 4: (Optional) As part of configuration, you can set up a forward mailbox. For more information, see "Set up a Forward Mailbox" later in this topic.

In This Topic

E-mail Router Configuration Manager

The E-mail Router Configuration Manager is a tool that you use to configure the E-mail Router. The E-mail Router Configuration Manager is installed with the E-mail Router and can be run after the E-mail Router Setup is completed.

The E-mail Router settings configured by using the E-mail Router Configuration Manager are saved in the Microsoft.Crm.tools.EmailAgent.xml file that is located in the folder where the E-mail Router is installed.

The E-mail Router has several options. Before you run the E-mail Router Configuration Manager, you should determine how you want to configure these options:

  • Incoming Configuration. The Microsoft Dynamics CRM E-mail Router supports Exchange Server 2003, Exchange Server 2007, Exchange Server 2010, Exchange Online, or POP3 email systems for incoming email messages.

  • Outgoing Configuration. Microsoft Dynamics CRM supports only Exchange Online or SMTP email systems for outgoing email messages.

  • Mailbox Monitoring Type. You can configure the following two mailbox types:

    • Forward Mailbox. If you select Forward Mailbox when you run the E-mail Router Configuration Manager, the E-mail Router uses a single mailbox to process email messages. Then, for each Microsoft Dynamics CRM user or queue that will receive e-mail messages, you must create a rule for the user or queue by running the Rule Deployment Wizard.

    • E-mail Router. If email messages can be forwarded as attachments, but your email system does not allow rules, you must configure each user to use the E-mail Router setting. If you are using Exchange Server, we recommend that you use Forward Mailbox Monitoring.

For more information about E-mail Router options, see Planning Deployment for Microsoft Dynamics CRM 2011 in the Planning Guide. Also, see the E-mail Router Configuration Manager Help, which you can open by clicking Help on the Configuration Profiles or the Deployments tab in the E-mail Router Configuration Manager.

To start the E-mail Router Configuration Manager, click Start, point to All Programs, point to Microsoft Dynamics CRM E-mail Router, and then click Microsoft Dynamics CRM E-mail Router Configuration Manager.

Configuration profiles

You must configure at least one incoming email profile and one outgoing email profile to enable the E-mail Router to route email to and from your Microsoft Dynamics CRM organization. Depending on the complexity of your organization’s email system, you may have to create multiple incoming and outgoing configuration profiles. For example, if your organization requires incoming E-mail Router services for multiple email servers, you must create one incoming configuration profile for each email server.

ImportantImportant
Due to performance throttling when accessing Exchange Online, the E-mail Router should not be configured to use the on-premises deployments of Microsoft Exchange Server or POP3 accounts when a profile is also configured for Exchange Online. If you must communicate with both Exchange Online and an Exchange Server On-Premises or POP3 email server, you can do so by using multiple instances of the E-mail Router (you can install only one instance of the E-mail Router on a computer). Connecting to Exchange Server On-Premises and POP3 email servers by using multiple profiles from the same E-mail Router instance is supported.

Authentication types

You must specify the type of authentication the E-mail Router will use for each incoming and outgoing email profile.

For Exchange Server, incoming profiles support Windows authentication only. For POP3-compliant servers, incoming profiles support NTLM and clear text authentication.

TipTip
You can configure the E-mail Router to use POP3 protocol with Exchange Server. However, the Exchange Server POP3 service is disabled by default. For information about how to enable POP3, see the Exchange Server documentation.

ImportantImportant
Clear text authentication transmits unencrypted user names and passwords. If you use clear text authentication, we recommend that you do this only with Secure Sockets Layer (SSL). Select the Use SSL and set the Network Port field (on the Advanced tab) to a value that is appropriate for your environment. (If you specify Exchange Online, the Use SSL option is not available because you can connect to Exchange Online only over an https connection.) Verify your POP3 server requirements with your email administrator.

Depending on the type of email server that you use to process incoming email, select one of the following authentication types:

noteNote
Anonymous SMTP is only valid for internal, non-Internet-facing SMTP servers. Many SMTP servers do not support Anonymous authentication. To ensure uninterrupted email flow from the E-mail Router, verify your SMTP server requirements with your email administrator.

  • Windows Authentication. This is the only authentication type available if you use Microsoft Exchange Server for incoming email.

  • NTLM. This option is available only if you use a POP3-compliant server for incoming email.

  • Clear Text. This option is available if you use either a POP3-compliant server or Microsoft Exchange Online for incoming email. For Microsoft Exchange Online, this is the only authentication type available.

Access credentials

Depending on how you set the other configuration profile options, the following options are available for specifying the user name and password that the E-mail Router will use to access each mailbox that the profile serves.

ImportantImportant
If you use access credentials that are valid for the email server but not for a particular mailbox, a "401 access denied" error is generated when you test access.

Incoming profiles support the following access credentials:

  • Local System Account. This option requires a machine trust between the computer where the E-mail Router is running and the computer where Microsoft Exchange Server is running. For incoming profiles, this option is available only for Exchange Server (not for Exchange Online or other POP3 compliant email servers).

  • User specified.

    This option is available only in the on-premises version of the product. This option is available for all email server types, protocols, and authentication types.

    This option requires that each user enter a user name and password in the Set Personal Options dialog box (available in the Workplace section of the Microsoft Dynamics CRM web client). This enables the E-mail Router to monitor mailboxes by using each user's access credentials. When a user changes a domain password -- for example, when it expires -- the user must update the password in Microsoft Dynamics CRM so that the E-mail Router can continue to monitor the mailbox. This option is available for Exchange Server, Exchange Online and other POP3 compliant email servers.

  • Other specified. Select this option if you want the E-mail Router to authenticate by using the credentials of a specified user. This option is available for all email server types, protocols, and authentication types. The specified user must have full access to all the mailboxes that the incoming profile will serve. To specify multiple sets of access credentials, you must create a separate configuration profile for each specified user.

Outgoing profiles support the following access credentials. For more information, see the E-mail Router Configuration Manager Help.

  • Local System Account . Select this option if you select SMTP as the email server type and you want to authenticate by using the local system account of the computer where the E-mail Router is running. This option requires a machine trust between the computer where the E-mail Router is running and the computer where the Exchange Server is running. For more information, see “Securing Exchange Server and Outlook” in Operating system and software component security considerations for Microsoft Dynamics CRM 2011 in the Planning Guide. If you select this option, either the E-mail Router must be installed on the same server as the Microsoft Dynamics CRM Server 2011, or the E-mail Router computer name must have been entered during Microsoft Dynamics CRM Server Setup. This option is available only when you select SMTP as the email server type, and Windows Authentication or Anonymous as the authentication type.

  • User Specified.

    This option is available in the on-premises and Service Provider editions of Microsoft Dynamics CRM, and when you are using Exchange Online as the Exchange Server Type.

    Select this option if you want the E-mail Router to authenticate by using an individual user account or a mailbox.

  • Other Specified. This option enables the administrator to configure the E-mail Router to send email messages on each user's behalf by using the access credentials of a specified user account. The specified user must have full access to all the mailboxes that the incoming profile will serve. To specify multiple sets of access credentials, you must create a separate configuration profile for each specified user. This option is not available if you select SMTP as the email server type and Anonymous as the authentication type.

  • User Type. If you select Exchange Online as the email server type and Other Specified as the access credentials, you must select either Administrator or User as the user type. Select Administrator if you want to use a single set of credentials to process multiple mailboxes, or if you want to provide a different set of email credentials to process individual mailboxes.

  • Access Type. If you select Exchange Online as the email server type, Other Specified as the access credentials, and Administrator as the user type, you must select either Delegate Access or Send as as the access type.

    noteNote
    Delegate Access causes email to be sent as "Send on behalf of" messages.

    Send as causes email to be sent as "Send As" messages.

Deployments

You can link a configuration profile of the E-mail Router to Microsoft Dynamics CRM Online. It is not mandatory, but doing so provides the benefit of assigning the configuration profile to users for whom no other profile is assigned.

You must select the type of Microsoft Dynamics CRM system that the E-mail Router will connect to. The following options are available:

  • My company. Select this option if Microsoft Dynamics CRM is deployed at your company.

  • An online service provider. Select this option if the deployment that the E-mail Router will connect to is an online service provider deployment of Microsoft Dynamics CRM.

  • Microsoft Dynamics CRM Online . Select this option to connect the E-mail Router to a Microsoft Dynamics CRM Online organization.

Microsoft Dynamics CRM Server

Type the URL of the Microsoft Dynamics CRM Server 2011.

  • If you are connecting to an on-premises version at your company, the format is similar to http://myCRMServer:5555/OrganizationUniqueName.

  • If you are connecting to a service provider deployment, contact your service provider to obtain the correct URL. For more information, see the documentation for service providers that is available from the Microsoft Download Center.

  • If you are connecting to Microsoft Dynamics CRM Online and your organization uses Microsoft account, enter:

    • https://dev.crm.dynamics.com/<OrganizationName> where OrganizationName is a placeholder for the actual ID of your organization.

  • If you are connecting to Microsoft Dynamics CRM Online and your organization uses Microsoft Office 365, enter:

    • https://disco.crm.dynamics.com/<OrganizationName> where OrganizationName is a placeholder for the actual ID of your organization.

ImportantImportant
Make sure that the URL of the Microsoft Dynamics CRM deployment is spelled correctly. The OrganizationUniqueName part of the URL must be spelled exactly as it appears in the Microsoft Dynamics CRM server. To determine the OrganizationUniqueName, start the Microsoft Dynamics CRM web application as a user who has the System Customizer role. Click Settings, and then click Customizations. On the Customization page, click Developer Resources. The OrganizationUniqueName is displayed below the Organization Unique Name label.

One deployment type at a time

There are two types of deployments. One type includes deployments to Microsoft Dynamics CRM Online only. The other type includes deployments to either My company or An online service provider. If you define multiple deployments for the E-mail Router, they must all be of the same type. That is, after you have created a deployment that uses one deployment type, any other deployments that you create must be of the same type. (To create a deployment of the other type, you must first delete all of the deployments that currently exist.)

Obtaining user e-mail credentials from Microsoft Dynamics CRM

In certain circumstances, the E-mail Router must obtain user credentials from Microsoft Dynamics CRM. However, Microsoft Dynamics CRM stores user names and passwords only when HTTPS has been selected as the protocol that the E-mail Router will use to access Microsoft Dynamics CRM. You can change this behavior so that Microsoft Dynamics CRM can store and distribute user names and passwords to the E-mail Router over HTTP. For more information, see “HTTP Option” in “Keep user credentials secure” later in this topic.

Access Credentials

You must specify the access credentials that the E-mail Router will use to log on to Microsoft Dynamics CRM Server 2011.

To use the Local System Account (available only if you select My company as the deployment type), either the E-mail Router must be installed on the same computer as the Microsoft Dynamics CRM Server 2011, or the computer where the E-mail Router is installed must be a member of the Active Directory PrivUserGroup security group.

TipTip
For an on-premises deployment of Microsoft Dynamics CRM 2011, the computer will already be added to the PrivUserGroup security group if you specified the E-mail Router computer during Microsoft Dynamics CRM Server 2011 Setup.

Configuring E-mail Routing for Multiple Configurations and Deployments

You can add or edit an E-mail Router configuration, which contains a single incoming and outgoing method that routes email to the email server. In the configuration, you must specify the following:

  • A name of the configuration profile, for display and reference.

  • The direction of the configuration profile: incoming or outgoing.

  • The email transport type, such as Exchange or POP3 for incoming, and SMTP for outgoing.

You can also add or edit E-mail Router deployments. An E-mail Router deployment contains a URL to a Microsoft Dynamics CRM Server 2011 computer, one incoming configuration, and one outgoing configuration. In an E-mail Router deployment object, you specify the following components:

  • A URL to the Microsoft Dynamics CRM Server 2011 computer (required).

  • A default incoming configuration (optional).

  • A default outgoing configuration (optional).

To specify additional operational settings for a new or existing configuration profile, click Advanced on the E-mail Router Configuration Manager dialog box.

For more information, see the E-mail Router Configuration Manager Help.

Keep user credentials secure

If your organization uses the E-mail Router to send and receive messages on behalf of users or queues, you should increase security. You can do this either by using the HTTPS protocol or by enabling IPsec.

noteNote
This issue applies only to users of the on-premises deployment of Microsoft Dynamics CRM 2011.

HTTPS option

In processing email for a user or queue, the E-mail Router requires credentials for the user or queue. Those credentials can be entered in the Microsoft Dynamics CRM web application in the Set Personal Options dialog box (for users) and in the Queues form (for queues). Microsoft Dynamics CRM stores these credentials in encrypted form in the Microsoft Dynamics CRM database. The E-mail Router uses a key stored in the Microsoft Dynamics CRM database to decrypt these credentials. The call that the E-mail Router makes to obtain this key enforces HTTPS. In Microsoft Dynamics CRM 2011, the E-mail Router functions this way by default, which means that you need not take any action to retain this behavior. However, if you do not want to use HTTPS, you must set a particular Windows registry key, as described in the following section.

HTTP option

If you do not want to use HTTPS, you must set a Windows registry key, as follows:

  1. On the Microsoft Dynamics CRM Server 2011, check the value of the registry key DisableSecureDecryptionKey at the path HKLM\Software\Microsoft\MSCRM. If this registry key is present, set its value to 1. (If the key is not present or set to 0, calls from the E-mail Router to the Microsoft Dynamics CRM Server 2011 are made using HTTPS.) Setting the value of this key to 1 allows the E-mail Router to obtain information from the Microsoft Dynamics CRM database over the HTTP protocol.

  2. If you changed the value of DisableSecureDecryptionKey, do the following on the Microsoft Dynamics CRM Server 2011: Restart Internet Information Services (IIS). To do this, click Start, click Run, type IISRESET, and then click OK.

  3. (Recommended) Enable IPsec for all communications between the Microsoft Dynamics CRM Server 2011 and the E-mail Router computer. For more information about enabling IPsec, see IPSec.

Managing certificates to use the E-mail Router with HTTPS

If you are running Microsoft Dynamics CRM on HTTPS and one or more certificates is not signed by a certification authority, do the following on the computer on which the E-mail Router is installed:

For the Microsoft Dynamics CRM certificate

  1. If the E-mail Router Service is configured to use the "LocalSystem" account, import the Microsoft Dynamics CRM certificate into the trusted store of the local machine account of the computer on which the E-mail Router is installed.

  2. If the E-mail Router Service is configured to use any other specific user account, import the Microsoft Dynamics CRM certificate into the trusted store of that user's account on the computer on which the E-mail Router is installed.

For any Exchange Server certificates:

  1. If the E-mail Router Service is configured to use the "LocalSystem" account, import the Exchange Server certificate into the trusted store of the local machine account of the computer on which the E-mail Router is installed.

  2. If the E-mail Router Service is configured to use any other specific user account, import the Exchange Server certificate into the trusted store of that user's account on the computer on which the E-mail Router is installed.

Set email access type

Before a user can send and receive email messages that will be tracked in Microsoft Dynamics CRM, you must change the email access type that is set for that user, as described in the following procedure.

To set the email access type

  1. Open the Microsoft Dynamics CRM web application.

  2. In the Navigation Pane, click Settings.

  3. Under System, click Administration.

  4. In the Administration area, click Users.

  5. Find the user whose settings you want to edit. You may need to navigate to a different page.

  6. Click the name of the user, or select the user and then click Edit. The User form opens. You can edit the messaging options in the E-mail Access Configuration section.

    noteNote
    By default, Microsoft Dynamics CRM sets both the incoming email access type and the outgoing e-mail access type to "Microsoft Dynamics CRM for Outlook."

  7. For each user of the Microsoft Dynamics CRM web application whose mail will be routed by the E-mail Router, you must change the incoming type to E-mail Router or to Forward Mailbox, and the outgoing type to E-mail Router.

Connect the E-mail Router to Microsoft Dynamics CRM Online

Set the E-mail Router to work with Microsoft Dynamics CRM Online

  1. Start the E-mail Router Configuration Manager.

  2. Click the Deployments tab.

  3. Click New to create a new deployment.

  4. Make sure that the Deployment option is set to Microsoft Dynamics CRM Online. If the Microsoft Dynamics CRM Online option is not available, delete the existing deployments as explained in the following note:

    noteNote
    There are two types of deployments. One type includes deployments to Microsoft Dynamics CRM Online only. The other type includes deployments to either My company or An online service provider. If you define multiple deployments for the E-mail Router, they must all be of the same type. That is, after you have created a deployment that uses one deployment type, any other deployments that you create must be of the same type. (To create a deployment of the other type, you must first delete all of the deployments that currently exist.)

  5. Enter the rest of the information required to define the deployment and then click OK to finish.

Deploy inbox rules

An important part of routing email messages to your Microsoft Dynamics CRM system is the placement of an Microsoft Exchange Server inbox rule in the inbox of each Microsoft Dynamics CRM user or queue. This rule sends a copy of each message that is received by a Microsoft Dynamics CRM user to the Microsoft Dynamics CRM system mailbox. From the Microsoft Dynamics CRM system mailbox, the E-mail Router retrieves the messages and creates an email activity in Microsoft Dynamics CRM.

To deploy these Microsoft Dynamics CRM user inbox rules, use the Rule Deployment Wizard, which can be run at any time to add or change the inbox rules for your Microsoft Dynamics CRM users.

ImportantImportant
The Rule Deployment Wizard can deploy rules only to Exchange Server mailboxes. You cannot use the Rule Deployment Wizard to deploy rules to POP3 email servers.

noteNote
For information about installing the Rule Deployment Wizard, see Install E-mail Router and Rule Deployment Wizard in this guide.

If you chose to install this wizard as part of the E-mail Router installation, you can access this wizard by doing the following:

On the computer where you have installed the Rule Deployment Wizard, click Start, point to All Programs, point to Microsoft Dynamics CRM E-mail Router, and then click Rule Deployment Wizard.

The Rule Deployment Wizard does not have to be run on a computer with an instance of Exchange Server. To run the Rule Deployment Wizard, you must:

  • Be logged on as a Microsoft Dynamics CRM user with a security role. (Users can be in restricted access mode).

  • Be a local administrator on the computer where the wizard is running.

  • Have Exchange Server administrative permissions.

To deploy rules to the mailbox of a Microsoft Dynamics CRM user, the person running the Rule Deployment Wizard must have Exchange Server administrative permissions for the mailbox. Use the Exchange System Manager and the Exchange Server delegation wizard to designate Exchange Server administrators. Or, make sure that the person running the Rule Deployment Wizard has full permissions on the Exchange Server mailbox store or storage group in which the users' mailboxes are located.

Create the rule manually

For POP3 email servers that support email system rules where an email message can be forwarded as an attachment, you can create the rule manually.

noteNote
Before you can specify a forward mailbox in a rule, you must create a mailbox and designate it as a forward mailbox. For more information, see “Specify a Forward Mailbox” in the E-mail Router Configuration Manager Help.

To create the rule manually in Microsoft Office Outlook

  1. On the Tools menu, click Rules and Alerts. (In Office 2010, on the Home tab, click Rules, and then click Manage Rules & Alerts.) The Rules and Alerts dialog box appears.

  2. On the E-mail Rules tab, click New Rule.

  3. Under Step 1: Select a template, in the Start from a blank rule section, click Apply rule on messages I receive, and then click Next.

  4. Under Step 1: Select conditions, select where my name is in the To box, and then click Next.

  5. Under Step 1: Select actions, select forward it to people or public group as an attachment.

  6. Under Step 2: Edit the rule description (click and underlined value), click people or public group.

  7. Select the name of your E-mail Router forward mailbox, and then click OK.

  8. Click Next two times.

  9. Optionally, under Step 1: Specify a name for this rule, change the name of the rule.

  10. Make sure that the Turn on this rule option is selected, and then click Finish.

  11. Make sure that the rule is at the top of the list, and then click Apply.

Set up a forward mailbox

The forward mailbox is used as a collection box for email messages that are transferred from each Microsoft Dynamics CRM user’s mailbox by a server-side rule. The forward mailbox must be dedicated to the E-mail Router system, and should not be used as a working mailbox by an individual user.

Before you specify a forward mailbox, you must create or use an existing Exchange Server or POP3 mailbox that can be dedicated to processing email messages that are tracked by Microsoft Dynamics CRM. After you specify the forward mailbox, you can run the Rule Deployment Wizard to deploy the rules that will be used to forward email messages to the forward mailbox.

noteNote
If you specify a POP3 mailbox as the forward mailbox, you must manually deploy the rules. The Rule Deployment Wizard cannot deploy rules to a POP3 email server. For information about how to deploy rules manually, see “Create the rule manually” above.

Specify or modify a forward mailbox

  1. Make sure that you have a mailbox to dedicate as the forward mailbox. If you do not, see your messaging server documentation for information about how to create a mailbox. If you select Exchange Server as the incoming email server type, you must log on to the mailbox by using an email client such as Microsoft Office Outlook or Outlook Web Access (OWA) at least once to complete the creation of the mailbox.

  2. Click the Users, Queues, and Forward Mailboxes tab, and then click Load Data.

  3. When the list appears, click the Forward Mailboxes tab, and then click New. To change an existing forward mailbox, click Modify.

  4. In the Forward Mailbox dialog box, complete the following boxes, and then click OK:

    • Name. Type a name for the forward mailbox. This will be used to display in the E-mail Router Configuration Manager and the Rule Deployment Wizard.

    • Email Address. Type the email address for the forward mailbox, such as forwardmailbox@contoso.com.

    • Incoming Configuration Profile. Select the incoming configuration profile to associate with the forward mailbox. You can have multiple forward mailboxes that use different incoming configuration profiles.

    noteNote
    To delete email messages in the forward mailbox after they have been processed by the E-mail Router, select the Delete messages in forward mailbox after processing option.

  5. Click Publish.

  6. Stop the Microsoft CRM Email Router service. To do this, on the Start menu, type services.msc, and then press ENTER; or click Run, type services.msc, and then press ENTER. Right-click the Microsoft CRM Email Router service, and then click Stop.

  7. Restart the Microsoft CRM Email Router service. To do this, in the services list, right-click Microsoft CRM Email Router, and then click Start.

  8. Click OK, and then close the Services application.

Complete the forward mailbox

If you will use a forward mailbox to route email messages, in Active Directory directory service, you must create the user and mailbox that will be used for the E-mail Router forward mailbox.

ImportantImportant
You must log on to the forward mailbox at least one time before the E-mail Router can use it to process email messages.

See Also

Send comments about this article to Microsoft.

© 2013 Microsoft Corporation. All rights reserved.
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.