多租户与隔离（Multi-tenant & Isolation）

什么是多租户与隔离能力

开放平台在统一身份能力之上，为 B 端运营提供多租户能力：把应用按分组（group）组织，对可访问的域名做白名单授权，按应用配置登录策略，并留存登录日志用于审计。

多租户是「运营 / 隔离」能力，与身份联邦（统一身份）正交：统一身份解决"用户是谁"，隔离能力解决"哪些应用 / 域名 / 策略 / 日志归在一起管"。

应用分组（group_key）

应用可归入同一 group_key（如 yunjii_products），用于：

• 分组 SSO（group_sso 策略）：同组应用共享登录态，用户一次登录即可在组内互通。
• 批量授权：按组维度统一配置域名、策略与权限，避免逐应用重复设置。

{
  "login_policy": "group_sso",
  "policy_config": {
    "group_key": "yunjii_products",
    "max_devices": 3,
    "ip_whitelist": []
  }
}

域名授权

每个应用的授权域名白名单记录允许发起授权 / 回调的域名。未在该白名单内的域名发起 OAuth 流程会被拒绝（错误码 10006 域名未授权）。

• 支持格式：域名、IP、带端口（如 https://app.example.com、192.168.1.10、https://app:8080）。
• 对接方在控制台标签式输入，或由平台管理员统一配置。

登录策略配置

在控制台应用详情页配置 login_policy，可选 6 种策略（详见 访问控制）：

策略	说明	适用场景
independent	独立登录	单应用
group_sso	分组 SSO	产品线内
global_sso	全局 SSO	集团级
single_device	单设备登录	安全要求高
multi_device	多设备登录	消费级应用
ip_bound	IP 绑定	内部系统

登录日志与审计

平台记录每次登录 / 授权事件，用于安全审计与异常排查，常见用途：

• 识别异常登录 IP、设备与频次（配合限流错误 90002 登录失败过多）。
• 审计账号绑定变更、跨应用账号合并轨迹。
• 排查 token IP 不匹配（50004）、token scope 不足（50005）等策略类问题。

下一步

• 访问控制 — 登录策略与权限注册表
• 统一身份 — 一个身份贯通所有平台
• OAuth API 参考 — 端点与错误码完整说明