Microsoft 365 Modern Authentication For Email (OAuth) - Revision history

Dina: /* Case 3 */

2023-01-03T14:26:38Z

Case 3

← Older revision		Revision as of 14:26, 3 January 2023
Line 95:		Line 95:
	This error means that 365 requires re-authorization.		This error means that 365 requires re-authorization.

	#Open your default browser and visit [https://login.microsoftonline.com https://login.microsoftonline.com]. <br> If you are logged in with any 365 user account, click the user avatar and select the Sign out option.<br><br>		#Open your default browser and visit [https://login.microsoftonline.com https://login.microsoftonline.com]. <br> If you are logged in with any 365 user account, click the user avatar and select the '''Sign out''' option.<br><br>
	#Run RangerMSP’s ServerConfig utility - visit the '''''Email Connector''''' tab and click the '''''Reset''''' button.<br><br>You should now be able to start the authorization process with 365 from scratch.<br><br> [[File:365_auth_reset.png]] <br><br>		#Run RangerMSP’s ServerConfig utility - visit the '''''Email Connector''''' tab and click the '''''Reset''''' button.<br><br>You should now be able to start the authorization process with 365 from scratch.<br><br> [[File:365_auth_reset.png]] <br><br>
	#Follow the Microsoft 365 flow in your browser to log into your Microsoft 365.<br>Important: You MUST sign in with the SAME 365 user account that owns the mailbox you are trying to use, and - it should be the SAME one defined in ServerConfig utility.		#Follow the Microsoft 365 flow in your browser to log into your Microsoft 365.<br>Important: You MUST sign in with the SAME 365 user account that owns the mailbox you are trying to use, and - it should be the SAME one defined in ServerConfig utility.
	#In case you were not prompted to sign in, and the browser used a previously logged-in user, you should sign out and try again. In case this does not help, clearing the browser cache may be required.		#In case you were not prompted to sign in, and the browser used a previously logged-in user, you should sign out and try again. In case this does not help, clearing the browser cache may be required.
	<br><br>		<br><br>

Dina: /* Troubleshooting */

2023-01-03T13:47:07Z

Troubleshooting

← Older revision		Revision as of 13:47, 3 January 2023
Line 82:		Line 82:

	[[File:Smtp_auth.png]]		[[File:Smtp_auth.png]]

			==Case 3==

			The error is shown in the application or POP3 connection test fails with error:

			'''''POP3 needs OAuth2 authentication token'''''

			<br>

			'''<u>Solution:</u>'''

			This error means that 365 requires re-authorization.

			#Open your default browser and visit [https://login.microsoftonline.com https://login.microsoftonline.com]. <br> If you are logged in with any 365 user account, click the user avatar and select the Sign out option.<br><br>
			#Run RangerMSP’s ServerConfig utility - visit the '''''Email Connector''''' tab and click the '''''Reset''''' button.<br><br>You should now be able to start the authorization process with 365 from scratch.<br><br> [[File:365_auth_reset.png]] <br><br>
			#Follow the Microsoft 365 flow in your browser to log into your Microsoft 365.<br>Important: You MUST sign in with the SAME 365 user account that owns the mailbox you are trying to use, and - it should be the SAME one defined in ServerConfig utility.
			#In case you were not prompted to sign in, and the browser used a previously logged-in user, you should sign out and try again. In case this does not help, clearing the browser cache may be required.
			<br><br>

Dina at 10:14, 15 September 2022

2022-09-15T10:14:49Z

← Older revision		Revision as of 10:14, 15 September 2022
Line 61:		Line 61:
	#Open your default browser and visit [https://login.microsoftonline.com https://login.microsoftonline.com]. <br> If you are logged in with any 365 user account, click the user avatar and select the Sign out option.<br><br>		#Open your default browser and visit [https://login.microsoftonline.com https://login.microsoftonline.com]. <br> If you are logged in with any 365 user account, click the user avatar and select the Sign out option.<br><br>
	#Run RangerMSP’s ServerConfig utility - <br><br>If testing an outbound email failed with the above error - Visit the '''''Outgoing Mail Server''''' tab and click the '''''Send Test Email''''' button.<br><br>If testing an inbound email connection failed with the error above - Visit the '''''Email Connector''''' tab and click the '''''Test Server Settings''''' button.<br><br>		#Run RangerMSP’s ServerConfig utility - <br><br>If testing an outbound email failed with the above error - Visit the '''''Outgoing Mail Server''''' tab and click the '''''Send Test Email''''' button.<br><br>If testing an inbound email connection failed with the error above - Visit the '''''Email Connector''''' tab and click the '''''Test Server Settings''''' button.<br><br>
			#If you completed the 365 authorization process using an incorrect 365 account (e.g., you used the already-logged-in account vs. the one owning the mailbox), you need first to use the ServerConfig utility to '''Reset''' the existing authorization. You should now be able to start the authorization process with 365 from scratch.<br><br> [[File:365_auth_reset.png]] <br><br>
	#Follow the Microsoft 365 flow in your browser to log into your Microsoft 365.<br>Important: You MUST sign in with the SAME 365 user account that owns the mailbox you are trying to use, and - it should be the SAME one defined in ServerConfig utility.<br><br>[[File:Case1_sample.png]]<br><br>		#Follow the Microsoft 365 flow in your browser to log into your Microsoft 365.<br>Important: You MUST sign in with the SAME 365 user account that owns the mailbox you are trying to use, and - it should be the SAME one defined in ServerConfig utility.<br><br>[[File:Case1_sample.png]]<br><br>
	#In case you were not prompted to sign in, and the browser used a previously logged-in user, you should sign out and try again. In case this does not help, clearing the browser cache may be required.		#In case you were not prompted to sign in, and the browser used a previously logged-in user, you should sign out and try again. In case this does not help, clearing the browser cache may be required.

