kazemisoroush / ntm
Network topology mapper with Laravel 5.
Requires
- php: >=5.3.0
- laravelcollective/remote: ^5.5
- nesbot/carbon: ^1.22
- symfony/process: ~2.0|~3.0
Requires (Dev)
- orchestra/testbench: ^3.5
- phpunit/phpunit: ^6.4
This package is not auto-updated.
Last update: 2025-03-28 13:15:26 UTC
README
Network topology mapper with Laravel 5. This package runs an Nmap scan on input hosts and networks, parses and populates the database with extracted values. First you must add service provider into your app.php
config file.
'providers' => [ ... Ntcm\Ntm\NtmServiceProvider::class ... ]
Then you must publish config files. This will copy ntm.php
config file inside your config directory.
$ php artisan vendor:publish
Before doing the migrations, you can customize your table names inside ntm.php
file in your config directory. With no config file and by default all tables are prefixed with mapper_
. After that do the database migration.
$ php artisan migrate
Now you can run a scan like so:
use Ntcm\Ntm\Ntm; $targets = 'scanme.nmap.org'; Ntm::create() ->setTimeout(60) // in seconds... ->scan($targets) ->parseOutputFile();
This will scan the host inside a 1.xml
file and store the parsed information into the database with scan_id = 1
. You can also input an array of targets like so:
$targets = ['scanme.nmap.org', '192.168.101.0/24']; Ntm::create() ->setTimeout(60) ->scan($targets) ->parseOutputFile();
Besides you can enable / disable different scan attributes. These are the default values for the attributes.
$targets = ['scanme.nmap.org', '192.168.101.0/24']; Ntm::create() ->setTimeout(60) ->scan($targets) ->setTraceroute(true) ->setReverseDns(true) ->setPortScan(true) ->setOsDetection(true) ->setServiceInfo(true) ->setVerbose(false) ->setTreatHostsAsOnline(true) ->parseOutputFile();
Scan Command
You can run a scan using ScanCommand
class like so:
$targets = ['scanme.nmap.org', '192.168.101.0/24']; // call scan artisan command... Artisan::call('scan', [ 'targets' => $targets, '--os' => true, // to enable operating system scan... '--ports' => true, // to enable well-known TCP ports... '--scheduled' => '0 1,13 * * * *' // you can use this to schedule the scan... ]);
Scheduled Scan
You can schedule your scans by adding this code to schedule
method of your App\Console\Kernel
class:
/** * Define the application's command schedule. * * @param Schedule $schedule * * @return void */ protected function schedule(Schedule $schedule) { foreach(Target::scheduled()->get() as $target) { $schedule ->command('scan', [ 'ranges' => $target->range, '--os' => $target->ports, '--ports' => $target->os, ]) ->cron($target->scheduled); } }