https://github.com/phpipam/phpipam-agent
phpipam scan agent
https://github.com/phpipam/phpipam-agent
Last synced: 4 months ago
JSON representation
phpipam scan agent
- Host: GitHub
- URL: https://github.com/phpipam/phpipam-agent
- Owner: phpipam
- Created: 2015-10-05T17:10:41.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2024-07-24T19:00:35.000Z (almost 2 years ago)
- Last Synced: 2025-04-07T05:36:15.218Z (about 1 year ago)
- Language: PHP
- Size: 259 KB
- Stars: 92
- Watchers: 18
- Forks: 43
- Open Issues: 41
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Description
phpipam-agent is a scanning agent for a phpipam server to be deployed to remote servers
## License
phpipam is released under the GPL v3 license. See misc/gpl-3.0.txt.
## Requirements
- 64bit PHP version 5.4+ with following modules
- pdo, pdo_mysql : Adds support for mysql connections (if type=mysql)
- gmp : Adds support for dev-libs/gmp (GNU MP library) -> to calculate IPv6 networks
- json : Adds supports for JSON data-interexchange format
- pcntl : Adds supports for threading via CLI ( not supported by windows )
- PHP PEAR support (dev-php/pear)
## Install
```
git clone --recursive https://github.com/phpipam/phpipam-agent/ phpipam-agent
```
Just run index.php script with discover or update as argument.
- Make sure this client has read/write access to main phpipam database.
```SQL
GRANT SELECT on `phpipam`.* TO 'username'@'hostname' identified by "password";
GRANT INSERT,UPDATE on `phpipam`.`ipaddresses` TO 'username'@'hostname' identified by "password";
GRANT UPDATE on phpipam.scanAgents TO 'username'@'hostname' identified by "password";
```
- If you will remove inactive dhcp/autodiscovered also this is needed
```SQL
GRANT DELETE on `phpipam`.`ipaddresses` TO 'username'@'hostname' identified by "password";
```
## Update
```
cd phpipam-agent
git pull
git submodule update --init --recursive
```
## Scheduled scans
For scheduled scans you have to run a script from cron. Add something like the following to your cron to scan
every 15 minutes:
```
*/15 * * * * php /where/your/agent/index.php update
*/15 * * * * php /where/your/agent/index.php discover
```
## Contact
`miha.petkovsek@gmail.com`