开发者

应用获得的权限,永远不会多于你。

REZICS 分别记录登录、代表身份、资源权限和应用授权。应用程序和 AI 代理的令牌只能在这些边界内进一步缩小权限。

四层

权限逐层收窄

账户、身份、安装与同意、令牌范围分成四层记录,内层始终位于外层范围内。应用获得的权限只会到最内层。

四张纸片由大到小叠在一起,最外层是深蓝灰色,最上面是最小的一张浅蓝色纸。

逐层

每一层负责什么

  • 账户

    账户服务确认你的身份。登录本身不代表可以操作任何资源。

  • 身份

    你以个人或组织身份操作,服务器会检查这层代表关系和资源权限。

  • 安装与同意

    安装和同意分别构成一道权限上限。注册应用本身不会获得任何资源权限。

  • 令牌范围

    令牌只包含你同意的权限范围,例如 library:write。每项操作仍会重新检查本次使用的身份。

授权

授权码与 PKCE

GET /api/auth/oauth2/authorize
  ?response_type=code
  &client_id=…
  &redirect_uri=https://a.example/
  &scope=work:read%20library:write
  &code_challenge=…
  &code_challenge_method=S256
  &state=…
授权请求会发送到 REZICS 账户服务。回调网址必须与注册时完全一致。

同意

同意页面会注明这些信息

REZICS 自有产品不会显示同意页面,它们会以产品会话的形式列在账户页面中。

  • name · uri

    应用名称和网站

  • scopes[].description

    每项权限都会用你的语言说明,缺少译文时使用英文

  • unverified

    应用尚未通过验证时会明确标出

  • redirectHost

    授权完成后跳转到哪个域名

  • policy · terms

    应用的隐私政策和服务条款

撤销

随时撤销授权

  • 查看

    账户的“已连接应用”页面会列出每个应用的权限、授权时间和最近使用时间。

  • 确认

    移除前会再次验证你的身份。

  • 失效

    移除后,应用持有的令牌将无法继续使用,续期令牌也一样。

  • 停用

    REZICS 停用的应用会明确标出,你仍然可以移除它留下的授权。

用同一套 API,打造自己的工具。

让自己的程序读写作品、书架和社区数据。每次操作都遵循 REZICS 的身份与授权规则。