Microsoft SharePoint: Retirement of IDCRL authentication protocol and enforcement of OpenID Connect and OAuth protocols

Plan for Change
Major Change

Message ID

MC1184649
View in Message Center

Services

SharePoint Online
Microsoft OneDrive

Summary

Microsoft is retiring the legacy IDCRL authentication protocol in SharePoint Online and OneDrive for Business by January 31, 2026, enforcing modern OpenID Connect and OAuth protocols. Legacy authentication will be blocked by default, with temporary re-enablement via PowerShell until April 30, 2026, and permanent retirement from May 1, 2026. Organizations should migrate to modern authentication promptly.

Details

Introduction:

As part of the Microsoft Secure Future Initiative (SFI) and in alignment with the “Secure by Default” principle, we’re retiring the legacy IDCRL (Identity Client Run Time Library) authentication protocol in SharePoint Online and OneDrive for Business. This change helps strengthen your organization’s security posture by enforcing modern authentication standards—OpenID Connect and OAuth—which reduce exposure to outdated and vulnerable authentication methods.

When this will happen:

  • Starting January 31, 2026: Legacy client authentication will be blocked by default. Organizations may temporarily re-enable it using PowerShell until April 30, 2026.
  • Starting May 1, 2026: Legacy client authentication will be permanently blocked and cannot be re-enabled.

How this affects your organization:

Who is affected:

  • Organizations using clients, scripts, or applications that rely on the legacy IDCRL authentication protocol to access SharePoint Online or OneDrive for Business.
What will happen:
  • Legacy authentication calls using IDCRL will be blocked by default starting January 31, 2026.
  • Temporary re-enablement is possible via PowerShell until April 30, 2026.
  • After May 1, 2026, IDCRL authentication will be permanently retired and cannot be re-enabled.
  • Applications using IDCRL will fail to authenticate unless updated to use modern protocols.

What you can do to prepare:

We recommend migrating from legacy authentication protocols to modern authentication as soon as possible. 

To prepare for this retirement:

Compliance considerations:

No compliance considerations identified, review as appropriate for your organization.

Timeline

Published
Nov 11, 2025
Updated
Nov 11, 2025
Action Required By
Jan 30, 2026
End Date
Jun 1, 2026

Tags

User impactAdmin impactRetirement

Category

Plan for Change