These instructions are for version of Thunderbird 77.0b1 or later, which supports OAuth2 modern authentication. To see your current version, press ALT+H and ALT+A.
- Launch Thunderbird to bring up the main Thunderbird interface.
- If you have other accounts configured, you can navigate here by clicking on Local Folders on the left-hand side. Select Email under the Setup Another Account section in the main window.
- ! Important ! If you have any files stored locally, it is highly recommended to back them up before attempting modern authentication.
- On the Mail Account Setup window, enter information into the available fields as follows:
- Your name: Your name as you'd like it to appear
- Email Address:
- NetID Account: Enter firstname.lastname@example.org
- Service Account: Enter email@example.com
- For example, if your username was helpdesk-team-kb and the domain was doit, you'd type firstname.lastname@example.org
- For multi-level domains, email@example.com, use the following format: firstname.lastname@example.org
Important: do not enter in your password on this login screen. Only enter your email address and name.
Note: If you don't know whether you are attempting to configure a NetID account or a Service account, please contact your domain administrator.
- Click Continue
- Thunderbird should automatically discover IMAP as the available configuration and fill in the server settings necessary for your account:
- Click Done to confirm the creation of your account. You will be prompted to complete Two Factor Authentication. Complete this to continue.
- For a service account, you will need to enter username_domain as the NetID (example: kb-helpdesk-team_doit), and you will need a password. If the service account does not have a password, you can request one at Office 365 - Reset Service Account Password .
- A window will pop up with a Permissions Request. Click Accept.
- Click Finish.
If you are experiencing the issues after the above configuration attempt, use the following steps to verify that your server settings are correct. You will most likely not need go through these steps because these settings should be the default.
- Navigate to Account Settings > Server Settings > Security Settings > Authentication Method and select OAuth2 from the Authentication Method dropdown.
- Navigate to Outgoing Server on the bottom of the left-hand panel of the account settings screen.
- Select the University of Wisconsin O365 smtp server and click edit on the righthand side
- Change the Authentication method to OAuth2 to the following and then click OK:
- Description: University of Wisconsin O365 (wisc.edu)
- Server Name: smtp.office365.com
- Port: 587 (default)
- User Name: your username
- Authentication Method: OAuth2
- Connection Security: STARTTLS
- Now, when you attempt to view your inbox, instead of being prompted for your password by Thunderbird, you will be redirected to authenticate through Duo.
- After authenticating in step 5, the setup is complete. Email data will take some time to sync. BE PATIENT.
You can get to the configuration settings by:
- Click Tools on the top menu bar (or the key combination ALT+T)
- Click Account Settings