//! 域名类端点:管理员审核/创建/删除/清理 + 账号态申请/查询/删除。 //! //! 路由表只认领**本插件**的路径;不认领的返回 `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 { 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), } }