授权服务（@uniboot/auth） ​

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

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

Auth 模板接入 ​

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

模板职责拆分：

// src/utils/request.ts（节选）
const request = createHttpClient({ baseURL, ...httpCommonOptions })
bindOAuthHttp(request) // 首屏并行 401 前即可刷新

export const { adminApi, userApi, roleApi, authHttp, adminHttp } =
  createUnibootAdminHttpBundle({
    authServiceUrl,
    adminServiceUrl,
    http: httpCommonOptions, // 与业务 request 共用同一 refreshToken 函数引用
  })

// src/setup/auth-runtime.ts（节选）
oauthAuthService = createOAuthAuthService({
  authServiceUrl: config.authServiceUrl,
  appBase: config.appBase,
  redirectUri: config.redirectUri,
  clientId: config.clientId, // 必填
  http, // 须能打到 /oauth/token 与 /oauth/refresh_token（网关场景 = 业务 request）
  tokenPath: '/oauth/token',
  refreshTokenPath: '/oauth/refresh_token',
  // authorizePath: '/oauth/authorize', // 标准授权端点；默认 '/login'
  // getAuthorizeLang: () => (locale === 'zh-CN' ? 'zh_CN' : 'en_US'),
})

setupAuthPermissionGuard({
  router,
  oauth: oauthAuthService,
  useAuthServiceLogin: Boolean(config.authServiceUrl?.trim()),
  user: createAuthPermissionUserBridge(),
  // 可选：本地 token 已过期时仍允许用 URL 中的 code 换票
  // isAccessTokenValid: () => Date.now() < expiresTimestamp,
  // 可选：无菜单但需改初始密码时不要踢 403
  // resolveEmptyRoutesFallback: () => INDEX_ROUTE_NAME,
  // loginPath / whiteList / dynamicRoutes / progress / feedback ...
})

refreshHttpAccessToken（HTTP 401 拦截器）与守卫共用同一个 oauthAuthService。多个 createHttpClient（业务 / auth / admin）应传入同一个 refreshToken 函数引用，由 @uniboot/request 跨实例合并并发刷新。须在 createRouter 之后、app.use(router) 之前注册守卫。

createOAuthAuthService ​

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

参数 ​

返回值 ​

OAuthTokenPair：{ accessToken, refreshToken?, expiresIn? }（expiresIn 为秒）。

另导出工具：stripOAuthCallbackFromBrowserUrl、isLikelyOAuthAuthorizeCallback、omitOAuthCallbackQuery、OAUTH_CALLBACK_QUERY_KEYS。

setupAuthPermissionGuard ​

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

参数 ​

AuthPermissionUserLike 额外可选：setRefreshToken、setExpiresIn(expiresInSeconds)。

执行流程 ​

1. OAuth 回调：URL 有 code 且本地无可用 token（isAccessTokenValid）→ 校验 error / state → 换票写 token / refresh / expiresIn → 清地址栏 OAuth query → takeAndClearReturnPath 跳回。
2. 已登录仍带 OAuth query：code+state 同时存在时 Router replace 清掉，避免敏感参数残留。
3. 白名单：放行；若目标是 loginPath 且启用了 useAuthServiceLogin，记忆 redirect 后跳转授权中心。
4. 已登录：有用户信息则放行；否则 loadUserInfo → 可选 afterUserLoaded → 挂动态路由；无菜单时先问 resolveEmptyRoutesFallback，仍无则清登录态去 403。
5. 未登录且未启用 OAuth：跳转本地登录页并带 redirect。
6. 未登录且启用 OAuth：记忆地址后整页跳转授权中心，next(false)。

createAuthApi ​

本地表单登录或 SSO 登出。注意默认路径语义不同：login 偏业务网关，logout 偏授权服务，必要时拆两个 HTTP 客户端。

参数 ​

方法 ​

import { createAuthApi } from '@uniboot/auth'
import { authHttp } from '@/utils/request'
import { getToken } from '@/utils/auth'

const authApi = createAuthApi({
  http: authHttp, // 若本地登录走网关，这里应传业务 request
  logoutHttp: authHttp,
  getToken,
})

export function logout() {
  return authApi.logout()
}

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。