Configuring Microsoft 365 Integration for Linux

This article describes how to configure Microsoft 365 (M365) for Linux users (Ubuntu 21.04 or later), in accordance with 2-factor authentication.

Prior versions of Ubuntu cannot configure Microsoft 365, and are restricted to using Thunderbird with email/IMAP. For instructions on how to configure the Thunderbird mail client: How to setup Microsoft 365 in Thunderbird

For more information about the M365 package, please refer to this article: Home | Microsoft 365 | University of Waterloo

Step-by-step guide

  1. Click on File > New Mail > Mail Account



  2. Select Identity on the left-hand side.

    1. Full Name: enter your full name (first and last)

    2. Email Address: enter your 8-character UWaterloo username and @uwaterloo.ca (i.e. myuserna@uwaterloo.ca)

       

  3. Unselect the Look up mail server details based on entered email address option



  4. Select the server type as Exchange Web Services
    Note: If the Exchange Web Services option is unavailable, this add-on must be installed onto Evolution. On Ubuntu, this can be done through the Ubuntu Software Store



  5. Enter your 8-character UWaterloo username and @uwaterloo.ca (i.e. myuserna@uwaterloo.ca)
    a. Change the host URL to https://outlook.office.com/
    b. Change the authentication method to OAuth2 (Office365)
    c. Click the Fetch URL button



  6. Authenticate with DUO (Two-factor authentication)

    1. Two-factor authentication is known to be completed once the OAB URL is auto-populated with an address. Select Next and modify the default mail account configuration, if needed. 

If you are using earlier versions of Ubuntu with Evolution, the following error will occur: 8 Data source “username@uwaterloo.ca” does not support OAuth 2.0 authentication. This is because a tenant ID and application ID must be retrieved. To do so, please follow the “Find the tenant ID” and “Create the application” instructions listed on this article: Apps/Evolution/EWS/OAuth2 – GNOME Wiki Archive.

 

 

Need help?

Contact the IST Service Desk online or 519-888-4567 ext. 44357.

Article feedback

If you’d like to share any feedback about this article, please let us know