原 source/rust/src/ 单体 crate 拆为 Cargo workspace:
crates/ipass-core/ 内核:state(共享内存) / store(JSON 原子写) /
users(账号唯一写入口) / models(共性字段 + extra 透传) /
config(共性常量) / plugin(装配契约) / loc(开关) /
session / audit / http / util
crates/plugin-sso/ 身份插件:OAuth2 / OIDC / IAP / TOTP / RSA 等个性代码
crates/plugin-domain/ 域名插件:企业域名「子域名 → 后端」转发 + 申请/审核
gateway/ **唯一** cdylib,module 壳 + PLUGINS 装配数组
收窄原则:内核只留共性,个性代码下放插件。收窄后内核不再提供原单体的
bump_window / put_ukey / put_upstream / reload_shm 等,改由插件用 state 泛型
原语自行重建;OAuth 常量与前缀(如 OAUTH_SESSION_COOKIE=sso_sid、
IAP_TOKEN_AUDIENCE=sso-gateway)与历史取值严格一致。
插件一律 crate-type=["rlib"] 由 gateway 静态链入,产出单个
libsso_gateway.dylib —— 不各自出 .so(nginx 动态模块无稳定 ABI,
跨 .so 传 String 即双重 free)。
插件装配点集中在 gateway 5 处:use / PLUGINS 数组 / ModuleConfig 字段 /
Merge / loc_switch 分支,外加指令数组(长度 +1,新增 sso_domain 等开关)。
60 lines
2.0 KiB
Rust
60 lines
2.0 KiB
Rust
//! 管理员登录会话。
|
||
//!
|
||
//! 会话存在共享内存里:**nginx 重启即全部失效**,这是预期行为。
|
||
//!
|
||
//! Cookie 为 `sso_admin_session=<64 位 hex>`,HttpOnly + SameSite=Strict,
|
||
//! 每次校验命中都会滑动续期。
|
||
//!
|
||
//! 与 SSO 终端用户会话(`oauth` 模块的 `sso_sid`)**刻意分开**:管理台身份
|
||
//! 与业务系统身份是两条信任线,共用一套会让「能登录业务系统」等价于「能改配置」。
|
||
|
||
use crate::config::{COOKIE_NAME, SESSION_TTL};
|
||
use crate::state;
|
||
use crate::util;
|
||
|
||
/// 从 Cookie 头里取出会话 token
|
||
pub fn parse_token(cookie_header: &str) -> Option<String> {
|
||
let needle = format!("{COOKIE_NAME}=");
|
||
for part in cookie_header.split(';') {
|
||
let part = part.trim();
|
||
if let Some(value) = part.strip_prefix(&needle) {
|
||
if !value.is_empty() {
|
||
return Some(value.to_owned());
|
||
}
|
||
}
|
||
}
|
||
None
|
||
}
|
||
|
||
/// 新建会话,返回 token
|
||
pub fn create(username: &str) -> String {
|
||
let token = util::rand_hex(32);
|
||
state::put_session(&token, username, util::now() + SESSION_TTL);
|
||
token
|
||
}
|
||
|
||
pub fn set_cookie(token: &str) -> String {
|
||
format!("{COOKIE_NAME}={token}; Path=/; HttpOnly; SameSite=Strict; Max-Age={SESSION_TTL}")
|
||
}
|
||
|
||
pub fn clear_cookie() -> String {
|
||
format!("{COOKIE_NAME}=deleted; Path=/; HttpOnly; SameSite=Strict; Max-Age=0")
|
||
}
|
||
|
||
/// 鉴权:解析 Cookie → 查共享内存 → 命中则滑动续期。返回当前登录用户名。
|
||
pub fn authenticate(cookie: Option<&str>) -> Option<String> {
|
||
let token = parse_token(cookie?)?;
|
||
let now = util::now();
|
||
let username = state::get_session(&token, now)?;
|
||
// 滑动续期:活跃使用不因固定 TTL 被踢出
|
||
state::put_session(&token, &username, now + SESSION_TTL);
|
||
Some(username)
|
||
}
|
||
|
||
/// 退出登录:销毁服务端会话(Cookie 由响应头清除)
|
||
pub fn destroy(cookie: Option<&str>) {
|
||
if let Some(token) = cookie.and_then(parse_token) {
|
||
state::remove_session(&token);
|
||
}
|
||
}
|