Microsoft 365 Modern Authentication For Email (OAuth)

Important: RangerMSP version 30 or above is required for configuring access to Microsoft 365 mail servers using OAuth.

To configure RangerMSP to connect to Microsoft 365 mail servers, follow the steps below:

1. Run <Installation_DIR>\RangerMSP\Server\ServerConfig.exe.>
   
   
2. Under the ‘Outgoing Mail Server’ tab, select the option ‘Use OAuth 2 to connect to Microsoft 365’.
   
   
   
   
3. You must authorize RangerMSP in Microsoft 365.
   For this to work:
   1. Click the ‘Send Test Email’ button.
   2. Specify the ‘To’ email address that will be used for sending the test email message.
   3. Click the ‘Send Test Email Now’ button:
      
      
      
      
   4. Follow the Microsoft 365 flow in your browser to log into your Microsoft 365 using a privileged 365 user, ideally your 365 administrator user.
      
      Note: if you are already logged into 365 using another non-privileged account, please first log out - before starting the entire test-email process.
      
      
      
      
   5. The following page is displayed.
      Click the ‘Accept’ button whenever you are ready to authorize RangerMSP.
      
      
      
      
      
   6. The SMTP send-email test should show that it completed successfully:
      
      
      
      
4. Under the ‘Email Connector’ tab, you configure the same for inbound email under the ‘Incoming Email Settings’ section.
   
   Select Use OAuth 2 to connect to Microsoft 365.
   
   Next - click the ‘Test Server Settings’ button.
   
   
   
   NOTE: If you have not authorized RangerMSP in Microsoft 365 yet, a browser window will open asking you to approve RangerMSP, as explained above.
   
   A connection attempt to your mailbox at Microsoft 365 will run, and if everything is configured correctly, you will be prompted about a successful connection to Microsoft 365 POP3 servers.
   
   
5. Click OK to save your new settings.
   
   
   
   
6. Finally, you must RESTART the ‘CRM Server’ Windows service on your server for the changes to apply and take effect immediately.