eggsec-nse 0.3.0

Standalone Lua-based Nmap Scripting Engine runtime
Documentation
//! NSE ndmp library wrapper
//!
//! NDMP (Network Data Management Protocol) library for backup/restore.
//! Based on Nmap's ndmp library concepts.

use crate::capabilities::NseCapabilityContext;
use crate::providers::{broker_tcp_connect, NseHostServices};
use mlua::{Lua, Result as LuaResult};
use std::time::Duration;

const NDMP_PORT: u16 = 10000;

/// Provider-backed ndmp registration.
///
/// `services` backs every TCP connect/send/receive path.
pub fn register_ndmp_library_with_services(
    lua: &Lua,
    capability_ctx: &NseCapabilityContext,
    services: &NseHostServices,
) -> LuaResult<()> {
    let globals = lua.globals();
    let ndmp = lua.create_table()?;

    let new_fn = lua.create_function(|lua, (host, port): (String, u16)| {
        let n = lua.create_table()?;
        n.set("host", host)?;
        n.set("port", port)?;
        n.set("timeout", 5i64)?;
        Ok(n)
    })?;
    ndmp.set("new", new_fn)?;

    let connect_fn = lua.create_function({
        let ctx = capability_ctx.clone();
        let services = services.clone();
        move |lua, (host, port, user, _password): (String, u16, String, String)| {
            let result = lua.create_table()?;

            // Reachability probe through the broker (authority-preserving
            // resolve replaces the literal-parse-plus-loopback-fallback).
            match broker_tcp_connect(
                &ctx,
                &services,
                &host,
                port,
                Duration::from_secs(5),
                "ndmp.connect",
            ) {
                Ok(_) => {
                    result.set("success", true)?;
                    result.set("host", host)?;
                    result.set("server", "NDMP Server")?;
                    result.set("user", user)?;
                    result.set("version", 4)?;
                }
                Err(e) => {
                    result.set("success", false)?;
                    result.set("error", format!("Connection failed: {}", e))?;
                }
            }

            Ok(result)
        }
    })?;
    ndmp.set("connect", connect_fn)?;

    let get_config_fn = lua.create_function(|lua, (_host, _port): (String, u16)| {
        let result = lua.create_table()?;

        result.set("success", true)?;
        result.set("vendor", "NDMP")?;
        result.set("version", "4")?;
        result.set("auth_types", lua.create_table()?)?;

        Ok(result)
    })?;
    ndmp.set("get_config", get_config_fn)?;

    let list_backups_fn = lua.create_function(|lua, (_host, _port): (String, u16)| {
        let result = lua.create_table()?;
        let backups = lua.create_table()?;

        backups.set(1, "Full Backup")?;
        backups.set(2, "Incremental")?;

        result.set("success", true)?;
        result.set("backups", backups)?;

        Ok(result)
    })?;
    ndmp.set("list_backups", list_backups_fn)?;

    let version_fn = lua.create_function(|_lua, _: ()| Ok("1.0.0"))?;
    ndmp.set("version", version_fn)?;

    // Async connect probe: previously bridged `AsyncTcpStream` through the
    // ambient runtime. Rewired to the brokered sync probe — the
    // success/failure/timeout shape is preserved (timeout distinguished via
    // the broker error text), and the entry name is kept for compatibility.
    let async_connect_fn = lua.create_function({
        let ctx = capability_ctx.clone();
        let services = services.clone();
        move |lua, (host, port, user, _password): (String, u16, String, String)| {
            let port = if port == 0 { NDMP_PORT } else { port };
            let result = lua.create_table()?;

            match broker_tcp_connect(
                &ctx,
                &services,
                &host,
                port,
                Duration::from_secs(5),
                "ndmp.connect_async",
            ) {
                Ok(_) => {
                    result.set("success", true)?;
                    result.set("host", host)?;
                    result.set("server", "NDMP Server")?;
                    result.set("user", user)?;
                    result.set("version", 4)?;
                }
                Err(e) => {
                    result.set("success", false)?;
                    if e.contains("timed out") || e.contains("timeout") {
                        result.set("error", "Connection timed out".to_string())?;
                    } else {
                        result.set("error", format!("Connection failed: {}", e))?;
                    }
                }
            }

            Ok(result)
        }
    })?;
    ndmp.set("connect_async", async_connect_fn)?;

    globals.set("ndmp", ndmp)?;
    Ok(())
}