发现文档与企业身份校验

发现文档与企业身份校验

企业在 HTTPS 地址 https://{domain}/.well-known/poppy.json 公布发现文档。个人 Agent 取得文档后,不能只看到一个 API URL 就开始发送凭据。

校验两个方向

首先,organization.domain 应对应发现重定向后真正提供文档的主机。然后,从 auth.issuer 找到 OAuth 服务元数据,核对其中 issuer 与声明逐字符一致,且 poppy_domains 包含企业域名。

这两步分别防止文档被复制到其他域名冒充企业,以及其他域名擅自声称属于某个 OAuth issuer。issuer 可以带路径,不能为了方便只比较主机名。

issuer 确定企业边界

同一企业的多个域名可以使用相同 issuer;托管多个企业的服务提供商应给每家企业独立 issuer。否则本应分离的用户标识、会话与账号授权会被混在一起。

个人 Agent 也有身份

个人 Agent 的 client_id 是返回其元数据的 HTTPS URL。企业从经校验的元数据获取公开密钥和允许的回调地址。公开密钥与私钥、DPoP 密钥不能混为一谈,也不能信任请求任意附带的密钥地址。

获取元数据时的限制

这是访问对方控制的 URL:限制超时、响应大小和重定向次数;不要带 Cookie 或授权头;检查实际连接地址,默认拒绝回环、私网与链路本地地址。发现重定向与携带凭据的业务请求重定向遵循不同规则。

来源:0.2 草案 §3–4和官方指南。下一步:接入路线。

最后更新于