feat: 登录/注册接入 tianai-captcha 人机行为验证

- 后端: auth/captcha.ts 二次核验(secondary-verify 一次性核销), login/register 前置校验, TAC_ENABLED 开关
- 前端: useCaptcha hook(React 版), AuthModal 验证按钮(通过变绿), verifyToken 随提交携带, 失败/切换自动重置
- nginx: /tac/api/ 同源反代 prod1:18200; public/tac/ 静态资源(load.min.js + sdk)
- 复用 HomeCentral 站点凭证(平台不校验域名, 已从源码确认)
- 本地开发 .env.development 关闭验证; 测试环境 compose 注入 TAC_* 全开
- prod1 DOCKER_USER 链已加 .86 白名单(运行时+持久化)
This commit is contained in:
Sisyphus committed 2026-08-25 16:34:52 +08:00
1 parent ef9b95f85c
commit 7c3d2cfdef
19 files changed
+350 -22

No files matched your search

+79
View File
@@ -0,0 +1,79 @@
/**
* tianai-captcha 人机验证二次核验(对齐 HomeCentral 的 TianaiCaptchaVerificationService)。
*
* 链路:
* 1. 前端滑块校验通过 → 平台 POST /api/challenge/verify 签发 verifyToken
* 2. 登录/注册请求体携带 captchaToken = verifyToken
* 3. 此处调平台 POST /api/challenge/secondary-verify {siteKey, secretKey, verifyToken}
* 一次性核销(重复使用返回 token_invalid)
*
* 环境变量:
* TAC_ENABLED = "true" 启用(默认关闭,本地/单测跳过)
* TAC_API_BASE = 平台地址(默认 http://38.76.218.110:18200)
* TAC_SITE_KEY = 站点 siteKey
* TAC_SECRET_KEY = 站点 secretKey
*
* 平台响应契约(CaptchaPlatformService.secondaryVerify):
* 通过 → HTTP 200 + data.verifyResult = true
* 凭证错 → code 10001 site_auth_fail
* 无效票 → code 403 token_invalid
*/
import { AuthError } from "./service.js";
const TAC_ENABLED = process.env["TAC_ENABLED"] === "true";
const TAC_API_BASE = process.env["TAC_API_BASE"] ?? "http://38.76.218.110:18200";
const TAC_SITE_KEY = process.env["TAC_SITE_KEY"] ?? "";
const TAC_SECRET_KEY = process.env["TAC_SECRET_KEY"] ?? "";
/** 人机验证是否启用。 */
export function captchaEnabled(): boolean {
return TAC_ENABLED;
}
/**
* 校验请求体中的 captchaToken。未启用时直接放行;
* 启用后缺失/无效/平台不可用一律抛 AuthError(由路由统一转响应)。
*/
export async function requireCaptcha(body: unknown): Promise<void> {
if (!TAC_ENABLED) return;
const b = (body ?? {}) as { captchaToken?: unknown };
const token = typeof b.captchaToken === "string" ? b.captchaToken.trim() : "";
if (token === "") {
throw new AuthError("请先完成人机验证", 401, "CAPTCHA_MISSING");
}
if (TAC_SITE_KEY === "" || TAC_SECRET_KEY === "") {
console.error("[captcha] TAC_ENABLED=true 但未配置 TAC_SITE_KEY/TAC_SECRET_KEY");
throw new AuthError("人机验证服务未配置,请稍后重试", 503, "CAPTCHA_MISCONFIGURED");
}
let res: Response;
try {
res = await fetch(`${TAC_API_BASE}/api/challenge/secondary-verify`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
siteKey: TAC_SITE_KEY,
secretKey: TAC_SECRET_KEY,
verifyToken: token,
}),
signal: AbortSignal.timeout(5000),
});
} catch (err) {
console.error("[captcha] secondary-verify 请求失败:", err);
throw new AuthError("人机验证服务暂不可用,请稍后重试", 503, "CAPTCHA_UNAVAILABLE");
}
if (!res.ok) {
throw new AuthError("人机验证失败,请重新验证", 401, "CAPTCHA_INVALID");
}
const data = (await res.json().catch(() => null)) as {
data?: { verifyResult?: unknown };
} | null;
if (data?.data?.verifyResult !== true) {
throw new AuthError("人机验证失败,请重新验证", 401, "CAPTCHA_INVALID");
}
}
+3
View File
@@ -11,6 +11,7 @@ import type { Request, Response } from "express";
import type { Db } from "../db/index.js";
import { getDb } from "../db/index.js";
import { AuthError, AUTH_ERRORS, findUserById, loginUser, registerUser } from "./service.js";
import { requireCaptcha } from "./captcha.js";
import { signToken } from "./jwt.js";
import { requireAuth } from "./middleware.js";
import { createRateLimiter } from "../security/rate-limit.js";
@@ -49,6 +50,7 @@ export function createAuthRouter(injectedDb?: Db): Router {
/** POST /api/auth/register */
router.post("/register", registerLimiter, async (req: Request, res: Response): Promise<void> => {
try {
await requireCaptcha(req.body);
const { phone, password } = parseCredentials(req.body);
const b = (req.body ?? {}) as { nickname?: unknown };
const nickname =
@@ -70,6 +72,7 @@ export function createAuthRouter(injectedDb?: Db): Router {
/** POST /api/auth/login */
router.post("/login", loginLimiter, async (req: Request, res: Response): Promise<void> => {
try {
await requireCaptcha(req.body);
const { phone, password } = parseCredentials(req.body);
const db = resolveDb(injectedDb);
const user = await loginUser(db, phone, password);