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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

use std::{sync::Arc, time::Duration};

use reqwest::Url;
use subscan::{
    enums::dispatchers::SubscanModuleDispatcher,
    interfaces::{module::SubscanModuleInterface, requester::RequesterInterface},
    types::config::requester::RequesterConfig,
};
use tokio::sync::Notify;

use super::dns::MockDNSServer;
use crate::common::{constants::TEST_DOMAIN, utils::current_thread_hex};

pub async fn spawn_mock_dns_server() -> MockDNSServer {
    let notify_one = Arc::new(Notify::new());
    let notift_two = notify_one.clone();

    let server = MockDNSServer::new(TEST_DOMAIN);
    let cloned = server.clone();

    tokio::spawn(async move {
        notift_two.notify_one();
        cloned.start().await;
    });

    notify_one.notified().await;
    server
}

pub fn wrap_url_with_mock_func(url: &str) -> Box<dyn Fn(&str) -> String + Sync + Send> {
    let url: Url = url.parse().unwrap();

    Box::new(move |_| url.to_string().clone())
}

pub async fn set_requester_timeout(dispatcher: &mut SubscanModuleDispatcher, timeout: Duration) {
    let rconfig = RequesterConfig {
        timeout,
        ..Default::default()
    };

    match dispatcher {
        SubscanModuleDispatcher::CommonCrawl(module) => {
            module.requester().await.unwrap().lock().await.configure(rconfig).await;
        }
        SubscanModuleDispatcher::DNSDumpsterCrawler(module) => {
            module.requester().await.unwrap().lock().await.configure(rconfig).await;
        }
        SubscanModuleDispatcher::GitHub(module) => {
            module.requester().await.unwrap().lock().await.configure(rconfig).await;
        }
        SubscanModuleDispatcher::Netlas(module) => {
            module.requester().await.unwrap().lock().await.configure(rconfig).await;
        }
        SubscanModuleDispatcher::WaybackArchive(module) => {
            module.requester().await.unwrap().lock().await.configure(rconfig).await;
        }
        _ => {}
    }
}

pub fn wrap_module_url(dispatcher: &mut SubscanModuleDispatcher, url: &str) {
    match dispatcher {
        SubscanModuleDispatcher::GenericSearchEngineModule(module) => {
            module.url = url.parse().unwrap()
        }
        SubscanModuleDispatcher::GenericIntegrationModule(module) => {
            module.funcs.url = wrap_url_with_mock_func(url)
        }
        SubscanModuleDispatcher::CommonCrawl(module) => module.url = url.parse().unwrap(),
        SubscanModuleDispatcher::DNSDumpsterCrawler(module) => {
            module.url = url.parse().unwrap();
            module.base_url = url.parse().unwrap();
        }
        SubscanModuleDispatcher::GitHub(module) => module.url = url.parse().unwrap(),
        SubscanModuleDispatcher::Netlas(module) => module.url = url.parse().unwrap(),
        SubscanModuleDispatcher::WaybackArchive(module) => module.url = url.parse().unwrap(),
        _ => {}
    }
}

pub fn wrap_module_name(dispatcher: &mut SubscanModuleDispatcher, name: String) {
    match dispatcher {
        SubscanModuleDispatcher::GenericIntegrationModule(module) => {
            module.name = current_thread_hex()
        }
        SubscanModuleDispatcher::GenericSearchEngineModule(module) => {
            module.name = current_thread_hex()
        }
        SubscanModuleDispatcher::GitHub(module) => module.name = name,
        SubscanModuleDispatcher::Netlas(module) => module.name = name,
        _ => {}
    }
}