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
95
96
97
98
99
100
101
102
103
104
105
106

use std::{
    collections::BTreeSet,
    net::{SocketAddr, SocketAddrV4},
    str::FromStr,
};

use hickory_client::proto::xfer::Protocol;
use hickory_resolver::config::NameServerConfig;
use subscan::{
    enums::dispatchers::SubscanModuleDispatcher, modules::zonetransfer::ZoneTransfer,
    types::result::status::SubscanModuleStatus,
};

use crate::common::{
    constants::{LOCAL_HOST, TEST_BAR_SUBDOMAIN, TEST_DOMAIN},
    mock::funcs,
    utils,
};

#[tokio::test]
async fn get_tcp_client_test() {
    let server = funcs::spawn_mock_dns_server().await;
    let zonetransfer = ZoneTransfer::dispatcher();

    if let SubscanModuleDispatcher::ZoneTransfer(zonetransfer) = zonetransfer {
        assert!(zonetransfer.get_tcp_client(server.socket).await.is_ok());
    }
}

#[tokio::test]
async fn get_tcp_client_fail_test() {
    let zonetransfer = ZoneTransfer::dispatcher();
    let addr = SocketAddr::from_str(&format!("{LOCAL_HOST}:0")).unwrap();

    if let SubscanModuleDispatcher::ZoneTransfer(zonetransfer) = zonetransfer {
        assert!(zonetransfer.get_tcp_client(addr).await.is_err());
    }
}

#[tokio::test]
async fn get_ns_as_ip_test() {
    let server = funcs::spawn_mock_dns_server().await;
    let zonetransfer = ZoneTransfer::dispatcher();

    if let SubscanModuleDispatcher::ZoneTransfer(zonetransfer) = zonetransfer {
        let ips = zonetransfer.get_ns_as_ip(server.socket, TEST_DOMAIN).await;

        assert_eq!(ips.unwrap(), [server.socket]);
    }
}

#[tokio::test]
async fn attempt_zone_transfer_test() {
    let server = funcs::spawn_mock_dns_server().await;
    let zonetransfer = ZoneTransfer::dispatcher();

    if let SubscanModuleDispatcher::ZoneTransfer(zonetransfer) = zonetransfer {
        let subs = zonetransfer.attempt_zone_transfer(server.socket, TEST_DOMAIN).await;

        assert_eq!(subs.unwrap(), [TEST_BAR_SUBDOMAIN]);
    }
}

#[tokio::test]
async fn run_success_test() {
    let server = funcs::spawn_mock_dns_server().await;
    let mut zonetransfer = ZoneTransfer::dispatcher();

    if let SubscanModuleDispatcher::ZoneTransfer(ref mut zonetransfer) = zonetransfer {
        zonetransfer.ns = Some(NameServerConfig::new(server.socket, Protocol::Tcp));
    }

    let (results, status) = utils::run_module(zonetransfer, TEST_DOMAIN).await;

    assert_eq!(results, [TEST_BAR_SUBDOMAIN.into()].into());
    assert_eq!(status, SubscanModuleStatus::Finished);
}

#[tokio::test]
async fn run_no_default_ns_test() {
    let mut zonetransfer = ZoneTransfer::dispatcher();

    if let SubscanModuleDispatcher::ZoneTransfer(ref mut zonetransfer) = zonetransfer {
        zonetransfer.ns = None;
    }

    let (results, status) = utils::run_module(zonetransfer, TEST_DOMAIN).await;

    assert_eq!(results, BTreeSet::new());
    assert_eq!(status, "no default ns".into())
}

#[tokio::test]
async fn run_failed_test() {
    let mut zonetransfer = ZoneTransfer::dispatcher();
    let socketaddr = SocketAddr::V4(SocketAddrV4::from_str("0.0.0.0:0").unwrap());

    if let SubscanModuleDispatcher::ZoneTransfer(ref mut zonetransfer) = zonetransfer {
        zonetransfer.ns = Some(NameServerConfig::new(socketaddr, Protocol::Tcp));
    }

    let (results, status) = utils::run_module(zonetransfer, TEST_DOMAIN).await;

    assert_eq!(results, BTreeSet::new());
    assert_eq!(status, "connection error".into())
}