本页说明每个页签、每个按钮做什么、怎么点、点完会看到什么。演示站是接入方样例,不是账号中心本身。
演示站地址:https://rp.s--s.top/。身份提供者(本系统)地址:https://zhzx.roomnode.cn。
本站以机密应用接入:client_id 为 sb_demo_rp,客户端密钥只存在服务器 .env,浏览器里看不到。浏览器只保存名为 demo_rp 的演示会话饼干。
prd_… 发心跳。?提示=登录已完成。不需要登录。演示站后端去本系统拉三个公开接口,用来确认网络和发现文档正常。
https://zhzx.roomnode.cn/healthz。健康.状态码 = 200 且正文为 ok;发现.状态码 = 200,正文含 issuer、authorization_endpoint、token_endpoint;支付目录.状态码 = 200。标准开放登录。电脑浏览器跳到本系统账号中心,用户登录并同意后,带着 code 回到演示站,由服务器用客户端密钥换访问令牌和刷新令牌。
https://zhzx.roomnode.cn/v1/oidc/authorize,带 response_type=code、client_id、redirect_uri(https://yanshi.roomnode.cn/回调)、scope、state、nonce、code_challenge(S256)。openid profile email phone offline_access license.read。/回调。成功则跳到首页并提示「登录已完成」。client_id 时会报错而不跳转。/v1/oidc/userinfo。未登录会失败。用来确认令牌能换到用户声明(如 sub)。/v1/oidc/token(grant_type=refresh_token),换新的访问令牌。需要当初授权带了 offline_access。/v1/oidc/revoke 作废当前访问令牌。会话里的刷新令牌还在,可再点「刷新令牌」拿新访问令牌。随后「读取 userinfo」应失败,直到刷新成功。sub。error,提示失败,仍未登录。https://yanshi.roomnode.cn/回调。电脑展示登录票二维码,手机打开账号中心确认。票有效约 2 分钟。状态:待扫 → 已扫 → 已确认(或 已取消 / 已过期)。确认后演示站用票上的 code 换令牌,效果与网站登录相同。
https://zhzx.roomnode.cn/scan?ticket=…。/scan?ticket=…。未登录则先登录。过期后必须重新「生成二维码」。同一张票只能确认一次。
POST /v1/oidc/qr/tickets 创建登录票(带 PKCE)。会覆盖上一张未用完的票。二维码内容就是扫码地址,不是令牌。POST /v1/oidc/qr/poll。未生成票时按钮不可点。若状态已是「已确认」且带回 code,本站立即换票并写入会话。买许可是身份提供方第一方商城:账号中心用会话饼干建订单。演示站只拿 OIDC 令牌做心跳,不代收、不建订单。本页签是跳转入口。
https://zhzx.roomnode.cn/orders。lic_…,复制该许可的产品编号 prd_…,回演示站「试用授权」发心跳。付费插件请到「插件」页签扫码购买,不要用账号中心订单页的「积分/许可」去买插件。测试机管理员可对本人待支付订单点「模拟支付」。
POST /v1/orders。lic_…,其产品编号为 prd_…。模拟接入软件定期向本系统报到。必须先完成开放登录,且令牌范围含 license.read。当前用户须已有该产品的许可:可走「扫码买许可」,或由管理员签发试用。没有许可时心跳会拒绝运行。
sub(成对用户标识)sub 去填签发框。prd_ 加一串十六进制。产品由「管理签发 → 创建产品」生成;不要填产品名称,也不要填中台 sku_ 或「我的应用」里的 sb_/prod_ 应用标识。演示站心跳框和管理员签发时必须完全相同。sku_ 的商品编号,只用于网售下单。创建产品时可选绑定;心跳和签发许可都不要填它。sub(64 位十六进制)。sub,得到用户编号(UUID)。prd_…;要网售再填中台 sku_…(先在「价目表」建好)。prd_…,或点该行「填入签发」。签发许可:类型选「试用」,用户编号贴上一步的 UUID,填到期时间,点「签发许可」。prd_… 填进产品编号。设备指纹已自动生成,不要改。prd_…。空着发送会提示填写。必须和管理员签发时用的编号一致;填成中台 sku_ 或应用标识都会导致没有许可。POST /v1/licenses/heartbeat,正文含产品编号和 64 位指纹哈希。未登录会 401。本机指纹存在浏览器 localStorage。演示站用 OIDC 访问令牌列出已上架插件,并可安装/卸载。P0 不在本机执行插件:安装只把 zip 存到演示数据目录。付费插件在本页扫码购买,支付后才能安装。
GET /v1/plugins,带访问令牌,返回是否已购。演示站/数据/已装/{sub}/。POST /v1/plugins/{id}/orders,支付方式扫码。不要走账号中心订单页的积分/许可商品。客户端凭证(client_credentials)发给应用自己,没有用户。演示站是机密应用,服务器会带 client_secret 去换票。这和「用本系统登录」不是同一条轨道。
/v1/oidc/token 提交 grant_type=client_credentials,范围 license.read。只证明「这个应用拿得到机器令牌」,不会写入演示会话,也不能当作用户去做试用心跳。access_token。这是应用身份,不是 sub,本页也不会把它写进登录会话。接口路径以本系统 OpenAPI 为准:https://zhzx.roomnode.cn/openapi.json。OIDC 发现文档:/.well-known/openid-configuration。