Framework-agnostic, zero-state authentication toolkit for MoonBit: third-party login (11 providers), Passkey/WebAuthn, and TOTP with all non-determinism injected through seams.
🔴 三句定位声明(务必先读)
- 库不建号:不创建、不修改任何用户账号。
- 库不存映射:不保存 uid ↔ 用户 的对应关系(ExternalIdentity 交还给你,落库由你负责)。
- 库不发会话:不签发、不校验 session / token / cookie,不持有任何登录态。
| Target | 支持 | 说明 |
|---|---|---|
| native | ✅ | 首选目标;moon build --target native 全绿 |
| js | ✅ | moon build --target js 全绿 |
| wasm-gc | ❌ | 明确不支持,原因见下 |
wasm-gc ❌ 'justinwongcn/experimental_crypto/getrandom' supports [js, native]name = "your/app"
version = "0.1.0"
import {
"justinwongcn/moonauthn@0.1.0",
}import {
"justinwongcn/moonauthn/provider/google" @google,
}子包彼此隔离(LIB-20):只 import 你真正用到的那条链路即可,不会把其他平台拖进依赖图。
let config = @google.GoogleConfig::new("YOUR_CLIENT_ID", "https://your.app/cb")let secrets : @core.SuppliedSecrets = {
state: None, // 留空 → 由注入的 RandomSource 生成
code_verifier: None, // 留空 → PKCE verifier 自动生成
nonce: None, // 留空 → OIDC nonce 自动生成
}
let start = @google.begin_auth(config, secrets)
// 把浏览器 302 到 start.url;把 start 暂存在你的会话/缓存里(库不替你存)
println(start.url)let callback = @core.CallbackParams::from_query_string(code_and_state_from_query)
let identity = @google.complete_auth(config, callback, start)
// identity.uid / identity.email / identity.email_verified / identity.uid_kind ...
println(identity.uid) // = Google 的 sub完整可运行、零网络零资质(固定向量)的版本见 examples/minimal-google 与 examples/bare-async。
| 子包 | 能力 |
|---|---|
| core | 值类型(ExternalIdentity / AuthStart / CallbackParams …)、AuthError、能力 seam(trait)、字典序工具 |
| rand | RandomSource 默认实现 GetrandomSource(唯一接触 getrandom 的地方) |
| oauth | OAuth 2.0 授权码 + PKCE 默认实现(StandardOAuthAuthCode)、base64url 工具 |
| oidc | OIDC id_token 验签(JwksIdTokenVerifier,RS256/JWKS) |
| passkey | WebAuthn 验签(StandardWebAuthnVerifier)+ PasskeyService(challenge 一次性 + TTL) |
| totp | TOTP / 恢复码(StandardTotpPrimitive + TotpService) |
| store-memory | ChallengeStore 内存实现(MemoryChallengeStore) |
| provider/google provider/apple provider/x provider/wechat provider/qq provider/alipay provider/github provider/discord provider/dingtalk provider/feishu provider/microsoft | 十一个平台的 facade(begin_auth / complete_auth + 归一化),每个相互隔离;飞书内置 Lark 国际版端点预设(with_lark(),已按官方文档核实);钉钉国际站端点未能核实故不内置(用 with_endpoints 配置,见其平台文档);微信另含小程序登录 wechat_code2_session(官方文档核实),支付宝身份键 open_id 优先(官方口径) |
| contract | 参数化契约测试骨架(SDK-04)+ 固定测试向量,下游可复用 |
| 示例 | 演示 |
|---|---|
| examples/minimal-google | 只依赖 provider/google 的最小模块(LIB-20 隔离断言) |
| examples/bare-async | 裸 async handler:串起 Google + passkey + TOTP(mock/向量,零网络) |
| examples/moonback | moonback 只做路由,鉴权走库 |
| examples/mars | mars 只做路由,鉴权走库 |
moon run examples/bare-async/src # 打印 Google 身份 / passkey 契约 12/12 / TOTP RFC 6238 向量
moon run examples/moonback/src # 真实路由:/healthz 与 /auth/google/callback(含 state 篡改负例)
moon run examples/mars/src # 同上,mars 版🔴 注意:examples/* 是独立模块(经工作区文件 moon.work 以本地路径解析库), 它们不进库本体的依赖图。
// 用官方 SDK 的验签替换库默认实现:实现 trait 即可
struct OfficialVerifier { /* ... */ }
impl @core.IdTokenVerifier for OfficialVerifier with fn verify(self, token, expect) {
// 调官方 SDK……
}moon build --target native # native 编译
moon build --target js # js 编译
moon test --target native # 全量测试(native)
moon test --target js # 全量测试(js)
./ci/check.sh # 本地一键 CI:双 target 编译 + 全量测试 + 隔离/泄漏断言 + 文档一致性Install
Download zipFramework-agnostic, zero-state authentication toolkit for MoonBit: third-party login (11 providers), Passkey/WebAuthn, and TOTP with all non-determinism injected through seams.