Dina at 09:18, 15 September 2022

2022-09-15T09:18:49Z

← Older revision		Revision as of 09:18, 15 September 2022
Line 9:		Line 9:

	Open your default browser and go to [https://login.microsoftonline.com https://login.microsoftonline.com]		Open your default browser and go to [https://login.microsoftonline.com https://login.microsoftonline.com]


	If you are logged in with any of your users, click the user avatar and '''Sign out'''.		If you are logged in with any of your users, click the user avatar and '''Sign out'''.
Line 28:		Line 29:
	##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]]<br><br>		##Follow the Microsoft 365 flow in your browser to log into your Microsoft 365 using the SAME 365 user account that owns the mailbox you are trying to use (i.e., defined as the username in ServerConfig utility).<br />Note: if you are already logged into 365 using another account, please log out - BEFORE starting the entire test-email process. <br /><br> [[File:Ms365_signin.png]] <br><br />[[File:Case1_sample.png]]<br /><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]]<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]]<br><br>
	##The SMTP send-email test should show that it completed successfully:<br><br>[[File:Smtp_test_completed.png]]<br><br>		##The SMTP send-email test should show that it completed successfully:<br><br>[[File:Smtp_test_completed.png]]<br><br>

Dina at 10:47, 14 September 2022

2022-09-14T10:47:11Z

← Older revision		Revision as of 10:47, 14 September 2022
Line 72:		Line 72:

	'''<u>Solution:</u>'''		'''<u>Solution:</u>'''

	The error means that SMTP authentication is disabled for this mailbox.		The error means that SMTP authentication is disabled for this mailbox.

Dina at 10:06, 14 September 2022

2022-09-14T10:06:36Z

← Older revision		Revision as of 10:06, 14 September 2022
Line 60:		Line 60:
	#Open your default browser and visit [https://login.microsoftonline.com https://login.microsoftonline.com]. <br> If you are logged in with any 365 user account, click the user avatar and select the Sign out option.<br><br>		#Open your default browser and visit [https://login.microsoftonline.com https://login.microsoftonline.com]. <br> If you are logged in with any 365 user account, click the user avatar and select the Sign out option.<br><br>
	#Run RangerMSP’s ServerConfig utility - <br><br>If testing an outbound email failed with the above error - Visit the '''''Outgoing Mail Server''''' tab and click the '''''Send Test Email''''' button.<br><br>If testing an inbound email connection failed with the error above - Visit the '''''Email Connector''''' tab and click the '''''Test Server Settings''''' button.<br><br>		#Run RangerMSP’s ServerConfig utility - <br><br>If testing an outbound email failed with the above error - Visit the '''''Outgoing Mail Server''''' tab and click the '''''Send Test Email''''' button.<br><br>If testing an inbound email connection failed with the error above - Visit the '''''Email Connector''''' tab and click the '''''Test Server Settings''''' button.<br><br>
	#Follow the Microsoft 365 flow in your browser to log into your Microsoft 365.		#Follow the Microsoft 365 flow in your browser to log into your Microsoft 365.<br>Important: You MUST sign in with the SAME 365 user account that owns the mailbox you are trying to use, and - it should be the SAME one defined in ServerConfig utility.<br><br>[[File:Case1_sample.png]]<br><br>
	Important: You MUST sign in with the SAME 365 user account that owns the mailbox you are trying to use, and - it should be the SAME one defined in ServerConfig utility.<br><br>
	#In case you were not prompted to sign in, and the browser used a previously logged-in user, you should sign out and try again. In case this does not help, clearing the browser cache may be required.		#In case you were not prompted to sign in, and the browser used a previously logged-in user, you should sign out and try again. In case this does not help, clearing the browser cache may be required.
	<br><br>		<br><br>

Dina at 09:39, 14 September 2022

2022-09-14T09:39:29Z

@@ Line 1: / Line 1: @@
 <pre style="color: red">Important: RangerMSP version 30 or above is required for configuring access to Microsoft 365 mail servers using OAuth.</pre>
 To configure RangerMSP to connect to Microsoft 365 mail servers, follow the steps below:
@@ Line 16: / Line 35: @@
 #'''Finally, you must RESTART the ‘CRM Server’ Windows service on your server for the changes to apply and take effect immediately.'''
 <br><br>

Dina at 14:02, 25 August 2022

2022-08-25T14:02:58Z

← Older revision		Revision as of 14:02, 25 August 2022
Line 1:		Line 1:
	Important: RangerMSP version 30 or above is required for configuring access to Microsoft 365 mail servers using OAuth.		<pre style="color: red">Important: RangerMSP version 30 or above is required for configuring access to Microsoft 365 mail servers using OAuth.</pre>

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

Dina at 13:47, 25 August 2022

2022-08-25T13:47:54Z

← Older revision		Revision as of 13:47, 25 August 2022
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>

Dina at 13:45, 25 August 2022

2022-08-25T13:45:51Z

@@ Line 8: / Line 8: @@
 ##Click the ‘'''''Send Test Email'''''’ button.
 ##Specify the ‘'''''To'''''’ email address that will be used for sending the test email message.
-##Click the ‘Send Test Email Now’ button:<br><br>Send_test_email_smtp.png
+##Click the ‘Send Test Email Now’ button:<br><br>[[File:Send_test_email_smtp.png]]<br><br>