Quick Start

Quick Start

启动

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt

PORT=5003 \
PASSKEY_ORIGIN=http://localhost:5003 \
.venv/bin/python -m jstu_passkey.app

打开 http://localhost:5003。

PASSKEY_ORIGIN 必须与地址栏中的协议、主机和端口完全一致。localhost 可用于本地 WebAuthn；局域网 IP 和生产域名通常需要 HTTPS。

创建管理员

生成一个只使用字母、数字、_、- 的一次性 token：

PORT=5003 \
PASSKEY_ORIGIN=http://localhost:5003 \
.venv/bin/python -m jstu_passkey.app \
  --reregister-admin qpwoeiruty

打开 http://localhost:5003/qpwoeiruty 创建管理员。完成后该 URL 立即失效。

登录后访问：

http://localhost:5003/management

注册普通用户

注册默认关闭。推荐在 Management 中临时开启；本地测试也可以：

PASSKEY_REGISTRATION_ENABLED=true \
PORT=5003 \
PASSKEY_ORIGIN=http://localhost:5003 \
.venv/bin/python -m jstu_passkey.app

主页保持极简：

• 左键连续点击 Logo 5 次：登录
• 右键连续点击 Logo 5 次：打开注册
• Cmd/Ctrl + K：登录
• Cmd/Ctrl + Shift + K 或 Alt + R：注册

登录会跳到标准 Logo 验证页，完成后回到发起页面。

体验接入流程

/demo/oauth          OAuth 示例
/demo/third-party    第三方回调示例
/demo/link-login     Link Challenge 示例

这些页面只是接入样例；它们复用正式 OAuth 与 Passkey 管道，不是另一套 demo 后端。

验证安装

.venv/bin/python -m unittest discover -s tests -v
.venv/bin/python -m compileall -q jstu_passkey tests
node --check jstu_passkey/static/main.js
node --check jstu_passkey/static/management.js

下一步：Authentication Flows 或 Management。