Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Info

This should be your FlexDeploy server with the following path /flexdeploy/facesrest/v2/oauth

...

Request Permissions

...

First, make sure your FlexDeploy Server Base Url in General Settings matches what you entered in Azure Application redirect. The server base url should NOT include the /flexdeploy/faces/oauth however.

...

Populate OAuth Information

Next, select Microsoft OAuth for the SMTP and/or IMAP auth type in Email Settings and add:

  1. SMTP Host Name - smtp.outlook.com

  2. SMTP/IMAP Username

  3. Client Id

  4. Client Secret

  5. Tenant Id

...

Authorize and Validate

In order to authorize, you should login to outlook.com as the user you wish to authorize as first. Otherwise, especially if you are using SSO, it is likely that you will be authorizing as the wrong user. The idea is that when you click authorize, it will ask you who to login as, and you will select (or type) the same user that you have in the imap user / smtp user box that you are authorizing.

After populating the necessary fields, click either the Authorize or Re-Authorize buttons. At this point you will be re-directed to Microsoft to authorize FlexDeploy as the same user that you have in the imap user / smtp user box that you are authorizing. If everything is successful you should be redirected back to this page:

...

or

...

Once the configuration authorization is complete, you can test the configuration by clicking on the Test Email Configuration button located at the bottom next to Save.

  • Send Sends a test email to the logged in user's email address to validate the SMTP related OAuth settings.

  • Reads the inbox of the Approval Reply Address to validate the IMAP related OAuth settings.

...

If you authorized as the wrong user, you will get the error:

Bad User is Authenticated But Not Connected

If you get that, reauthorize as the correct user, and then test again. Similarly, if you authorized as one user and need to authorize as a different user in the same session, then make sure to sign out of Microsoft first. Otherwise, the first user’s credentials will automatically be used with the authorization instead of prompting you to login as the second user. You will see this error when testing the email configuration:

...