用途:为 WPF(Windows Presentation Foundation)桌面应用添加 Auth0 认证,通过 Auth0.OidcClient.WPF 包在弹窗式 WebView2 控件中展示 Auth0 Universal Login 页面,完成基于 OIDC 授权码 + PKCE 的登录与登出。与移动端原生 SDK 不同,回调完全由 WebView2 导航事件处理,无需注册 URL scheme、Info.plist 或 AndroidManifest.xml。
主要能力:登录(LoginAsync)、登出(LogoutAsync)、令牌刷新(RefreshTokenAsync,需 offline_access 作用域)、读取用户 claims(name、email、picture 等)。
使用方式:先安装包 dotnet add package Auth0.OidcClient.WPF;在 Auth0 Dashboard 配置 Native 类型应用,将默认回调地址 https://{yourDomain}/mobile 同时加入 Allowed Callback URLs 与 Allowed Logout URLs;在代码中用 Domain、ClientId、Scope 初始化 Auth0Client,并把登录/登出绑定到 XAML 按钮事件;构建用 dotnet build 验证。代理可先运行 gh api repos/auth0/auth0-oidc-client-net/releases --jq '[.[] | select(.tag_name | startswith("wpf-")) | .tag_name | ltrimstr("wpf-")] | .[0]' 获取最新版本号用于依赖。
适用场景:Windows 桌面 WPF 应用(.NET 6.0+、Windows 10+、Edge WebView2 运行时、Native 类型 Auth0 应用)。
限制:不适用于 .NET MAUI、Windows Forms、ASP.NET Core Web、iOS、Android 项目;Domain 只写主机名,不加 https://;Native 应用不使用 ClientSecret;需在物理 Windows 机器上测试登录到回调的完整流程。