Configure a certificate-based connector to relay email messages through Microsoft 365

Introduction

If your organization has a hybrid deployment (on-premises plus Microsoft 365), you frequently have to relay email messages to the Internet through Microsoft 365. That is, messages that you send from your on-premises environment (mailboxes, applications, scanners, fax machines, and so on) to Internet recipients are first routed to Microsoft 365, and then sent out.

Figure shows email relayed from your on-premises email servers to the Internet through Microsoft 365.

Figure: Email relayed from your on-premises email servers to the Internet through Microsoft 365

For this relay to work correctly, your organization must follow these steps:

  1. Create one or more connectors in Microsoft 365 to authenticate email messages from your on-premises mail servers by using either the sending IP address or a certificate.

  2. Configure your on-premises servers to relay through Microsoft 365.

  3. Configure your setup so that either of the following conditions is true:

    • Sender domain

      The sender domain belongs to your organization (that is, you have registered your domain in Microsoft 365).

      Note For more information, see Add User and Domain in Microsoft 365.

    • Certificate-based connector configuration

      Your on-premises email server is configured to use a certificate to send email to Microsoft 365, and the Common-Name (CN) or Subject Alternate Name (SAN) in the certificate contains a domain name that you have registered in Microsoft 365, and you have created a certificate-based connector in Microsoft 365 that has that domain.

If neither of the conditions in step 3 is true, Microsoft 365 can't determine whether the message that was sent from your on-premises environment belongs to your organization. Therefore, if you use hybrid deployments, you should make sure that you meet either of the step 3 conditions.

Summary

Beginning July 5, 2017, Microsoft 365 no longer supports relaying email messages if a hybrid environment customer has not configured their environment for either of the step 3 conditions. Such messages are rejected and trigger the following error message:

550 5.7.64 Relay Access Denied ATTR36. For more information, see KB 3169958.

Additionally, you must meet the second condition ("certificate-based connector configuration") in step 3 in the Introduction section if your organization requires that any of the following scenarios continue to work after July 5, 2017.

Note

The original deadline for this new process was moved from February 1, 2017, to July 5, 2017, to provide sufficient time for customers to implement the changes.

Scenarios in which Microsoft 365 doesn't support relaying email messages by default

  • Your organization has to send non-delivery reports (NDRs) from the on-premises environment to a recipient on the Internet, and it has to relay the messages through Microsoft 365. For example, somebody sends an email message to john@contoso.com, a user who used to exist in your organization's on-premises environment. This causes an NDR to be sent to the original sender.

  • Your organization has to send messages from the email server in your on-premises environment from domains that your organization hasn't added to Microsoft 365. For example, your organization (contoso.com) sends email as the fabrikam.com domain, and fabrikam.com doesn't belong to your organization.

  • A forwarding rule is configured on your on-premises server, and messages are relayed through Microsoft 365.

    For example, contoso.com is your organization's domain. A user on your organization's on-premises server, kate@contoso.com, enables forwarding for all messages to kate@tailspintoys.com. When john@fabrikam.com sends a message to kate@contoso.com, the message is automatically forwarded to kate@tailspintoys.com.

    From the point of view of Microsoft 365, the message is sent from john@fabrikam.com to kate@tailspintoys.com. Because Kate's mail is forwarded, neither the sender domain nor the recipient domain belongs to your organization.

Figure shows a forwarded message from contoso.com that's allowed to be relayed through Microsoft 365.

Figure: A forwarded message from contoso.com that's allowed to be relayed through Microsoft 365 because the step 3 "certificate-based connector configuration" condition is met

More information

You can set up a certificate-based connector for Microsoft 365 to relay messages to the Internet. To do this, use the following method.

Step 1: Create or change a certificate-based connector in Microsoft 365

To create or change a certificate-based connector, follow these steps:

  1. Sign in to the Microsoft 365 portal (https://portal.office.com), click Admin, and then open the Exchange admin center. For more information, see Exchange admin center in Exchange Online.

    Screenshot shows steps to open the Exchange admin center.

  2. Click mail flow, click connectors, and then do one of the following:

    • If there are no connectors, click (Add) to create a connector.

      Screenshot shows there are no connectors in the Exchange admin center, click Add icon likes plus shape to create a connector.

    • If a connector already exists, select it, and then click (Edit).

      Screenshot shows selecting the connector in the Exchange admin center, and then clicking Edit icon likes pen shape.

  3. On the Select your mail flow scenario page, select Your organization's email server in the From box, and then select Microsoft 365 in the To box.

    Note

    This creates a connector that indicates that your on-premises server is the sending source for your messages.

    Screenshot of the Select your mail flow scenario page, which selects your organization's email server in the From box, and then selects Microsoft 365 in the To box.

  4. Enter the connector name and other information, and then click Next.

  5. On the New connector or Edit connector page, select the first option to use a Transport Layer Security (TLS) certificate to identify the sender source of your organization's messages. The domain name in the option should match the CN name or SAN in the certificate that you're using.

    Note

    This domain must be a domain that belongs to your organization, and you have to have added it to Microsoft 365. For more information, see Add Domains in Microsoft 365.

    For example, Contoso.com belongs to your organization, and it's part of the CN name or SAN name in the certificate that your organization uses to communicate with Microsoft 365. If the domain in the certificate contains multiple domains (such as mail1.contoso.com, mail2.contoso.com), we recommend that the domain in the connector UI be *.contoso.com.

    Note

    Existing hybrid customers who used the Hybrid Configuration Wizard to configure their connectors should check their existing connector to make sure that it uses, for example, *.contoso.com instead of mail.contoso.com or <hostname>.contoso.com. This is because mail.contoso.com and <hostname>.contoso.com may not be registered domains in Microsoft 365.

    Figure shows an example of setting up the connector to use the contoso.com format.

    Figure: Setting up the connector to use the "contoso.com" format (for example)

Step 2: Register your domain in Microsoft 365

To register your domain, follow the steps in the following Office article:

Add users and domain to Microsoft 365

In the Microsoft 365 Admin Center, click Setup, and then click Domains to see the list of domains that are registered.

Screenshot shows steps to see the registered domains.

Step 3: Configure your on-premises environment

To configure your on-premises environment, follow these steps:

  1. If your organization uses Exchange Server for its on-premises server, configure the server to send messages over TLS. To do this, see Set up your email server to relay mail to the Internet via Microsoft 365.

    Note

    If you've already used Hybrid Configuration Wizard, you can continue to use it. However, make sure that you use a certificate that matches the criteria that's outlined in Step 1, sub-step 5 of this section.

  2. Install a certificate in your on-premises environment. To do this, see Step 6: Configure an SSL certificate.

References

For more information about how to address the connector setting requirement, see Important connector notice.

For more information about how to relay messages through Microsoft 365, see the "Setting up mail flow where some mailboxes are in Microsoft 365 and some mailboxes are on your organization's mail servers" section of Mail flow best practices for Exchange Online and Microsoft 365.

Still need help? Go toMicrosoft Community or the Exchange TechNet Forums.