定位:身份层(IdP + IAP),不含动态域名转发 / LLM 上游代理 / 用量计费。 代码(source/rust,nginx 动态模块 + Rust,单进程零外部依赖) - IdP:authorization_code(含 PKCE)/ refresh_token / client_credentials / password 四种 grant,含 discovery / introspect / userinfo / jwks 占位 - IAP:access 阶段门禁,注入 X-Auth-* 到后端,客户端伪造同名头被覆盖 - MaxKey 互通:/oauth/v20/* 与 /oauth2.0/* 别名 + context-path 归一化 + 扁平字段 - 管理接口:账号(含角色/部门/用户组)与 OAuth 接入方注册表,热写穿共享内存 - 模块改名 ngx_http_sso_module,指令 sso_state / sso_data_dir / sso_api / sso_iap, Cookie sso_sid(终端用户)与 sso_admin_session(管理员)两套身份两套会话 配置(source/conf) - nginx.conf 生产模板(TLS、IAP 子域、含 auth_sub 的日志格式) - nginx.test.conf 本机验证配置(明文 18095-18099) - tls/README.md 证书约定与公钥比对校验 前端(source/www/admin.html) - 三 tab:账号管理 / 接入方 / 接入指南;去掉审核队列、域名、LLM 上游、用量统计 测试与脚本 - tests/ 三套端到端:协议基线 14 项 · MaxKey 互通与接入 24 项 · 管理接口 31 项,全绿 - tests/demo-system 演示业务系统(Python 标准库),覆盖应用自建客户端与 IAP 零改造两种姿势 - scripts/run-local-e2e.sh 本机一键起停;scripts/seed-data.sh 物化运行时数据目录 文档 - README.md 概览与快速开始;CLAUDE.md 硬约定与排障速查 - docs/design.md 完整设计;docs/roadmap.md 待执行任务(v2 RS256+JWKS、用户管理界面)
325 lines
11 KiB
Rust
325 lines
11 KiB
Rust
use core::ffi::{c_char, c_void};
|
|
use core::ptr;
|
|
|
|
use http::HeaderMap;
|
|
use ngx::core::Status;
|
|
use ngx::ffi::{
|
|
NGX_CONF_TAKE1, NGX_HTTP_LOC_CONF, NGX_HTTP_LOC_CONF_OFFSET, NGX_HTTP_MODULE,
|
|
NGX_HTTP_SRV_CONF, NGX_LOG_EMERG, ngx_command_t, ngx_conf_t, ngx_http_module_t, ngx_int_t,
|
|
ngx_module_t, ngx_str_t, ngx_uint_t,
|
|
};
|
|
use ngx::http::*;
|
|
use ngx::{ngx_conf_log_error, ngx_log_debug_http, ngx_string};
|
|
|
|
struct Module;
|
|
|
|
impl HttpModule for Module {
|
|
fn module() -> &'static ngx_module_t {
|
|
unsafe { &*::core::ptr::addr_of!(ngx_http_awssigv4_module) }
|
|
}
|
|
|
|
unsafe extern "C" fn postconfiguration(cf: *mut ngx_conf_t) -> ngx_int_t {
|
|
// SAFETY: this function is called with non-NULL cf always
|
|
let cf = unsafe { &mut *cf };
|
|
ngx::http::add_phase_handler::<AwsSigV4HeaderHandler>(cf)
|
|
.map_or(Status::NGX_ERROR, |_| Status::NGX_OK)
|
|
.into()
|
|
}
|
|
}
|
|
|
|
#[derive(Debug, Default)]
|
|
struct ModuleConfig {
|
|
enable: bool,
|
|
access_key: String,
|
|
secret_key: String,
|
|
s3_bucket: String,
|
|
s3_endpoint: String,
|
|
}
|
|
|
|
unsafe impl HttpModuleLocationConf for Module {
|
|
type LocationConf = ModuleConfig;
|
|
}
|
|
|
|
static mut NGX_HTTP_AWSSIGV4_COMMANDS: [ngx_command_t; 6] = [
|
|
ngx_command_t {
|
|
name: ngx_string!("awssigv4"),
|
|
type_: (NGX_HTTP_LOC_CONF | NGX_HTTP_SRV_CONF | NGX_CONF_TAKE1) as ngx_uint_t,
|
|
set: Some(ngx_http_awssigv4_commands_set_enable),
|
|
conf: NGX_HTTP_LOC_CONF_OFFSET,
|
|
offset: 0,
|
|
post: ptr::null_mut(),
|
|
},
|
|
ngx_command_t {
|
|
name: ngx_string!("awssigv4_access_key"),
|
|
type_: (NGX_HTTP_LOC_CONF | NGX_HTTP_SRV_CONF | NGX_CONF_TAKE1) as ngx_uint_t,
|
|
set: Some(ngx_http_awssigv4_commands_set_access_key),
|
|
conf: NGX_HTTP_LOC_CONF_OFFSET,
|
|
offset: 0,
|
|
post: ptr::null_mut(),
|
|
},
|
|
ngx_command_t {
|
|
name: ngx_string!("awssigv4_secret_key"),
|
|
type_: (NGX_HTTP_LOC_CONF | NGX_HTTP_SRV_CONF | NGX_CONF_TAKE1) as ngx_uint_t,
|
|
set: Some(ngx_http_awssigv4_commands_set_secret_key),
|
|
conf: NGX_HTTP_LOC_CONF_OFFSET,
|
|
offset: 0,
|
|
post: ptr::null_mut(),
|
|
},
|
|
ngx_command_t {
|
|
name: ngx_string!("awssigv4_s3_bucket"),
|
|
type_: (NGX_HTTP_LOC_CONF | NGX_HTTP_SRV_CONF | NGX_CONF_TAKE1) as ngx_uint_t,
|
|
set: Some(ngx_http_awssigv4_commands_set_s3_bucket),
|
|
conf: NGX_HTTP_LOC_CONF_OFFSET,
|
|
offset: 0,
|
|
post: ptr::null_mut(),
|
|
},
|
|
ngx_command_t {
|
|
name: ngx_string!("awssigv4_s3_endpoint"),
|
|
type_: (NGX_HTTP_LOC_CONF | NGX_HTTP_SRV_CONF | NGX_CONF_TAKE1) as ngx_uint_t,
|
|
set: Some(ngx_http_awssigv4_commands_set_s3_endpoint),
|
|
conf: NGX_HTTP_LOC_CONF_OFFSET,
|
|
offset: 0,
|
|
post: ptr::null_mut(),
|
|
},
|
|
ngx_command_t::empty(),
|
|
];
|
|
|
|
static NGX_HTTP_AWSSIGV4_MODULE_CTX: ngx_http_module_t = ngx_http_module_t {
|
|
preconfiguration: Some(Module::preconfiguration),
|
|
postconfiguration: Some(Module::postconfiguration),
|
|
create_main_conf: None,
|
|
init_main_conf: None,
|
|
create_srv_conf: None,
|
|
merge_srv_conf: None,
|
|
create_loc_conf: Some(Module::create_loc_conf),
|
|
merge_loc_conf: Some(Module::merge_loc_conf),
|
|
};
|
|
|
|
// Generate the `ngx_modules` table with exported modules.
|
|
// This feature is required to build a 'cdylib' dynamic module outside of the NGINX buildsystem.
|
|
#[cfg(feature = "export-modules")]
|
|
ngx::ngx_modules!(ngx_http_awssigv4_module);
|
|
|
|
#[used]
|
|
#[allow(non_upper_case_globals)]
|
|
#[cfg_attr(not(feature = "export-modules"), unsafe(no_mangle))]
|
|
pub static mut ngx_http_awssigv4_module: ngx_module_t = ngx_module_t {
|
|
ctx: &raw const NGX_HTTP_AWSSIGV4_MODULE_CTX as _,
|
|
commands: unsafe { &raw mut NGX_HTTP_AWSSIGV4_COMMANDS[0] },
|
|
type_: NGX_HTTP_MODULE as _,
|
|
..ngx_module_t::default()
|
|
};
|
|
|
|
impl Merge for ModuleConfig {
|
|
fn merge(&mut self, prev: &ModuleConfig) -> Result<(), MergeConfigError> {
|
|
if prev.enable {
|
|
self.enable = true;
|
|
};
|
|
|
|
if self.access_key.is_empty() {
|
|
self.access_key =
|
|
String::from(if !prev.access_key.is_empty() { &prev.access_key } else { "" });
|
|
}
|
|
if self.enable && self.access_key.is_empty() {
|
|
return Err(MergeConfigError::NoValue);
|
|
}
|
|
|
|
if self.secret_key.is_empty() {
|
|
self.secret_key =
|
|
String::from(if !prev.secret_key.is_empty() { &prev.secret_key } else { "" });
|
|
}
|
|
if self.enable && self.secret_key.is_empty() {
|
|
return Err(MergeConfigError::NoValue);
|
|
}
|
|
|
|
if self.s3_bucket.is_empty() {
|
|
self.s3_bucket =
|
|
String::from(if !prev.s3_bucket.is_empty() { &prev.s3_bucket } else { "" });
|
|
}
|
|
if self.enable && self.s3_bucket.is_empty() {
|
|
return Err(MergeConfigError::NoValue);
|
|
}
|
|
|
|
if self.s3_endpoint.is_empty() {
|
|
self.s3_endpoint = String::from(if !prev.s3_endpoint.is_empty() {
|
|
&prev.s3_endpoint
|
|
} else {
|
|
"s3.amazonaws.com"
|
|
});
|
|
}
|
|
Ok(())
|
|
}
|
|
}
|
|
|
|
extern "C" fn ngx_http_awssigv4_commands_set_enable(
|
|
cf: *mut ngx_conf_t,
|
|
_cmd: *mut ngx_command_t,
|
|
conf: *mut c_void,
|
|
) -> *mut c_char {
|
|
unsafe {
|
|
let conf = &mut *(conf as *mut ModuleConfig);
|
|
let args: &[ngx_str_t] = (*(*cf).args).as_slice();
|
|
let val = match args[1].to_str() {
|
|
Ok(s) => s,
|
|
Err(_) => {
|
|
ngx_conf_log_error!(NGX_LOG_EMERG, cf, "`awssigv4` argument is not utf-8 encoded");
|
|
return ngx::core::NGX_CONF_ERROR;
|
|
}
|
|
};
|
|
|
|
// set default value optionally
|
|
conf.enable = false;
|
|
|
|
if val.len() == 2 && val.eq_ignore_ascii_case("on") {
|
|
conf.enable = true;
|
|
} else if val.len() == 3 && val.eq_ignore_ascii_case("off") {
|
|
conf.enable = false;
|
|
}
|
|
};
|
|
|
|
ngx::core::NGX_CONF_OK
|
|
}
|
|
|
|
extern "C" fn ngx_http_awssigv4_commands_set_access_key(
|
|
cf: *mut ngx_conf_t,
|
|
_cmd: *mut ngx_command_t,
|
|
conf: *mut c_void,
|
|
) -> *mut c_char {
|
|
unsafe {
|
|
let conf = &mut *(conf as *mut ModuleConfig);
|
|
let args: &[ngx_str_t] = (*(*cf).args).as_slice();
|
|
conf.access_key = args[1].to_string();
|
|
};
|
|
|
|
ngx::core::NGX_CONF_OK
|
|
}
|
|
|
|
extern "C" fn ngx_http_awssigv4_commands_set_secret_key(
|
|
cf: *mut ngx_conf_t,
|
|
_cmd: *mut ngx_command_t,
|
|
conf: *mut c_void,
|
|
) -> *mut c_char {
|
|
unsafe {
|
|
let conf = &mut *(conf as *mut ModuleConfig);
|
|
let args: &[ngx_str_t] = (*(*cf).args).as_slice();
|
|
conf.secret_key = args[1].to_string();
|
|
};
|
|
|
|
ngx::core::NGX_CONF_OK
|
|
}
|
|
|
|
extern "C" fn ngx_http_awssigv4_commands_set_s3_bucket(
|
|
cf: *mut ngx_conf_t,
|
|
_cmd: *mut ngx_command_t,
|
|
conf: *mut c_void,
|
|
) -> *mut c_char {
|
|
unsafe {
|
|
let conf = &mut *(conf as *mut ModuleConfig);
|
|
let args: &[ngx_str_t] = (*(*cf).args).as_slice();
|
|
conf.s3_bucket = args[1].to_string();
|
|
if conf.s3_bucket.len() == 1 {
|
|
println!("Validation failed");
|
|
return ngx::core::NGX_CONF_ERROR;
|
|
}
|
|
};
|
|
|
|
ngx::core::NGX_CONF_OK
|
|
}
|
|
|
|
extern "C" fn ngx_http_awssigv4_commands_set_s3_endpoint(
|
|
cf: *mut ngx_conf_t,
|
|
_cmd: *mut ngx_command_t,
|
|
conf: *mut c_void,
|
|
) -> *mut c_char {
|
|
unsafe {
|
|
let conf = &mut *(conf as *mut ModuleConfig);
|
|
let args = (*(*cf).args).elts as *mut ngx_str_t;
|
|
conf.s3_endpoint = (*args.add(1)).to_string();
|
|
};
|
|
|
|
ngx::core::NGX_CONF_OK
|
|
}
|
|
|
|
struct AwsSigV4HeaderHandler;
|
|
|
|
impl HttpRequestHandler for AwsSigV4HeaderHandler {
|
|
const PHASE: HttpPhase = HttpPhase::PreContent;
|
|
type Output = Status;
|
|
|
|
fn handler(request: &mut Request) -> Self::Output {
|
|
// get Module Config from request
|
|
let conf = Module::location_conf(request).expect("module conf");
|
|
ngx_log_debug_http!(request, "AWS signature V4 module {}", {
|
|
if conf.enable { "enabled" } else { "disabled" }
|
|
});
|
|
if !conf.enable {
|
|
return Status::NGX_DECLINED;
|
|
}
|
|
|
|
// TODO: build url properly from the original URL from client
|
|
let method = request.method();
|
|
if !matches!(method, ngx::http::Method::HEAD | ngx::http::Method::GET) {
|
|
return HTTPStatus::FORBIDDEN.into();
|
|
}
|
|
|
|
let datetime = chrono::Utc::now();
|
|
let uri = match request.unparsed_uri().to_str() {
|
|
Ok(v) => format!("https://{}.{}{}", conf.s3_bucket, conf.s3_endpoint, v),
|
|
Err(_) => return Status::NGX_DECLINED,
|
|
};
|
|
|
|
let datetime_now = datetime.format("%Y%m%dT%H%M%SZ");
|
|
let datetime_now = datetime_now.to_string();
|
|
|
|
let signature = {
|
|
// NOTE: aws_sign_v4::AwsSign::new() implementation requires a HeaderMap.
|
|
// Iterate over requests headers_in and copy into HeaderMap
|
|
// Copy only headers that will be used to sign the request
|
|
let mut headers = HeaderMap::new();
|
|
for (name, value) in request.headers_in_iterator() {
|
|
if let Ok(name) = name.to_str() {
|
|
if name.to_lowercase() == "host" {
|
|
let Ok(value) = http::HeaderValue::from_bytes(value.as_bytes()) else {
|
|
return Status::NGX_DECLINED;
|
|
};
|
|
|
|
headers.insert(http::header::HOST, value);
|
|
}
|
|
} else {
|
|
return Status::NGX_DECLINED;
|
|
}
|
|
}
|
|
headers.insert("X-Amz-Date", datetime_now.parse().unwrap());
|
|
ngx_log_debug_http!(request, "headers {:?}", headers);
|
|
ngx_log_debug_http!(request, "method {:?}", method);
|
|
ngx_log_debug_http!(request, "uri {:?}", uri);
|
|
ngx_log_debug_http!(request, "datetime_now {:?}", datetime_now);
|
|
|
|
let s = aws_sign_v4::AwsSign::new(
|
|
method.as_str(),
|
|
&uri,
|
|
&datetime,
|
|
&headers,
|
|
"us-east-1",
|
|
conf.access_key.as_str(),
|
|
conf.secret_key.as_str(),
|
|
"s3",
|
|
"",
|
|
);
|
|
s.sign()
|
|
};
|
|
|
|
request.add_header_in("authorization", signature.as_str());
|
|
request.add_header_in("X-Amz-Date", datetime_now.as_str());
|
|
|
|
for (name, value) in request.headers_out_iterator() {
|
|
ngx_log_debug_http!(request, "headers_out {name}: {value}",);
|
|
}
|
|
for (name, value) in request.headers_in_iterator() {
|
|
ngx_log_debug_http!(request, "headers_in {name}: {value}",);
|
|
}
|
|
|
|
Status::NGX_OK
|
|
}
|
|
}
|