- P0: rust/ 改 workspace(ipass-core 内核 + gateway 唯一 cdylib), [profile.release] 上移根、依赖收敛 workspace.dependencies; users::delete 的 stats::forget 依赖改为 on_delete 钩子注册表 - P1: 契约层 core/plugin.rs(Plugin trait)+ core/loc.rs(Switch 并集 + set_switch_fn,未实现变体保守 false);gateway PLUGINS 分发循环, 不认领统一 404(插件绝不自行 404) - P2: 身份端点下沉 core/api.rs(CorePlugin + CoreExt 扩展注册表, gateway 作装配根回填域名数/用量/连带回收/白名单校验); plugin-domain crate(domains + DomainEntry + sub: 前缀 + ResolveHandler + $proxy_backend_addr + 域名类端点含 purge) - 行为等价:conf/nginx.conf、Dockerfile、tests 零改动,262 回归全绿 - 方案文档 docs/plugin/PLUGINIZATION_PLAN.md
192 lines
6.6 KiB
Rust
192 lines
6.6 KiB
Rust
//! 域名类端点:管理员审核/创建/删除/清理 + 账号态申请/查询/删除。
|
||
//!
|
||
//! 路由表只认领**本插件**的路径;不认领的返回 `None` 交给下一个插件。
|
||
//! `/api/admin/purge` 清理的是过期域名与陈旧驳回记录,属域名职责。
|
||
|
||
use ngx::core::Status;
|
||
use ngx::ffi::ngx_http_request_t;
|
||
use ngx::http::HTTPStatus;
|
||
use serde_json::json;
|
||
|
||
use ipass_core::api::{Actor, Guard, run_guarded, user_or_401};
|
||
use ipass_core::http;
|
||
use ipass_core::util;
|
||
|
||
use crate::config;
|
||
use crate::domains;
|
||
|
||
// ===========================================================================
|
||
// 路由
|
||
// ===========================================================================
|
||
|
||
type Handler = fn(*mut ngx_http_request_t, Actor) -> Status;
|
||
|
||
fn route(method: &str, uri: &str) -> Option<(Guard, Handler)> {
|
||
let entry: (Guard, Handler) = match (method, uri) {
|
||
("GET", "/api/admin/domains") => (Guard::Admin, h_admin_domains),
|
||
("POST", "/api/admin/domains/review") => (Guard::Admin, h_admin_domain_review),
|
||
("POST", "/api/admin/domains/create") => (Guard::Admin, h_admin_domain_create),
|
||
("POST", "/api/admin/domains/delete") => (Guard::Admin, h_admin_domain_delete),
|
||
("POST", "/api/admin/purge") => (Guard::Admin, h_admin_purge),
|
||
("GET", "/api/v1/domains") => (Guard::User, h_my_domains),
|
||
("POST", "/api/v1/domains/apply") => (Guard::User, h_apply),
|
||
("POST", "/api/v1/domains/delete") => (Guard::User, h_my_delete),
|
||
_ => return None,
|
||
};
|
||
Some(entry)
|
||
}
|
||
|
||
/// 本表分发:认领则返回响应状态,不认领返回 `None`。
|
||
pub fn dispatch(r: *mut ngx_http_request_t) -> Option<Status> {
|
||
let method = http::method_str(r);
|
||
let uri = http::uri(r);
|
||
|
||
let Some((guard, handler)) = route(&method, &uri) else {
|
||
return None;
|
||
};
|
||
|
||
Some(run_guarded(r, guard, handler))
|
||
}
|
||
|
||
// ===========================================================================
|
||
// 管理员:域名审核
|
||
// ===========================================================================
|
||
|
||
fn h_admin_domains(r: *mut ngx_http_request_t, _actor: Actor) -> Status {
|
||
http::ok(
|
||
r,
|
||
json!({
|
||
"items": domains::view_all(&domains::all()),
|
||
"pending": domains::count_pending(),
|
||
// 子域名命名规则:前端据此渲染「i + 8位数字 + dm」输入框,
|
||
// 避免前后端各写一份前缀/后缀/zone 而漂移(真源 = 本插件 config.rs)
|
||
"subdomain_rule": {
|
||
"zone": config::ENTERPRISE_ZONE,
|
||
"prefix": config::SUBDOMAIN_PREFIX,
|
||
"suffix": config::SUBDOMAIN_SUFFIX,
|
||
"digits": config::SUBDOMAIN_RAND_DIGITS,
|
||
},
|
||
}),
|
||
"ok",
|
||
)
|
||
}
|
||
|
||
fn h_admin_domain_review(r: *mut ngx_http_request_t, actor: Actor) -> Status {
|
||
let p = http::params(r);
|
||
let id = p.get("id").map(String::as_str).unwrap_or("");
|
||
let action = p.get("action").map(String::as_str).unwrap_or("");
|
||
match domains::review(id, action, actor.admin_name()) {
|
||
Ok(entry) => {
|
||
let msg = if action == "approve" { "已通过审核" } else { "已驳回" };
|
||
http::ok(r, domains::view(&entry), msg)
|
||
}
|
||
Err(e) => http::fail(r, HTTPStatus::BAD_REQUEST, &e),
|
||
}
|
||
}
|
||
|
||
fn h_admin_domain_create(r: *mut ngx_http_request_t, actor: Actor) -> Status {
|
||
let p = http::params(r);
|
||
|
||
// subdomain 缺省(或空串)= 由网关按规则自动生成 `i<8位随机数字>dm`,
|
||
// 与面板上「i + 8位随机数 + dm」是同一套规则(见 domains::gen_subdomain)。
|
||
match domains::create_by_admin(
|
||
p.get("subdomain").map(String::as_str).unwrap_or(""),
|
||
p.get("backend").map(String::as_str).unwrap_or(""),
|
||
p.get("type"),
|
||
p.get("owner"),
|
||
actor.admin_name(),
|
||
) {
|
||
Ok(entry) => http::ok(r, domains::view(&entry), "已创建并直接放行"),
|
||
Err(e) => http::fail(r, HTTPStatus::BAD_REQUEST, &e),
|
||
}
|
||
}
|
||
|
||
fn h_admin_domain_delete(r: *mut ngx_http_request_t, _actor: Actor) -> Status {
|
||
let p = http::params(r);
|
||
let id = p.get("id").map(String::as_str).unwrap_or("");
|
||
|
||
match domains::remove(id) {
|
||
Ok(sub) => http::ok(r, json!({ "subdomain": sub }), "已删除"),
|
||
Err(e) => http::fail(r, HTTPStatus::BAD_REQUEST, &e),
|
||
}
|
||
}
|
||
|
||
fn h_admin_purge(r: *mut ngx_http_request_t, _actor: Actor) -> Status {
|
||
match domains::purge() {
|
||
Ok(removed) => http::ok(
|
||
r,
|
||
json!({ "removed": removed }),
|
||
&format!("已清理 {removed} 条过期/陈旧记录"),
|
||
),
|
||
Err(e) => http::fail(r, HTTPStatus::BAD_REQUEST, &e),
|
||
}
|
||
}
|
||
|
||
// ===========================================================================
|
||
// 账号态
|
||
// ===========================================================================
|
||
|
||
fn h_my_domains(r: *mut ngx_http_request_t, actor: Actor) -> Status {
|
||
let user = match user_or_401(r, actor) {
|
||
Ok(u) => u,
|
||
Err(e) => return e,
|
||
};
|
||
http::ok(
|
||
r,
|
||
json!({ "items": domains::view_all(&domains::by_owner(&user.username)) }),
|
||
"ok",
|
||
)
|
||
}
|
||
|
||
fn h_apply(r: *mut ngx_http_request_t, actor: Actor) -> Status {
|
||
let user = match user_or_401(r, actor) {
|
||
Ok(u) => u,
|
||
Err(e) => return e,
|
||
};
|
||
|
||
let p = http::params(r);
|
||
let entry = match domains::apply(
|
||
&user.username,
|
||
p.get("subdomain").map(String::as_str).unwrap_or(""),
|
||
p.get("backend").map(String::as_str).unwrap_or(""),
|
||
p.get("type"),
|
||
) {
|
||
Ok(e) => e,
|
||
Err(e) => return http::fail(r, HTTPStatus::BAD_REQUEST, &e),
|
||
};
|
||
|
||
let view = domains::view(&entry);
|
||
util::log_notice(&format!(
|
||
"[api] {} 申请 {} type={} status={}",
|
||
user.username,
|
||
entry.subdomain,
|
||
entry.dtype,
|
||
entry.effective_status(util::now())
|
||
));
|
||
|
||
let msg = if entry.status == "approved" {
|
||
format!(
|
||
"已直接放行(临时授权权限生效),{} 小时后自动失效",
|
||
config::TEMP_DOMAIN_TTL / 3600
|
||
)
|
||
} else {
|
||
"已提交申请,等待管理员审核".to_owned()
|
||
};
|
||
http::ok(r, view, &msg)
|
||
}
|
||
|
||
fn h_my_delete(r: *mut ngx_http_request_t, actor: Actor) -> Status {
|
||
let user = match user_or_401(r, actor) {
|
||
Ok(u) => u,
|
||
Err(e) => return e,
|
||
};
|
||
|
||
let p = http::params(r);
|
||
let id = p.get("id").map(String::as_str).unwrap_or("");
|
||
|
||
match domains::remove_own(id, &user.username) {
|
||
Ok(sub) => http::ok(r, json!({ "subdomain": sub }), "已删除"),
|
||
Err(e) => http::fail(r, HTTPStatus::BAD_REQUEST, &e),
|
||
}
|
||
}
|