Files
sso/source/rust/crates/plugin-domain/src/keys.rs
T
ssw a988cc3763 refactor: 网关拆分为 ipass-core 内核 + plugin-sso/plugin-domain 插件 + gateway
原 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 等开关)。
2026-09-13 10:23:34 +08:00

63 lines
2.6 KiB
Rust
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
//! 域名插件本地常量与共享内存键/值编码。
//!
//! 这些原属 `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);
}