Configure Sitecore Email Cloud to use geo-specific servers to comply with EU GDPR

  • Description

    To comply with GDPR legislation and to keep the information about your customers, who are EU residents, inside the EU for processing, you must update the Sitecore SMTP, EDS, and Sparkpost configurations. You must perform these updates on all content management (CM) roles and dedicated email dispatch server (DDS) roles, and in agreement with Sitecore.

    Please note that the data center region of the Email Cloud and Sparkpost servers is defined in the service order. For more details, contact your Sitecore sales representative.

    Once a data center is defined and settled, it cannot switch from one region to another.

  • Update the SMTP settings

    To update the SMTP settings:

    • Modify the server node under smtpSettings in the App_Config\Sitecore\EmailExperience\Sitecore.EDS.Providers.SparkPost.config file.

    The following example shows how the configuration file should look to update the SMTP settings to the Sparkpost EU SMTP server:

    <smtpSettings type="Sitecore.EDS.Providers.SparkPost.Smtp.SmtpSettings, Sitecore.EDS.Providers.SparkPost" singleInstance="true">
        <server>sitecore-eu.smtp.e.sparkpost.com</server>
        <port>587</port>
        <userName>sitecore-eu</userName>
        <startTls>true</startTls>
        <proxySettings ref="exm/eds/proxySettings" />
    </smtpSettings>
    

     

  • Update the EDS Service

    To update the EDS service:

    • Modify the apiUrl of the edsService sections in the App_Config\Sitecore\EmailExperience\Sitecore.EDS.Providers.SparkPost.config file.
    <edsService type="Sitecore.EDS.Providers.SparkPost.Services.EdsService, Sitecore.EDS.Providers.SparkPost" singleInstance="true">
          <param ref="exm/eds/httpClientFactory" />
          <param desc="apiUrl">https://sparkpost.cloud.sitecore.net</param>
          <param ref="exm/eds/retry" />
          <param ref="exmLogger" />
          <retryableHttpErrorCodes hint="list:AddRetryableHttpStatusCode">
              <retryableHttpErrorCode>401</retryableHttpErrorCode>
              <retryableHttpErrorCode>403</retryableHttpErrorCode>
              <retryableHttpErrorCode>500</retryableHttpErrorCode>
              <retryableHttpErrorCode>502</retryableHttpErrorCode>
             <retryableHttpErrorCode>503</retryableHttpErrorCode>
         </retryableHttpErrorCodes>
     </edsService> 

    You must update the Sitecore EDS API Url to one of the following values:

    Geo-location URL
    EU https://sparkpost-eu.cloud.sitecore.net
    US https://sparkpost.cloud.sitecore.net

     

  • Update the Sparkpost configuration

    To update the Sparkpost API URL:

    • Modify the apiUrl node, under the configurationStore section for type Sitecore.EDS.Providers.SparkPost in the App_Config\Sitecore\EmailExperience\Sitecore.EDS.Providers.SparkPost.config file.

    The following example shows the configuration file updated to use the EU data center:

    <configurationStore type="Sitecore.EDS.Providers.SparkPost.Configuration.ConfigurationStore, Sitecore.EDS.Providers.SparkPost" singleInstance="true">
        <param ref="exm/eds/smtpSettings" />
        <param ref="exm/eds/edsService" />
        <apiUrl>https://sitecore-eu.api.e.sparkpost.com/</apiUrl>
        <subscriptionApiUrl>https://apps.sitecore.net</subscriptionApiUrl>
    </configurationStore>

Applies to:

EXM 3.4+

June 21, 2018
June 21, 2018