subscan 1.3.0

A subdomain enumeration tool leveraging diverse techniques, designed for advanced pentesting operations
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

use std::collections::BTreeSet;

use reqwest::Url;
use serde_json::Value;
use subscan::{
    enums::{auth::AuthenticationMethod, dispatchers::RequesterDispatcher},
    error::ModuleErrorKind::JSONExtract,
    extractors::{json::JSONExtractor, regex::RegexExtractor},
    modules::generics::{engine::GenericSearchEngineModule, integration::GenericIntegrationModule},
    requesters::client::HTTPClient,
    types::{
        core::SubscanModuleCoreComponents, func::GenericIntegrationCoreFuncs,
        query::SearchQueryParam,
    },
};

use super::funcs::wrap_url_with_mock_func;
use crate::common::utils::current_thread_hex;

pub fn generic_search_engine(url: &str) -> GenericSearchEngineModule {
    let requester = RequesterDispatcher::HTTPClient(HTTPClient::default());
    let extractor = RegexExtractor::default();
    let url = Url::parse(url);

    GenericSearchEngineModule {
        name: current_thread_hex(),
        url: url.unwrap(),
        param: SearchQueryParam::from("q"),
        components: SubscanModuleCoreComponents {
            requester: requester.into(),
            extractor: extractor.into(),
        },
    }
}

pub fn generic_integration(url: &str, auth: AuthenticationMethod) -> GenericIntegrationModule {
    let parse = |json: Value, _domain: &str| {
        if let Some(subdomains) = json["subdomains"].as_array() {
            let filter = |item: &Value| Some(item.as_str()?.to_string());

            return Ok(BTreeSet::from_iter(subdomains.iter().filter_map(filter)));
        }

        Err(JSONExtract.into())
    };

    let requester = RequesterDispatcher::HTTPClient(HTTPClient::default());
    let extractor = JSONExtractor::new(Box::new(parse));

    GenericIntegrationModule {
        name: current_thread_hex(),
        auth,
        funcs: GenericIntegrationCoreFuncs {
            url: wrap_url_with_mock_func(url),
            next: Box::new(|_, _| None),
        },
        components: SubscanModuleCoreComponents {
            requester: requester.into(),
            extractor: extractor.into(),
        },
    }
}