原 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 等开关)。
63 lines
2.6 KiB
Rust
63 lines
2.6 KiB
Rust
//! 域名插件本地常量与共享内存键/值编码。
|
||
//!
|
||
//! 这些原属 `ipass-core::config` 的「个性策略常量」与键前缀,在内核收窄时
|
||
//! 已下放插件自持(与 `oauth_keys` 同款处理)。值以 `refs/ipass` 权威实现为准。
|
||
|
||
use ipass_core::state;
|
||
|
||
/// 共享内存键前缀:子域名 → 后端映射
|
||
pub const KEY_SUB_PREFIX: &[u8] = b"sub:";
|
||
|
||
/// 企业域名(业务域名)的 zone:**子域名 + `.` + 此后缀 = 完整对外域名**。
|
||
///
|
||
/// 与 `nginx.conf` 的「企业域名 server」严格耦合:
|
||
/// `server_name ~^(?<subdomain>.+dm)\.mayishangshu\.cn$;`
|
||
pub const ENTERPRISE_ZONE: &str = "mayishangshu.cn";
|
||
|
||
/// 临时域名审批通过后的有效期(秒)。到期仅停止转发,记录保留供查阅。
|
||
pub const TEMP_DOMAIN_TTL: i64 = 6 * 3600;
|
||
|
||
/// 驳回记录保留时长,超期由 purge 清理(秒)
|
||
pub const REJECTED_PURGE_TTL: i64 = 7 * 86400;
|
||
|
||
/// 子域名总长上限:首字符 + 最多 61 个后续字符
|
||
pub const SUBDOMAIN_MAX_LEN: usize = 62;
|
||
|
||
/// 系统保留名:不允许用户申请,避免抢占管理入口
|
||
pub const RESERVED_SUBDOMAINS: [&str; 4] = ["proxy-api", "admin", "www", "api"];
|
||
|
||
/// 自动生成子域名的形状前缀/后缀/位数
|
||
pub const SUBDOMAIN_PREFIX: &str = "i";
|
||
pub const SUBDOMAIN_SUFFIX: &str = "dm";
|
||
/// 随机数字位数。10^8 的空间,撞车概率极低
|
||
pub const SUBDOMAIN_RAND_DIGITS: usize = 8;
|
||
/// 自动生成子域名时的最大重试次数(真撞上已占用的就换一个再试)
|
||
pub const SUBDOMAIN_GEN_ATTEMPTS: usize = 5;
|
||
|
||
// ===========================================================================
|
||
// 转发映射共享内存(写穿):子域名 → 后端
|
||
// ===========================================================================
|
||
//
|
||
// 热路径**永不回源**:未命中即 404,所以每个写操作必须同时更新共享内存与文件
|
||
// (`domains::sync_shm`)。
|
||
|
||
/// 把一条转发映射写进共享内存。`exp == 0` 表示永不过期(long 域名)。
|
||
pub fn put_backend(subdomain: &[u8], backend: &[u8], expires_at: i64) -> bool {
|
||
state::put(KEY_SUB_PREFIX, subdomain, backend, expires_at)
|
||
}
|
||
|
||
/// 读转发映射(带 TTL 判定)。未命中或已过期返回 None。
|
||
pub fn get_backend(subdomain: &[u8], now: i64) -> Option<String> {
|
||
state::get_live(KEY_SUB_PREFIX, subdomain, now)
|
||
}
|
||
|
||
/// 摘掉一条转发映射(审核拒绝 / 删除 / 过期)。
|
||
pub fn invalidate(subdomain: &[u8]) -> bool {
|
||
state::remove(KEY_SUB_PREFIX, subdomain)
|
||
}
|
||
|
||
/// 清空全部转发映射(只清 `sub:` 前缀)。
|
||
pub fn clear_all() {
|
||
state::clear_prefix(KEY_SUB_PREFIX);
|
||
}
|