//! 自助密码重置(对齐 MaxKey 密码找回)。 //! //! 两个公开端点,无需登录: //! //! * `POST /api/public/forgot-password` —— 凭账号名 / 邮箱申请重置,签发一次性 //! token(存共享内存,不落 `users.json`,避免出现在管理台视图里),并「发信」。 //! * `POST /api/public/reset-password` —— 凭 token + 新口令完成重置。 //! * `GET /forgot` / `GET /reset?token=…` —— 上面两个 API 的**终端用户页面** //! (没有页面时,发给用户的邮件链接会指向 POST 端点,点开必然失败)。 //! //! token 用共享内存 `pwdrst: → username` 存储,带 TTL,单次有效(用后即删)。 //! 「发信」是可配置抽象:默认只写日志;设 `PASSWORD_RESET_TOKEN_SINK` 把 token //! 落到本地文件(本地联调 / e2e 取用);生产可接 SMTP / webhook(见 sender 分支)。 use ngx::ffi::ngx_http_request_t; use crate::compat as http; use ipass_core::state; use ipass_core::users; use ipass_core::util; use ngx::core::Status; use ngx::http::HTTPStatus; use crate::accounts::{self, UserExt}; use crate::audit; use crate::oauth; use crate::utilx; /// 重置 token 共享内存前缀:`pwdrst: → username` const KEY_PWD_RESET: &[u8] = b"pwdrst:"; /// 默认 token 有效期(秒) const RESET_TTL_DEFAULT: i64 = 1800; /// 路由 pub fn route(method: &str, uri: &str) -> Option<(crate::api::Guard, crate::api::Handler)> { let g = crate::api::Guard::Public; match (method, uri) { ("POST", "/api/public/forgot-password") => Some((g, h_forgot_password)), ("POST", "/api/public/reset-password") => Some((g, h_reset_password)), // 终端用户页面(GET)。放在这里而不是主路由表:同属「密码重置」这一族。 ("GET", "/forgot") => Some((g, h_forgot_page)), ("GET", "/reset") => Some((g, h_reset_page)), _ => None, } } /// token 有效期:可由 `PASSWORD_RESET_TTL` 覆盖(秒)。 fn reset_ttl() -> i64 { match std::env::var("PASSWORD_RESET_TTL") { Ok(v) => v.trim().parse::().unwrap_or(RESET_TTL_DEFAULT).max(60), Err(_) => RESET_TTL_DEFAULT, } } /// 把重置信息「发出去」:配置化抽象(默认日志;SINK 文件;生产可扩展 SMTP/webhook)。 fn send_reset(user: &str, token: &str) { let base = oauth::issuer(); // 注意:必须指向 **GET 页面**,不能直接指向 POST 端点(点开会是 405/空响应)。 let link = format!("{base}/reset?token={token}"); util::log_notice(&format!("[reset] 密码重置链接 user={user} {link}")); if let Ok(sink) = std::env::var("PASSWORD_RESET_TOKEN_SINK") { // 本地联调 / e2e:把 token 落到文件,便于脚本取出(不含 PII,仅 token) let _ = std::fs::write(&sink, format!("{token}\n")); } } /// `POST /api/public/forgot-password`:账号名或邮箱。 /// /// 安全:无论账号是否存在都返回同样的成功文案,避免账号枚举。 fn h_forgot_password(r: *mut ngx_http_request_t, _actor: crate::api::Actor) -> Status { let p = http::params(r); let ident = p .get("username") .or_else(|| p.get("email")) .map(String::as_str) .unwrap_or("") .to_owned(); let ip = http::remote_addr(r); let ua = http::header(r, "user-agent").unwrap_or_default(); if ident.is_empty() { return http::fail(r, HTTPStatus::BAD_REQUEST, "请提供账号名或邮箱"); } // 按账号名或邮箱定位用户 let found = users::get(&ident).or_else(|| { let lower = ident.to_ascii_lowercase(); users::all().into_iter().find(|u| u.email().to_ascii_lowercase() == lower) }); if let Some(u) = found { let token = util::gen_key(); let exp = util::now() + reset_ttl(); state::put(KEY_PWD_RESET, token.as_bytes(), u.username.as_bytes(), exp); send_reset(&u.username, &token); audit::log("pwd.forgot", &u.username, &u.username, true, &ip, &ua, ""); } else { audit::log("pwd.forgot", &ident, &ident, false, &ip, &ua, "no such account"); } http::ok(r, serde_json::json!({}), "若账号存在,重置链接已发送") } /// `POST /api/public/reset-password`:token + 新口令。 fn h_reset_password(r: *mut ngx_http_request_t, _actor: crate::api::Actor) -> Status { let p = http::params(r); let token = p.get("token").map(String::as_str).unwrap_or("").to_owned(); let password = p.get("password").map(String::as_str).unwrap_or("").to_owned(); let ip = http::remote_addr(r); let ua = http::header(r, "user-agent").unwrap_or_default(); if token.is_empty() || password.is_empty() { return http::fail(r, HTTPStatus::BAD_REQUEST, "token 与新口令均必填"); } if let Err(e) = accounts::check_password(&password) { return http::fail(r, HTTPStatus::BAD_REQUEST, &e); } let Some((username, exp)) = state::get(KEY_PWD_RESET, token.as_bytes()) else { return http::fail(r, HTTPStatus::BAD_REQUEST, "token 无效或已使用"); }; if exp > 0 && exp <= util::now() { state::remove(KEY_PWD_RESET, token.as_bytes()); return http::fail(r, HTTPStatus::BAD_REQUEST, "token 已过期,请重新申请"); } match users::set_password(&username, &password) { Ok(()) => { // 单次有效:消费即删 state::remove(KEY_PWD_RESET, token.as_bytes()); audit::log("pwd.reset", &username, &username, true, &ip, &ua, ""); http::ok(r, serde_json::json!({}), "密码已重置,请用新口令登录") } Err(e) => http::fail(r, HTTPStatus::BAD_REQUEST, &e), } } // =========================================================================== // 终端用户页面(自助密码重置的「另一半」) // =========================================================================== // // 只有 API 没有页面时,用户拿到的邮件链接会指向一个 POST 端点——点开必然 // 405/400。所以这里补两个 GET 页面: // GET /forgot 输入账号名/邮箱,申请重置 // GET /reset?token=… 凭一次性 token 设置新口令 // 页面用 fetch 提交,不依赖跨请求表单 POST(token 也就不会出现在地址栏历史里 // 之外的任何地方)。 /// 两个页面共用的样式:与登录页同一套配色(深蓝渐变底 + 白卡片 + 蓝色主按钮)。 const PAGE_STYLE: &str = r#" *{box-sizing:border-box} body{margin:0;min-height:100vh;display:flex;align-items:center;justify-content:center;padding:24px; font-family:-apple-system,BlinkMacSystemFont,"Segoe UI","PingFang SC","Microsoft YaHei",sans-serif; background:radial-gradient(1100px 560px at 50% -12%,#1e3a8a 0%,#0f172a 58%,#0b1220 100%);color:#1f2937} .card{width:100%;max-width:400px;background:#fff;border-radius:16px;padding:34px 30px 24px; box-shadow:0 20px 60px rgba(2,6,23,.45)} .brand{display:flex;align-items:center;gap:11px;margin-bottom:20px} .mark{width:34px;height:34px;border-radius:10px;background:linear-gradient(135deg,#2563eb,#38bdf8); display:flex;align-items:center;justify-content:center;color:#fff;font-weight:700; font-size:12px;letter-spacing:.5px;flex:0 0 auto} h1{font-size:16px;margin:0} .sub{color:#6b7280;font-size:12px;margin-top:2px} label{display:block;font-size:12.5px;color:#6b7280;margin:0 0 6px} input[type=text],input[type=password]{width:100%;padding:10px 12px;margin:0 0 14px; border:1px solid #cbd5e1;border-radius:8px;font-size:13.5px;outline:none; transition:border-color .15s,box-shadow .15s} input[type=text]:focus,input[type=password]:focus{border-color:#2563eb; box-shadow:0 0 0 3px rgba(37,99,235,.12)} button{width:100%;padding:11px;border:0;border-radius:8px;background:#2563eb;color:#fff; font-size:15px;font-weight:600;cursor:pointer;transition:.15s;font-family:inherit} button:hover{background:#1d4ed8} button:disabled{opacity:.6;cursor:not-allowed} .msg{border-radius:8px;padding:9px 12px;font-size:12.5px;margin-bottom:16px;display:none} .msg.ok{background:#e7f6ec;color:#15803d;border:1px solid #bfe3cb;display:block} .msg.err{background:#fdecec;color:#b91c1c;border:1px solid #f7cfcf;display:block} .foot{margin-top:16px;padding-top:14px;border-top:1px dashed #e3e8ef; color:#6b7280;font-size:12px;text-align:center} .foot a{color:#2563eb;text-decoration:none} "#; /// 找回密码页。用占位符替换而不是 `format!`:页面里有大量 JS 花括号, /// 走 `format!` 得把每一个都写成 `{{`/`}}`,改起来极易出错。 const FORGOT_PAGE: &str = r#" 找回密码 · 统一认证
SSO

