授权服务（@uniboot/auth） ​

与框架无关的 OAuth 2.0 登录状态机与路由权限守卫，将 登录 一文中的授权中心跳转、换票、路由拦截沉淀为可复用能力。账号资料、忘记密码等由 @uniboot/admin 负责。

类型以 XxxLike 描述宿主 router / user，不直接依赖具体版本的 vue-router。peerDependencies：vue、vue-i18n、uniboot-ui。dependencies：@uniboot/request。

Auth 模板接入 ​

三服务地址均需配置（与 用户服务 一致）：

模板职责拆分：

// src/setup/auth-runtime.ts（节选）
oauthAuthService = createOAuthAuthService({
  authServiceUrl: config.authServiceUrl,
  appBase: config.appBase,
  redirectUri: config.redirectUri,
  clientId: config.clientId,
  http, // 与守卫共用；401 刷新也走同一实例
  tokenPath: '/oauth/token',
  refreshTokenPath: '/oauth/refresh_token',
})

setupAuthPermissionGuard({
  router,
  oauth: oauthAuthService,
  useAuthServiceLogin: Boolean(config.authServiceUrl?.trim()),
  user: createAuthPermissionUserBridge(),
  // loginPath / whiteList / dynamicRoutes / progress / feedback ...
})

// src/router/guard/permission.ts
import { setupPermissionGuard } from '@/setup/auth-runtime'
import request from '@/utils/request'

export default function createPermissionGuard(router: Router) {
  setupPermissionGuard(router, request)
}

refreshHttpAccessToken（HTTP 401 拦截器）与守卫共用同一个 oauthAuthService，登录 / 刷新 / 路由拦截的 token 语义一致。须在 createRouter 之后、app.use(router) 之前注册守卫。

createOAuthAuthService ​

把「统一授权中心登录」拆成纯函数，中间状态默认写入 sessionStorage（可换 OAuthStorageLike）。

参数 ​

返回值 ​

setupAuthPermissionGuard ​

组装 router.beforeEach：访问拦截 → 授权中心 → 回调换票 → 动态路由。

参数 ​

执行流程 ​

1. OAuth 回调（URL 带 code 且未登录）：校验 error / state → 换票写 token → takeAndClearReturnPath 跳回。
2. 白名单：放行；若目标是 loginPath 且启用了 useAuthServiceLogin，记忆 redirect 后跳转授权中心。
3. 已登录：有用户信息则放行；否则 loadUserInfo → 挂动态路由 → next({ ...to, replace: true })；失败则清登录态回登录页。
4. 未登录且未启用 OAuth：跳转本地登录页并带 redirect。
5. 未登录且启用 OAuth：记忆地址后整页跳转授权中心，next(false)。

createAuthApi ​

本地表单登录场景（Auth 模板默认走 SSO，通常不直接用）。

参数 ​

方法 ​

useLoginAccount({ api }) 把 LoginPage 表单值映射为登录请求（trim 用户名并透传验证码）。

AuthLoginPage ​

不启用 useAuthServiceLogin、在前端渲染登录表单时使用。内部已接 useLoginAccount；写 token、跳转仍由宿主在 onFinish 中完成。Auth 模板默认 SSO，不引用该组件。

属性 ​

事件 / 插槽 ​

i18n ​

mergeUnibootAuthLocales(i18n) 合并 authLocaleZhCn / authLocaleEn 到 zh_CN/zh-CN、en_US/en-US。命名空间为 unibootAuth.login.*。Auth 模板在 uniboot-admin 安装插件里与 admin 文案一并处理；账号域更多文案见 @uniboot/admin。