1 OpenO365

Campus (UMsystem) has moved to centralized, cloud-sourced, closed-source,
email and calendaring provided by Microsoft Outlook.
If you would like to access email using your choice of mail client,
then there are currently several open, or semi-open alternatives which are pre-approved by UMsystem:

  1. Exchange -> Davmail -> Your choice of email/calendar client (Windows, Linux, Mac):
    a protocol “gateway” which accesses exchange and re-serves it via IMAP/POP3/SMTP/CalDav/etc. Run on your local machine, this enables you to use ANY email client that supports open standards.

  2. Exchange -> Evolution-mail (Linux):
    a pretty nice open-source exchange-compatible client

  3. Exchange -> ExQuilla plugin -> Thunderbird (Windows, Linux, Mac):
    Thunderbird is an open-source email client by Mozilla (I don’t recommend their default mbox format, but prefer maildir instead), and ExQuilla is a closed-source, proprietary, paid plugin for exchange interaction.

  4. Exchange -> KDE’s KMail (Linux):
    May work natively, but has not been pre-approved by UMsystem, and thus I have not tested it.

1.1 1. Exchange -> Davmail -> Your choice of email/calendar client!

http://davmail.sourceforge.net/ (open source)

Exchange/Office-365 runs a proprietary protocol
(rather than rely on open standards for email).
One solution to using your own mail client, which only interacts with open standards,
(IMAP, SMTP, POP, etc), is to use Davmail.
The cross-platform software, Davmail, pretends to be Outlook,
and then re-serves a mail server (IMAP or POP, and SMTP, calendaring server, etc.) on your localhost.
You can then point your mail and calendaring client
(e.g., mutt, Thunderbird, Claws-mail, Evolution, KMail, or whatever other client)
to localhost on Davmail’s chosen port, and they will interface with campus exchange.

To set up davmail:

  1. Download the latest version of davmail for your OS from: http://davmail.sourceforge.net/
  2. Follow the specified installation instructions, on the davmail site, for your platform (Linux, Windows, Mac).
  3. Confirm you can run and launch davmail.
  4. Right click on davmail -> open “settings” -> select the “main” tab
    1. In the drop-down menu for selecting the exchange protocol (screenshot and information here: http://davmail.sourceforge.net/gettingstarted.html), choose either:
      • O365Manual Office 365 with interactive dialog, not available in headless mode (via url/browser, recommended).
      • O365Interactive Office 365 with interactive browser window, not available in headless mode (OpenJFX required, not recommended)
    2. URL: automatically chosen by davmail
    3. The rest depends on your preferences (whether you want IMAP or POP3, which port you want those and SMTP on, etc). See the davmail documentation or message board for more detail.
  5. Configure your mail client of choice to point to davmail’s local server (127.0.0.1:PORT) where port is whatever you chose for each protocol.
    1. In your mail client, put in your username@umsystem.edu and password into your mail client itself, not davmail.
  6. When you check your mail, davmail will prompt you to open a link in a web browser, to complete your OAuth2 2fa, and then past the resulting link (which will appear blank) back into the davmail GUI prompt. It will remember your session for the duration of the time your computer is on. Copy-pasting the OAuth link into your browser of choice is recommended.

I have not tried setting up davmail directly with EWS using the appropriate IDs, but you may find them helpful for some setups:

While email works great with davmail, calendaring and contact management is ok,
but does not work quite as well as Evolution’s native support, which can respond to invites, etc.
You could technically run davmail on your own server,
have it sync with exchange, and re-serve to your phone’s mail client,
but the OAuth2 would be a bit of a pain that way,
and it’s probably not the best idea anyway.

1.2 2. Exchange -> Evolution-mail

https://wiki.gnome.org/Apps/Evolution/ (open source, Linux-only)
While there have been many attempts at native open exchange support,
particular to mail/calendaring clients themselves,
the only full open client-native option I have tested that works on campus is Evolution mail.
Evolution uses maildir for its mailbox format,
which is a better option than the mbox format used as Thunderbird’s default.
It is a pretty solid mail client, in my opinion.
I think this may have been disabled by campus…

  1. Install Evolution (Linux only)
#!/bin/bash

# If you run Fedora/Red-Hat
dnf search evolution
sudo dnf install evolution evolution-ews

# If you run a Debian-based distro (like Ubuntu, Mint, etc.)
sudo apt-get update
apt search evolution
sudo apt install evolution evolution-ews

# If you run OpenSuse
zypper search evolution
sudo zypper install evolution evolution-ews

# if you run some other distro, you probably get the point by now...
  1. Open Evolution
  2. File -> New -> Mail account
  3. Enter your basic information
  4. For the connection settings, enter the following information:
    1. Server Type: Exchange web services (EWS)
    2. Tenant GUID: e3fefdbe-f7e9-401b-a51a-355e01b05a89
    3. Application ID: 20460e5d-ce91-49af-a3a5-70b6be7486d1
    4. Host url: https://outlook.office365.com/EWS/Exchange.asmx
    5. OAB (online address book) url: Click “Fetch URL” seen below, and it will auto-fill this (you don’t type it what you see below).
    6. Make the rest of the settings match below (other than OAB URL, and your own username):
      OpenO365/evolution.png
  5. The rest of the configuration is up to you!
  6. When it attempts to log in, Evolution will show you a little pop up window with the web-based OAuth 2fa, which you follow as you would expect. OAath 2fa support appears to be limited to phone/text, with hardware security keys in Linux usable only in chromium-based browsers.

If you need more help, see the links from several other universities on this topic (naturally, their ID values will not work here, and you have to use the IDs above):
https://sites.utexas.edu/glenmark/2021/02/01/how-to-setup-your-office-365-email-using-evolution-ews-linux/
https://oit.utdallas.edu/helpdesk/kb/?id=946348a8ba16de1d0a42904323b00426a335099c42
https://support.uidaho.edu/TDClient/40/Portal/KB/ArticleDet?ID=1080
https://oit.colorado.edu/tutorial/office-365-evolution-configuration

1.3 4. Exchange -> ExQuilla plugin -> Thunderbird

https://www.thunderbird.net/en-US/ (open source)
https://www.exquilla.com/ (closed, paid)
https://addons.thunderbird.net/en-us/thunderbird/addon/exquilla-exchange-web-services/

Configuration parameters:
Tenant GUID: e3fefdbe-f7e9-401b-a51a-355e01b05a89
Thunderbird + ExQuilla appid: 7778c31f-71db-4645-9752-f536a326262f
The relevant URLs are likely the same as Evolution’s above.

I have not set this up myself, and would recommend any of the following over doing so:

1.4 4. Exchange -> KDE’s KMail ?

Linux only email client, KMail.
This may be working in general.
However, it has not been tested by me (or campus), or approved by campus yet.
If anyone has confirmed KMail working with OAuth2 and O365 modern in general,
and wants to use it, please check in and make the request.