//! SVG 图形验证码(对齐 MaxKey kaptcha 的登录防自动化能力,实现为纯 SVG, //! 零依赖:不引入图像库,浏览器直接内联渲染)。 //! //! ## 生命周期 //! //! 1. `GET /api/captcha` → 生成 `id + 5 位码`,码存共享内存 `cap:`(TTL 5 分钟); //! 2. 登录请求附带 `captcha_id` + `captcha_code`; //! 3. 校验**一次性**:无论对错,取出即删(对齐 MaxKey 的一次性票据语义), //! 失败需重新取新码。 //! //! ## 开关 //! //! 缺省**关闭**(`OAUTH_CAPTCHA=1` 开启)。验证码图形无法被 curl e2e 读取, //! 缺省开启会让所有存量端到端失效;生产开启后浏览器路径正常出码。 //! //! ## 防 OCR 的边界 //! //! 纯字符 + 干扰线能挡住低成本的自动重放/批量尝试,挡不住定向 OCR—— //! 真正的爆破防线是账号锁定(users::record_login_failure),验证码只是减速带。 use serde_json::{Value, json}; use ipass_core::state; use ipass_core::util; /// 验证码共享内存 TTL(秒)——与模块文档一致:5 分钟(300s)。 /// /// 原属 `ipass_core::config`,收窄内核后归本插件自管。 pub const CAPTCHA_TTL: i64 = 5 * 60; /// 验证码开关环境变量名:取值 `1/true/on/yes` 开启(`api.rs` 登录校验读取)。 /// /// 原属 `ipass_core::config`,收窄内核后归本插件自管。 pub const OAUTH_CAPTCHA_ENV: &str = "OAUTH_CAPTCHA"; /// 键前缀:验证码 id → 码(一次性) const KEY_CAPTCHA_PREFIX: &[u8] = b"cap:"; /// 无歧义字符集:去掉 0/O/1/I/l,降低人眼误识率 const CHARS: &[u8] = b"abcdefghjkmnpqrstuvwxyz23456789"; /// 码长 const CODE_LEN: usize = 5; /// 是否启用(环境变量在启动时读取,进程内固定) pub fn enabled() -> bool { match std::env::var(OAUTH_CAPTCHA_ENV) { Ok(v) => matches!(v.to_ascii_lowercase().as_str(), "1" | "true" | "on" | "yes"), Err(_) => false, } } /// 生成新验证码:返回 `(id, svg)`。码只进共享内存,不进响应体。 pub fn create() -> Option<(String, String)> { let now = util::now(); let mut code = String::with_capacity(CODE_LEN); for _ in 0..CODE_LEN { let b = [util::rand_hex(1).as_bytes()[0]]; code.push(CHARS[(b[0] as usize) % CHARS.len()] as char); } let id = util::rand_hex(16); if !state::put(KEY_CAPTCHA_PREFIX, id.as_bytes(), code.as_bytes(), now + CAPTCHA_TTL) { return None; } Some((id, render(&code))) } /// 校验并消费:码对返回 true,码错/过期/id 未知一律 false。 /// **无论结果如何,码都会被删除**(一次性语义,防同码重试)。 pub fn verify(id: &str, answer: &str) -> bool { if id.is_empty() || answer.is_empty() { return false; } let expected = state::get(KEY_CAPTCHA_PREFIX, id.as_bytes()).map(|(p, _)| p); state::remove(KEY_CAPTCHA_PREFIX, id.as_bytes()); let Some(expected) = expected else { return false; }; // 大小写不敏感:用户输入习惯优先于严格匹配 util::ct_eq(&expected.to_ascii_lowercase(), &answer.trim().to_ascii_lowercase()) } /// 渲染 SVG:每个字符独立旋转/抖动 + 两条干扰弧线 + 噪点。 /// 宽 160 高 48,颜色固定深蓝系,与管理台视觉一致。 fn render(code: &str) -> String { let (w, h) = (160.0f32, 48.0f32); let mut body = String::new(); // 干扰弧线两条 for (i, (x1, y1, x2, y2, cx, cy)) in [ (0.0, 36.0, 160.0, 12.0, 60.0, 60.0), (0.0, 10.0, 160.0, 40.0, 100.0, -10.0), ] .into_iter() .enumerate() { body.push_str(&format!( "", 1 + (i % 2) )); } // 噪点 for i in 0..24 { let x = (util::sha256_hex(format!("n{i}{code}").as_bytes())[..4] .chars() .fold(0usize, |a, c| a * 16 + c.to_digit(16).unwrap_or(0) as usize) % (w as usize)) as f32; let y = (util::sha256_hex(format!("m{i}{code}").as_bytes())[..4] .chars() .fold(0usize, |a, c| a * 16 + c.to_digit(16).unwrap_or(0) as usize) % (h as usize)) as f32; body.push_str(&format!("")); } // 字符:等距 + 伪随机旋转/垂直偏移 let step = (w - 24.0) / CODE_LEN as f32; for (i, c) in code.chars().enumerate() { let rot_seed = util::sha256_hex(format!("r{i}{c}").as_bytes()); let rot = ((rot_seed.as_bytes()[0] % 50) as f32 - 25.0) as i32; // ±25° let dy = ((rot_seed.as_bytes()[1] % 10) as f32 - 5.0) as i32; // ±5px let x = 12.0 + step * i as f32 + step / 2.0; body.push_str(&format!( "{c}", 34 + dy )); } format!( "{body}" ) } /// 管理台 / 登录页取码接口的响应体。 pub fn response() -> Option { create().map(|(id, svg)| json!({ "id": id, "svg": svg, "ttl": CAPTCHA_TTL })) }