snaver/sauron

Laravel 5.3+ project to monitor changes in Whois and DNS records.

dev-master 2017-03-02 22:30 UTC

Requires

• php: >=5.6.4
• graham-campbell/bitbucket: ^1.0
• graham-campbell/github: ^4.4
• laravel/framework: 5.3.*
• mashape/unirest-php: ^3.0
• pda/pheanstalk: ^3.1

MIT

• Richard

• queue
• bitbucket
• github
• dns
• laravel
• whois
• jobs

README

Laravel 5.3 project to monitor changes in Whois and DNS records.

Utilising Laravel Queues & Jobs, checks can be performed on a set of defined domains for either DNS or Whois records. The Laravel Scheduler can be used to arrange when these checks are run.

Alternatively a new set of Laravel artisan commands are provided to run these checks php artisan checks:run dns and php artisan checks:run whois.

Both checks return JSON results which are stored as text diffs in a single GitHub Gist, by storing them this way; instead of say a database it prevents data duplication and allows you to see the historical differences over time.

Configuration

• ENV - SAURON_EMAIL
• Config - github.connections.main.token (https://github.com/GrahamCampbell/Laravel-GitHub/blob/master/config/github.php)
• ENV - SAURON_GITHUB_GIST_ID
• ENV - SAURON_JSONWHOISAPI_API_KEY
• ENV - SAURON_JSONWHOISAPI_CUSTOMER_ID

TODO

• Add notifications upon changes - email, slack, webhook
• Create interface for storing records, so either github, bitbucket, text file could be used
• Add options for using different providers, currently using dns-lg.com for DNS records and jsonwhoisapi.com for Whois checks
• Create Laravel/Unit tests