Home

Passkey-Auth

Passkey-Auth 是一个以 Passkey 为核心的 Flask 认证服务。它提供统一 Logo 验证页、OAuth Authorization Code、Link Challenge、服务端 session verify，以及面向用户、平台和安全设置的 Management 控制台。

你要做什么？

• 在本地跑起来：Quick Start
• 接入现有网站或 Hyping：Authentication Flows
• 管理用户、Passkey 与 OAuth Client：Management
• 部署到服务器：Deployment
• 理解安全边界：Security
• 排查 origin、OAuth 或数据库问题：Troubleshooting
• 修改代码：Development

当前设计

浏览器中的 Passkey 验证统一进入 /auth/passkey 或 OAuth Logo 页面。业务页面不直接调用 WebAuthn：

发起页面
  -> 标准 Logo 验证页
  -> 浏览器 Passkey
  -> 服务端验证
  -> 回到发起页面

OAuth、Link Challenge、主页登录和 Management 二次验证共享这套体验。旧的通用 /api/login/options 与 /api/login/verify 已删除。

默认数据库是 instance/passkeys-v2.sqlite3。v2 是全新数据结构，不自动迁移旧数据库。