找回密码

输入账号名或邮箱,系统会发送一次性重置链接
"#; /// 重置口令页。`__TOKEN__` 为一次性 token(HTML 转义后填入隐藏域)。 const RESET_PAGE: &str = r#" 重置密码 · 统一认证
SSO

设置新密码

凭重置链接设置新口令,该链接仅可使用一次
__MSG__
"#; fn forgot_html() -> String { FORGOT_PAGE.replace("__STYLE__", PAGE_STYLE) } fn reset_html(token: &str, error: &str) -> String { let empty = token.trim().is_empty(); let (cls, hidden) = if empty { ("err", "hidden") } else { ("", "") }; let msg = if empty { "链接不完整或已失效,请重新申请" } else { error }; RESET_PAGE .replace("__STYLE__", PAGE_STYLE) .replace("__TOKEN__", &utilx::html_escape(token)) .replace("__MSG_CLS__", cls) .replace("__MSG__", &utilx::html_escape(msg)) .replace("__FORM_HIDDEN__", hidden) } /// `GET /forgot` —— 找回密码页(登录页有「忘记密码?」链接指过来)。 fn h_forgot_page(r: *mut ngx_http_request_t, _actor: crate::api::Actor) -> Status { http::send_ct(r, HTTPStatus::OK, &forgot_html(), "text/html; charset=utf-8") } /// `GET /reset?token=…` —— 凭一次性 token 设置新口令页。 /// /// token 为空时直接在页面上给出提示(不发往服务端),其余情况即使 token 无效 /// 也照常渲染表单——真正的校验在 POST 时做,避免把「token 是否存在」暴露成页面差异。 fn h_reset_page(r: *mut ngx_http_request_t, _actor: crate::api::Actor) -> Status { let p = http::params(r); let token = p.get("token").map(String::as_str).unwrap_or("").to_owned(); http::send_ct(r, HTTPStatus::OK, &reset_html(&token, ""), "text/html; charset=utf-8") }