用途：One Auth 是预构建的可嵌入认证组件，让用户在你的应用中连接第三方应用（Gmail、Slack、HubSpot、Salesforce、QuickBooks 等），支持 250+ 集成，涵盖 OAuth 与非 OAuth，并自动处理令牌管理与刷新。
主要能力：提供 React Hook（useOneAuth）等前端接入方式，可与 React、Vue 或原生 JS 配合；通过 One Dashboard 按项目配置可见应用、使用自有或默认 OAuth 凭据、自定义 scopes，支持多租户架构；授权成功后返回连接详情供存储，之后可用 connection key 调用 Passthrough API 访问第三方平台。
使用方式：安装 npm install @withone/auth；后端需提供令牌端点，并调用 POST https://api.withone.ai/v1/authkit/token?page={page}&limit={limit}，在 X-One-Secret 头中携带 ONE_SECRET_KEY，请求体包含 identity 与 identityType。端点必须使用完整 URL、包含 CORS 头、通过 x-user-id 识别用户并处理 page/limit 分页参数。前端配置 token.url（完整 URL）及自定义头，可通过 selectedConnection 直接打开某个集成（使用显示名，如 "Gmail"）。成功后保存 connection.key、platform、environment 等字段到数据库；可用 GET https://api.withone.ai/v1/available-connectors?authkit=true 列出可用集成，用 POST https://api.withone.ai/v1/passthrough/{platform}/{action} 调用具体接口。
适用场景：需要让终端用户自行授权并连接多个第三方 SaaS 平台的应用，尤其是多租户或按项目隔离授权的产品。
限制：需要后端令牌端点，无法纯前端独立完成；令牌 URL 必须为完整 URL，相对路径会静默失败；Chrome 在本地开发时可能阻止 iframe 请求 localhost，可通过 chrome://flags 的 Block insecure private network requests 设为 Disabled，或使用 ngrok。收费、价格与具体套餐信息暂未提供。