Provider 认证
Provider 认证在 Provider manifest 的 auths[] 数组中声明。每个条目告诉 Bricoop 使用哪种凭据或流程、在界面中如何标注,以及是否启用。Bricoop 绝不会把凭据发送给第三方,也绝不会把它存储在用户设备之外;auths[] 条目只描述 Bricoop 如何在本地获取凭据。
认证方式
每个 auths[] 条目上的 method 字段选择认证策略。api_key 方式要求用户粘贴一个 key,oauth 方式针对 Provider 运行授权码流程,device_code 方式显示一个让用户在 Provider 设备审批页输入的码。每个条目携带一个 name、一个 method 和一个 enabled 标志;Provider 可以声明多种方式,让用户选择适合其账户的方式。
密钥保留在本地
凭据和 token 存储在用户设备上、由 Bricoop Desktop 管理的本地凭据存储中。它们从不会以明文写入日志,从不会同步到云端账户,也从不会发送到除签发该凭据的 Provider 之外的任何端点。Bricoop 是本地连接层,不是云端中继;请求直接从用户设备发往 Provider。
错误与刷新
过期或无效的凭据会在 Bricoop Desktop 中以明确的错误展示,并标出 Provider 和方式,让用户知道该修复哪条。Token 刷新遵循 Provider 公布的 token 策略;当刷新失败或 Provider 吊销 token 时,Bricoop 停止路由请求并要求用户重新认证。用户随时可以在 Bricoop Desktop 中吊销凭据,吊销后会立即从本地存储中移除。