token 模型

VisibleBase 使用 admin_secret_key 管理 Base，并使用 user_token 让终端 client 调用 service。

可信后端你的后端使用 AdminClient，并持有 admin_secret_key。创建 product / 申请 user_token

VisibleBase校验 admin_secret_key，签发 user_token，并在内部保存 provider key。

终端 client前端、插件或 App 只拿 user_token + product_id，使用 UserClient 调 service。拿不到 admin_secret_key

user_token

user_token 是给终端用户或产品 client 使用的调用凭证。它由 AdminClient 基于 product_id + user_id 向 Base 申请。

product_id
user_id
metadata
ttl

client 只携带 user_token 和 product_id，不接触 provider key，也不接触 admin_secret_key。

admin_secret_key

VISIBLEBASE_ADMIN_SECRET_KEY 用于管理 Base：创建 product、管理 env、为某个 product 下的用户签发 user_token。Base 首次启动时会自动生成并写入 .env。

const client = new AdminClient({
  base_url: "https://base.example.com",
  admin_secret_key: process.env.VISIBLEBASE_ADMIN_SECRET_KEY,
});

const product = await client.products.create({
  name: "Chrome Extension",
});

多产品复用

多个 client 可以归属同一个 product。签发 token 时明确写入 product_id：

const user = await client.tokens.apply({
  product_id: product.product_id,
  user_id: "user_123",
  metadata: {
    plan: "pro",
  },
  ttl: "7d",
});

console.log(user.user_token);

user_token

admin_secret_key

多产品复用

目录