OAuth 2.0 · 支持 FrameX

接入 FrameX,让身份保持集中。

Y账号提供基于标准的授权码流程,支持 PKCE、短生命周期 JWT 访问令牌与刷新令牌轮换。

授权码 + PKCE JWT · HS256 PKCE · S256

接入路径

在 api_clients 表中注册 FrameX 客户端,配置回调地址,然后引导用户访问 /oauth/authorize。占位配置已就绪,填入真实凭据即可启用生产流量。

  1. 创建 OAuth 客户端,登记回调地址并保存密钥哈希。
  2. 携带 state 与可选的 S256 code challenge,将用户重定向到 /oauth/authorize。
  3. 在 /api/v1/oauth/token 换取令牌,然后调用 /api/v1/oauth/userinfo。

授权 / 令牌

本项目不包含任何生产 FrameX 密钥。请使用 bin/create-client.php 创建客户端,并将密钥保存在服务器环境变量中。

GET https://account.yanshiyi.com/oauth/authorize
POST https://account.yanshiyi.com/api/v1/oauth/token
GET https://account.yanshiyi.com/api/v1/oauth/userinfo
POST https://account.yanshiyi.com/api/v1/oauth/revoke
完整请求示例与客户端创建命令见 README.md。

内部登录

使用内部账号接口完成服务间认证,或通过 OAuth 2.0 接入 FrameX。

POST https://account.yanshiyi.com/api/v1/internal/login