Microsoft 365 Modern Authentication For Email (OAuth): Difference between revisions

From RangerMSP Wiki - PSA software for MSPs and IT services providers
Jump to navigation Jump to search
No edit summary
No edit summary
Line 9: Line 9:
##Specify the ‘'''''To'''''’ email address that will be used for sending the test email message.
##Specify the ‘'''''To'''''’ email address that will be used for sending the test email message.
##Click the ‘Send Test Email Now’ button:<br><br>[[File:Send_test_email_smtp.png]]<br><br>
##Click the ‘Send Test Email Now’ button:<br><br>[[File:Send_test_email_smtp.png]]<br><br>
##Follow the Microsoft 365 flow in your browser to log into your Microsoft 365 using a privileged 365 user, ideally your 365 administrator user.<br><br>Note: if you are already logged into 365 using another non-privileged account, please first log out - before starting the entire test-email process.<br><br> [[File:Ms365_signin.png]]
##Follow the Microsoft 365 flow in your browser to log into your Microsoft 365 using a privileged 365 user, ideally your 365 administrator user.<br><br>Note: if you are already logged into 365 using another non-privileged account, please first log out - before starting the entire test-email process.<br><br> [[File:Ms365_signin.png]]<br><br>
##The following page is displayed.<br>Click the ‘Accept’ button whenever you are ready to authorize RangerMSP.<br><br>[[File:365_permissions_request.png]]<br>[[File:Authorization_success.png]]
##The following page is displayed.<br>Click the ‘Accept’ button whenever you are ready to authorize RangerMSP.<br><br>[[File:365_permissions_request.png]]<br>[[File:Authorization_success.png]]<br><br>
##The SMTP send-email test should show that it completed successfully:<br><br>[[File:Smtp_test_completed.png]]
##The SMTP send-email test should show that it completed successfully:<br><br>[[File:Smtp_test_completed.png]]<br><br>
#Under the ‘'''''Email Connector'''''’ tab, you configure the same for inbound email under the ‘'''''Incoming Email Settings'''''’ section.<br><br>Select '''''Use OAuth 2 to connect to Microsoft 365'''''.<br><br>Next - click the ‘'''''Test Server Settings'''''’ button.<br><br>[[File:Pop_test_server_settings.png]]<br><br>'''NOTE:''' If you have not authorized RangerMSP in Microsoft 365 yet, a browser window will open asking you to approve RangerMSP, as explained above. <br><br>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.[[File:Pop_test_completed.png]]
#Under the ‘'''''Email Connector'''''’ tab, you configure the same for inbound email under the ‘'''''Incoming Email Settings'''''’ section.<br><br>Select '''''Use OAuth 2 to connect to Microsoft 365'''''.<br><br>Next - click the ‘'''''Test Server Settings'''''’ button.<br><br>[[File:Pop_test_server_settings.png]]<br><br>'''NOTE:''' If you have not authorized RangerMSP in Microsoft 365 yet, a browser window will open asking you to approve RangerMSP, as explained above. <br><br>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.[[File:Pop_test_completed.png]]<br><br>
#Click OK to save your new settings.<br><br>[[File:Serverconfig_save_settings.png]]
#Click '''OK''' to save your new settings.<br><br>[[File:Serverconfig_save_settings.png]]<br><br>
#'''Finally, you must RESTART the ‘CRM Server’ Windows service on your server for the changes to apply and take effect immediately.'''
#'''Finally, you must RESTART the ‘CRM Server’ Windows service on your server for the changes to apply and take effect immediately.'''




<br><br>
<br><br>

Revision as of 13:47, 25 August 2022

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.