Skip to content

litebito/phpipam-scripts

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

18 Commits
 
 
 
 
 
 
 
 

Repository files navigation

(as I do not have much time, I can only occasionally support/update this script. if there is any dev who would like to join and make this script better, or integrate it officially with phpIPAM, let me know)

phpipam-scripts

These are various scripts to work in conjunction with PHPIPAM (https://github.com/phpipam/phpipam)

nmapScanner.php:

script to use Nmap as scanning tool besides ping/fping

works with phpIPAM 1.5.0

This script does the following:

  • fetches flagged subnets for scanning

  • scans the whole subnet witn Nmap, this will also scan hosts which do not respond to ping and discover missing MAC

  • FOR EACH scan enabled/toggled SUBNET from PHPIPAM, there are 2 phases and assumes that this nmap scanner script is "the boss" (it will overwrite any other scan/discovery in case of conflicts.)

  • Phase 1 : Start from the nmap output of the subnet, and update or add to PHPIPAM, that way, we need to read the file only once. Updates lastseen (this is important for phase 2), hostname, MAC address, other info (notes or comments)

  • Phase 2 : walk through the subnet from PHPIPAM, and compare the lastseen from the script with the lastseen from PHPIPAM: If the one in the database is older, we assume the ip was no longer seen by nmap, and thus considered offline, change the status to offline (not yet as fine grained as in the pingCheck script with the grace period), calculate the Age Offline

In this version, the script updates PHPIPAM using the API

I can write scripts, but I'm not a full time developer, and this was done quick & dirty. So the code may look messy and not optimal.

Feel free to contribute (suggestions, corrections, ....)

You will also need the following files from the phpipam-api-client repo:

https://github.com/phpipam/phpipam-api-clients/tree/master/php-client

class.PHPIPAM-api.php

api-config.php

Disclaimer:

  • Use these scripts at your own risk
  • I'm not responsible for any data or system losses caused by this script. Do NOT use this script if you cannot read/understand PHP.

About

These are various scripts to work in conjunction with PHPIPAM

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages