1. Home
  2. Recent Updates
  3. Office 365 Deprecating Basic & Legacy Authentication

Office 365 Deprecating Basic & Legacy Authentication


Microsoft is planning the deprecation of Basic Authentication for multiple protocols prior to its removal (Date TBC by Microsoft). Basic Authentication relies on sending usernames and passwords — often stored on or saved to the device — with every request, increasing risk of attackers capturing users’ credentials, particularly if not TLS protected. Basic Authentication is unable to enforce MFA and is superseded by Modern Authentication. 

Basic Authentication
Basic & legacy authentication mechanisms that rely solely on username and password. It has proven ineffective and is not recommended in modern IT environments especially when authentication is exposed to the internet as is the case for Office 365.

Modern Authentication
To address the common security risks and user experience associated with Office 365 deployments, Microsoft introduced the Active Directory Authentication Library (ADAL) for Office 365 client applications, referred to as Modern Authentication. Modern Authentication secures Office 365 resources using multi-factor authentication, certificate-based authentication, and SAML-based logins (such as Federation), for a true single sign-on experience.

For MFA to be effective, you will need to block basic & legacy authentication. The reason behind this is legacy authentication protocols like POP, SMTP, IMAP, and MAPI cannot enforce MFA making them preferred entry points for adversaries attacking your organization…

…The numbers on legacy authentication from an analysis of Azure Active Directory (Azure AD) traffic are stark:

  • More than 99 percent of password spray attacks use legacy authentication protocols
  • More than 97 percent of credential stuffing attacks use legacy authentication
  • Azure AD accounts in organizations that have disabled legacy authentication experience 67 percent fewer compromises than those where legacy authentication is enabled

Older protocols like Exchange ActiveSync, EWS and MAPI can also still be used with basic authentication overriding MFA/Modern Authentication. For example, Outlook clients can default to Basic Authentication by modifying registry on Windows machines.

This complexity presents a major challenge in balancing support for email applications preferred by end-users and enforcing MFA across the entire Office 365 environment. The “Expected Changes” section below addresses the trade-offs that must be made to enforce MFA for Office 365.

Expected Changes

Before proceeding further, we should mention that the configuration changes listed in this document will enforce the following behaviors:

  1. All access to Office 365 will be over Modern Authentication.
  2. Clients that rely on legacy authentication protocols (including but not limited to, SMTP, POP, IMAP, ActiveSync Basic, MAPI Basic) will be prevented from accessing Office 365 and will be required to reauthenticate with Modern Authentication.
  3. Clients that don’t support modern authentication will no longer be allowed to access Office 365 over basic authentication.
  4. Office 365 Administrators will need the Modern Authentication supported PowerShell module to connect to online Exchange.
  5. Some 3rd Party Integrations still require basic authentication as they are still working on their migrations to Modern Authentication. In this instance, there will be no option but to enable basic authentication on a per user/account basis. (See instructions below on Dealing with Exceptions)

Identifying Use of Basic & Legacy Authentication 

The following guide will show you how to identify, use, and plan for the changes required.

Failed login attempts from strange locations/IPs in the logs would indicate ongoing brute force and spray attacks against the Office 365 tenant. 

Note: Certain 3rd Party Systems like CCH, SuiteFiles and OnePractice are still using Basic Authentication, if you notice these accounts in your logs take note of the account in use to create an exception.

  1. Login to Azure AD Portal with an Administrator Account. (Note: This is the same Administrator Account as Office 365)
  2. In the Search bar, search and select Azure Active Directory. 
  3. Scroll down then select Sign-ins.
  4.  Click the Date filter then select 7 Days. Click Apply.
  5. Click Add filters. Chose Client App then click Apply.
  6. Click the Client app filter.
  7. Select IMAP, POP, and SMTP then click Apply.
  8. This will now display the last 7 days of logs where Legacy Protocols (SMTP, POP, IMAP) were used if any. Click any log entry for more details. The log entry will show which account and what protocol was used. (Note: The typical use of legacy protocol is Scan to Email from an office scanner)  
  9. Filter the log for Legacy Authentication Use. Click on Client App and select everything listed used “Legacy Authentication Clients” and exclude “SMTP, POP, IMAP” and click Apply.
  10. This will now display the last 7 days of logs where Legacy Authentication was used. The most common are ActiveSync and MAPI over HTTP. This indicates that users have Outlook or Phones connected without Modern Authentication (No MFA).
  11. List down the User accounts using Basic Authentication to prepare the users for Modern Authentication.
  12. List down any 3rd party Service accounts using Basic Authentication. Eg SuiteFiles

Scan to Email (SMTP)

If you have identified that SMTP is in use in the above steps (Step 8) and if required going forward there are three main options below for moving this off Office 365 Basic Authentication. Below are in order of preference: 

  1. Configure Email connector in Office 365 for SMTP Relay. Please see Option 3 Guide from Microsoft here for setup instructions. Requires an external Static IP behind the device/system sending emails.
  2. Scan to Email only required and behind Dynamic IP. If the only requirement is scan to email and the printer only support basic authentication and only a few emails are sent. You can look to use the SMTP Server of your ISP provider, we would advise to also change the send from address to your ISP email account to avoid any Spam/SPF issues. 
  3. If System/Device requires Basic Authentication, then setting up a Secure SendGrid account via Office365/Azure is a good option. See Microsoft’s documentation here. You may also create an account directly at SendGrid.com. 

Create Office 365 Authentication Policy to Block Basic Authencaiton

  1. Open PowerShell and run Connect-ExchangeOnline (Install-Module -Name ExchangeOnlineManagement)
  2. Login Box will appear. Login with Office 365 Global Admin Account.
  3. You are now connected.
  4. Run New-AuthenticationPolicy -Name “Block Basic Authentication”

    This will create the Authentication Policy in Office 365.

  5. Run Set-OrganizationConfig -DefaultAuthenticationPolicy “Block Basic Authentication”

    This will set the policy for all new user accounts that are created in the future.

  6. Run  Get-User | Set-User -AuthenticationPolicy “Block Basic Authentication”

    This will set the policy for all existing accounts. (takes 24hrs to take affect)

    If you receive the above duplicate issue. You can run the below command instead:

    $Users = Get-User
    ForEach($User in $Users)
    Set-User -Identity $User.GUID.Guid -AuthenticationPolicy “Block Basic Authentication”

  7. Now verify if Modern Authentication is Enabled by Default on the tenant.


    Run the following: 

    Get-OrganizationConfig | ft name, *OAuth*

    If False Run the Following:

    Set-OrganizationConfig -OAuth2ClientProfileEnabled:$true

Disable Legacy Protocols on Mailboxes

  1. Open PowerShell and run Connect-ExchangeOnline
  2. Login Box will appear. Login with Office 365 Global Admin Account.
  3. You are now connected.
  4. Verify list of Mailboxes with SMTP/IMAP/POP enabled. By default they are enabled. Run the below command.


  5. Run the following command to disable IMAP/POP/SMTP for all Mailboxes.


    Get-CasMailbox | set-CasMailbox -ImapEnabled $false -PopEnabled $false -SmtpClientAuthenticationDisabled $true

    Then Get-CasMailbox to verify

  6. If you receive a duplicate issue you can use the below command to run again.

    $Users = Get-CasMailbox
    ForEach($User in $Users)
    set-CasMailbox $User.GUID.Guid -ImapEnabled $false -PopEnabled $false -SmtpClientAuthenticationDisabled $true

  7. To disable POP and IMAP upon new mailbox creation run the below command. Get-CASMailboxPlan | set-CASMailboxPlan -PopEnabled $false -ImapEnabled $false

Dealing with Exceptions

Whenever possible, you want to avoid unlocking Basic Authentication. However, there are certain third parties that are still working on their migrations to Modern Authentication. You can enable Basic Authentication on a per user/account basis with the below commands:

  1. Open PowerShell and run Connect-ExchangeOnline
  2. Login Box will appear. Login with Office 365 Global Admin Account.
  3. You are now connected.
  4. Confirm the Block Basic Policy is running on that account.  Get-User -Identity SuiteServiceAccount@companydomain.com | select AuthenticationPolicy
  5. Now create an “Allow Basic Authentication” Policy with the below command. This can be modified to the Basic Authentication Services you require:     New-AuthenticationPolicy -Name “Allow Basic Authentication” -AllowBasicAuthActiveSync -AllowBasicAuthAutodiscover -AllowBasicAuthImap -AllowBasicAuthMapi -AllowBasicAuthOfflineAddressBook -AllowBasicAuthOutlookService -AllowBasicAuthPop -AllowBasicAuthPowershell -AllowBasicAuthReportingWebServices -AllowBasicAuthRpc -AllowBasicAuthSmtp -AllowBasicAuthWebServices                                                                                                .
  6. Now run run the following command to apply the new Allow Policy to the account required:  Set-User -Identity SuiteServiceAccount@companydomain.com -AuthenticationPolicy “Allow Basic Authentication”
  7. This is only applied to that account and all other accounts will still be blocked as default. 
  8. In rare instances you may also have to change the Default Policy to Null if you encounter issues after setting a service user to Null. We have not seen this with accounting applications. If you encounter this you may run the following command to test. Set-OrganizationConfig -DefaultAuthenticationPolicy $Null . This will not change the status of the accounts where the block policy was directly set and should be avoid where possible. 

Note that the authentication policies assigned to users take precedence over the default policy.

Troubleshooting Outlook & Phone Authentication 

Once Basic Authentication is blocked any device/system still using basic will require to re-authenticate.


User can end up in a prompt loop if the Phone was using ActiveSync with Basic Authentication. In order to switch the Phone over to Modern Authentication, the email account needs to be removed from the Phone and re-added. When it is re-added the phone will detected to use Modern Authentication and prompt for MFA.  


Confirm computers are all using Office 2013+. Office 2010 is EOL and doesn’t support Modern Authentication. 

Below is an example of a Basic and Modern Authentication Prompt, if you are still receiving Basic Prompt after disabling you may need to investigate.

In most cases you do not need to re-profile Outlook, but clear the saved Basic Authentication Settings. 

  1. Close Outlook
  2. Go to Control Panel then Credential Manager
  3. Go to Windows Credentials
  4. Remove any saved Credentials that relate to the Email/Outlook account.
  5. Reopen Outlook, if you are still not prompted for Modern Authentication – continue the below steps
  6.  Check for the following registry keys: 


    16.0 for Office 2016 and 15.0 for Office 2013

    [HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\Common\Identity “EnableADAL”=dword:00000001

    If EnableADAL is set to 0 change this to 1. If the Key doesn’t exist create a DWORD with Value 1

    Retest Outlook – If still not prompting you can set the following two keys to enforce Modern Authentication.

    [HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\Common\Identity “DisableADALatopWAMOverride”=dword:00000001

    [HKEY_CURRENT_USER\Software\Microsoft\Office\16.0\Common\Identity “DisableAADWAM”=dword:00000001

  7. Reboot the Computer if still having issues with Modern Authentication. 

  8. If after Reboot you are still being prompted with Basic Authentication, remove any old saved Basic Identities in the Registry. These can be found here:    HKEY_CURRENT_USER\SOFTWARE\Microsoft\Office\16.0\Common\Identity\Identities
  9. Look for any Identity Keys with “AD” appended at the end and remove. This should cause a reauthentication in Outlook and doesn’t remove the Email Profile. Do not remove any keys already showing “ADAL” which is Modern Authentication. 

Updated on June 18, 2021

Related Articles

Need Support?
Can't find the answer you're looking for?
Contact Support