gitea-pages/user-guide/evolution_for_o365.md

# Configure Evolution for 0ffice365

## Account and MFA ready?
Before connecting to Evolution to Office365, you need to have your MFA token/app configured.

If you use an app or SMS, then you can set it up directly at [Microsoft](https://aka.ms/mfasetup). Note that when you select the app and use "Use verification code", then you can also use 3rd party OTP apps.

For all the options check out the internal [knowledge base article](https://psi.service-now.com/kb_view.do?sysparm_article=KB0002928)

## Software Installed?

The package `evolution-ews` needs to be installed before starting.


## Configure Your Mail Account

If you first open Evolution you get automatically to the "Mail Configuration Assistant", else you select in the "Edit" menu "Accounts", and then klick the "+Add" dropdown and select `Mail Account`. Then you should get

![Welcome](evolution_for_o365/evolution01_wizard_welcome.png)

Here go on with "Next",

![Restore](evolution_for_o365/evolution02_wizard_restore.png)

and with "Next" again

![Identity](evolution_for_o365/evolution03_wizard_identity.png)

and finally fill in your Name (as it should be shown in outgoing emails) and your email address. Also tell Evolution to not try to figure out the server itself. After continuing:

![Receiving Email](evolution_for_o365/evolution04_wizard_receiving.png)

Now change the "Server Type" to `Exchange Web Service`, enter as username again your email address and put `https://outlook.office365.com/EWS/Exchange.asmx` as "Host URL".
The "OAB URL" is `https://outlook.office365.com/OAB/e24cb15c-bdec-429a-ba66-9832440ba55e/oab.xml`.

On the "Authentication" part select `OAuth2 (Office365)` and override the Office365 OAuth2 settings with

Tenant: `50f89ee2-f910-47c5-9913-a6ea08928f11`  
Applicatin ID: `751cf8be-ca07-484b-9308-fac4b9d85eff`

and then go on. There is nothing more to change:

![Receiving Options](evolution_for_o365/evolution05_wizard_options.png)

![Account Summary](evolution_for_o365/evolution06_wizard_summary.png)

![Done](evolution_for_o365/evolution07_wizard_done.png)

But then for authentication you then get a web popup:

![Office365 account authentication request](evolution_for_o365/evolution08_oauth2_user.png)

Here enter your email address

![Office365 account authentication request MFA](evolution_for_o365/evolution09_oauth2_password.png)

then enter your normal AD/Windows password


![Office365 account authentication request password](evolution_for_o365/evolution10_oauth2_2fa.png)

Followed by your MFA approval (in the Authenticator app or with a token code).

![Inbox](evolution_for_o365/evolution11_inbox.png)

And finally enjoy your inbox.