Mock 认证服务器
这是一套开箱即用的在线 Mock 认证服务,部署在 Cloudflare Workers 上。认证/授权流程通常需要多个角色协作(签发令牌的一方、消费令牌的一方、受保护的 API……),自己把它们全搭起来很费事。本 Mock 把这些角色都实现好并放在公网,你可以:
- 联调:开发客户端时,不必先搭一套 Keycloak / ADFS,直接对接本站的 Mock;反过来,只有服务端也能用本站的 Mock 客户端来打你的服务。
- 集成测试:CI 中以固定、可预期的响应验证你的认证集成代码(追加
&user=alice可免交互)。 - 学习演练:配合协议文档,实际观察每一步报文长什么样。
角色与术语
以 OAuth 2.0(RFC 6749) 定义的四个角色名为准;OIDC(OpenID Connect Core)与 SAML 2.0 只是同一批角色的不同叫法。下表按“同一角色,不同规范里的名字”对齐:
| OAuth 2.0(RFC 6749) | OIDC | SAML 2.0 | 中文 / 职责 | 本 Mock |
|---|---|---|---|---|
| Resource Owner | End-User | Principal(Subject) | 资源所有者 / 终端用户,授予同意 | 测试用户 alice / bob |
| Authorization Server | OpenID Provider(OP) | Identity Provider(IdP) | 签发方:验证身份、签发令牌 / 断言 | /oidc/*、/saml/idp/* |
| Client | Relying Party(RP) | Service Provider(SP) | 消费方:发起登录、校验令牌 / 断言 | /rp/、/saml/sp/* |
| Resource Server | Resource Server | —— | 资源服务器 / 受保护 API | /rs/api |
RFC 6749 用的名字是 Resource Owner / Client / Authorization Server / Resource Server。OIDC 把 Authorization Server 叫作 OP、把 Client 叫作 RP;SAML 则叫 IdP / SP——都是同一批角色的别名。其中 Resource Owner 是人(不是可对接的服务),本站由授权页选择 alice / bob 代表,因此下文只展开可对接的服务角色。
两侧的角色、端点与分步调用顺序分别见:
- 🔷 OIDC / OAuth2 Mock —— OP / RP / RS 三角色 + 授权码 + PKCE 调用顺序
- 🔶 SAML Mock —— IdP / SP 两角色 + Web Browser SSO 调用顺序
- 📬 邮件服务器 —— 用 Email Routing 接收
@authn.tech邮件,在线 / API 查看并抽取一次性验证码 - 🗂 LDAP 目录 —— HTTP/JSON 目录搜索模拟器,按 RFC 4515 过滤器在示例目录里搜(非真 LDAP 协议)
仅供测试
签名私钥公开在源码中,任何人都能伪造该服务签发的令牌 / 断言;授权码也不保证单次使用(无状态实现)。任何生产系统都不应信任 Mock 服务签发的断言或令牌。
混搭:用你自己的服务替换其中一环
Mock 的价值在于只 mock 你还没有的那部分,其余用你自己的真实服务。常见组合:
| 你已经有 | 用 Mock 补上 | 怎么接 |
|---|---|---|
| RP / 客户端 | Mock OP | 把你 RP 的 issuer 指向 https://mock.authn.tech(自动发现 /.well-known/openid-configuration) |
| OP / 授权服务器 | Mock RP | 打开 /rp/ 控制台,填你的 issuer 与 client_id,并把 …/rp/callback 加入白名单 |
| 受保护 API 但缺令牌来源 | Mock OP | 从 Mock OP 用 client_credentials 或授权码取 access_token,再拿去调你的 API |
| API 客户端但缺受保护资源 | Mock RS | 用 Mock OP 签发的令牌调 /rs/api,验证你客户端的 401 / 403 处理 |
| SP / 受信应用 | Mock IdP | 把 /saml/idp/metadata 导入你的 SP |
| IdP | Mock SP | 把你 IdP 的 Metadata 配到 Mock SP,或用 IdP-initiated 发到 Mock SP 的 ACS |
思路统一:签发方(OP / IdP)与消费方(RP / SP)总是成对出现,你补齐缺的那一方,让 Mock 与你的真实服务对接,就能端到端跑完整个流程。
实现进展与需求欢迎到 GitHub 参与讨论。