Skip to content

Commit cbc6ebc

Browse files
Add MSAL+WAM disambiguation note to OAuth2Manager page
A developer wanting 'Sign in with Microsoft' with silent SSO would land on this page and not know MSAL+WAM is the better choice. Added a NOTE callout at the top of the article body explaining: - OAuth2Manager = general OAuth, any provider, browser-based - MSAL+WAM = Microsoft/Entra accounts, silent SSO, no browser Co-authored-by: Copilot <[email protected]>
1 parent ff01dfd commit cbc6ebc

1 file changed

Lines changed: 3 additions & 0 deletions

File tree

hub/apps/develop/security/oauth2.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,9 @@ keywords: windows, winui, winrt, dotnet, security
1111

1212
The [OAuth2Manager](/windows/windows-app-sdk/api/winrt/microsoft.security.authentication.oauth.oauth2manager) in Windows App SDK enables desktop applications such as WinUI 3 to seamlessly perform OAuth 2.0 authorization on Windows. The **OAuth2Manager** API doesn't provide APIs for the implicit request and resource owner password credential because of the security concerns that entails. Use the authorization code grant type with Proof Key for Code Exchange (PKCE). For more information, see the [PKCE RFC](https://tools.ietf.org/html/rfc7636).
1313

14+
> [!NOTE]
15+
> **OAuth2Manager** is designed for general OAuth 2.0 flows with any identity provider (GitHub, Google, custom, etc.) and always uses the system browser for the authorization step. If you specifically want to sign in with **Microsoft accounts or Entra ID (work/school) accounts** with **silent SSO** — using the account already signed in to Windows, with no browser prompt — use [MSAL.NET with the WAM broker](https://learn.microsoft.com/en-us/entra/msal/dotnet/acquiring-tokens/desktop-mobile/wam) instead. WAM also provides Windows Hello integration and conditional access support that OAuth2Manager does not.
16+
1417
## OAuth2Manager API in Windows App SDK
1518

1619
The **OAuth2Manager** API for Windows App SDK provides a streamlined solution that meets the expectations of developers. It offers seamless OAuth 2.0 capabilities with full feature parity across all Windows platforms supported by Windows App SDK. The new API eliminates the need for cumbersome workarounds and simplifies the process of incorporating OAuth 2.0 functionality into desktop apps.

0 commit comments

Comments
 (0)