Connecting Maileater to Office 365 Mail

Document ID : KB000009708
Last Modified Date : 06/04/2018
Show Technical Document Details
Introduction:

The following instructions describe how to configure SDM to connect and communicate with an Office 365 Server. 

Instructions:

In order to properly configure maileater to connect to Office 365 Mail, please follow these steps:

1. We first need to obtain the proper SSL certificate for the Office 365 mail server.

Note1: As of Dec 2016, the Office 365 Certificate is signed by the "DigiCert Global Root CA". Information on this certificate can be found here. If outlook.com gets signed by a different root certificate in the future, you would need to obtain the new root certificate from Microsoft or find out what the root certificate is and grab it from the vendor.

Note2: If the Certificate file name has format <name>.txt, it should be renamed as <name>.cer

2. After gathering the information for your root certificate, create a file using Notepad with the certificate's information. For the example below, we are using the DigiCert Global Root CA which is valid for Office 365 as of Dec 2016:

-----BEGIN CERTIFICATE-----
MIIDrzCCApegAwIBAgIQCDvgVpBCRrGhdWrJWZHHSjANBgkqhkiG9w0BAQUFADBh
MQswCQYDVQQGEwJVUzEVMBMGA1UEChMMRGlnaUNlcnQgSW5jMRkwFwYDVQQLExB3
d3cuZGlnaWNlcnQuY29tMSAwHgYDVQQDExdEaWdpQ2VydCBHbG9iYWwgUm9vdCBD
QTAeFw0wNjExMTAwMDAwMDBaFw0zMTExMTAwMDAwMDBaMGExCzAJBgNVBAYTAlVT
MRUwEwYDVQQKEwxEaWdpQ2VydCBJbmMxGTAXBgNVBAsTEHd3dy5kaWdpY2VydC5j
b20xIDAeBgNVBAMTF0RpZ2lDZXJ0IEdsb2JhbCBSb290IENBMIIBIjANBgkqhkiG
9w0BAQEFAAOCAQ8AMIIBCgKCAQEA4jvhEXLeqKTTo1eqUKKPC3eQyaKl7hLOllsB
CSDMAZOnTjC3U/dDxGkAV53ijSLdhwZAAIEJzs4bg7/fzTtxRuLWZscFs3YnFo97
nh6Vfe63SKMI2tavegw5BmV/Sl0fvBf4q77uKNd0f3p4mVmFaG5cIzJLv07A6Fpt
43C/dxC//AH2hdmoRBBYMql1GNXRor5H4idq9Joz+EkIYIvUX7Q6hL+hqkpMfT7P
T19sdl6gSzeRntwi5m3OFBqOasv+zbMUZBfHWymeMr/y7vrTC0LUq7dBMtoM1O/4
gdW7jVg/tRvoSSiicNoxBN33shbyTApOB6jtSj1etX+jkMOvJwIDAQABo2MwYTAO
BgNVHQ8BAf8EBAMCAYYwDwYDVR0TAQH/BAUwAwEB/zAdBgNVHQ4EFgQUA95QNVbR
TLtm8KPiGxvDl7I90VUwHwYDVR0jBBgwFoAUA95QNVbRTLtm8KPiGxvDl7I90VUw
DQYJKoZIhvcNAQEFBQADggEBAMucN6pIExIK+t1EnE9SsPTfrgT1eXkIoyQY/Esr
hMAtudXH/vTBH1jLuG2cenTnmCmrEbXjcKChzUyImZOMkXDiqw8cvpOp/2PV5Adg
06O/nVsJ8dWO41P0jmP6P6fbtGbfYmbW0W5BjfIttep3Sp+dWOIrWcBAI+0tKIJF
PnlUkiaY4IBIqDfv8NZ5YBberOgOzW6sRBc4L0na4UU+Krk2U886UAb3LujEV0ls
YSEY1QSteDwsOoBrp+uvFRTp2InBuThs4pFsiv9kuXclVzDAGySj4dzp30d8tbQk
CAUw7C29C79Fv1C5qfPrmAESrciIxpg0X40KPMbp1ZWVbd4=
-----END CERTIFICATE-----
 

3. Save the file and copy it to the primary server and make note of the path.

4. Use the following settings in the mailbox details screen (making sure to populate your full email address and file path to the certificate that you saved):

TEC1911912-1.jpg

Name:  Default (or the name of your mailbox)
Check Interval (in Sec):  recommended value is 30
Email Type:  IMAP4
Hostname:  outlook.com (This is NOT outlook.office365.com)
Port Override:  143 (It should be set to 143 and not the other ports like 993. This is because 143 is IMAP's STARTTLS port and maileater only supports STARTTLS)
User Name:  The User ID of the Office365's account. (If it does not work, try and use the full email address)
Password:  Fill in the password for the account
Security Level:  Clear Text
Attachment Repository:  Default is "Service Desk"
Attach Entire Email:  Default is "No"
Force Attachment Splitout:  Default is "No"
Allow Anonymous:  Default is "Yes"
Save Unknown Emails:  Default is "Yes"
Use Reply To Emails:  Default is "Yes"
Use TLS:  Yes
CA Certificate Path:  Path to the Certificate file you just created.

Additional Information:

The information in this article has been included in our product documentation. You can find further details here:

https://docops.ca.com/ca-service-management/17-0/en/troubleshooting/troubleshooting-ca-service-desk-manager/connecting-maileater-to-office-365-mail