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:
1 parent
ef9b95f85c
commit
7c3d2cfdef
19 files changed
+350
-22
No files matched your search
@@ -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");
|
||||
}
|
||||
}
|
||||
@@ -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);
|
||||
|
||||
Reference in new issue
Block a user