用途:在本地开发与测试中模拟 Sign in with Apple / Apple OIDC,让应用无需连接真实 Apple 服务即可走通登录流程。
主要能力:支持授权码流程、PKCE、RS256 签名的 ID token 与 OIDC discovery;提供 authorize、token、keys、revoke 等端点,可映射真实 Apple URL。支持种子配置用户与 OAuth 客户端;未配置客户端时接受任意 client_id,配置后严格校验 client_id 与 redirect_uri。is_private_email 用户会生成 @privaterelay.appleid.com 邮箱。
使用方式:运行 npx emulate --service apple,默认端口 4000;或以编程方式 createEmulator({ service: 'apple', port: 4004 })。默认监听 127.0.0.1,容器或跨机访问可传 --host 0.0.0.0 或 hostname: '0.0.0.0',并用 --base-url / baseUrl 配置对外可达地址。通过 APPLE_EMULATOR_URL 指向模拟器,并映射 OIDC 发现、authorize、token、keys、revoke 端点。可与 Auth.js / NextAuth.js、Passport.js 集成。
适用场景:本地或 CI 中测试 Apple 登录、OIDC 集成与 token 校验。
限制:仅用于开发与测试,非真实 Apple 服务;刷新不签发新 refresh_token;具体收费与平台支持暂未提供。