Zeek Package for External DNS¶
Raises a notice when a client is observed querying an external DNS server
Getting Started¶
These instructions will get you a copy of the package up and running on your Zeek cluster. See development for notes on how to install the package in order to hack on or contribute to it.
Prerequisites¶
This is a package designed to run with the Zeek Network Security Monitor. First, get Zeek. We strive to support both the current feature and LTS releases.
The recommended installation method is via the Zeek package manager, zkg. On any recent system, run pip install zkg. After installation, run zkg autoconfig. For more information, see the zkg documentation.
Installing¶
To install the package, run:
zkg install https://github.com/grigorescu/external_dns
If this is being installed on a cluster, install the package on the manager, then deploy it via:
zeekctl deploy
Running the tests¶
zkg will run the test suite before installing. To manually run the tests, go into the tests directory, and run make.
Contributing¶
Please read `:doc:./docs/CONTRIBUTING.md`_ for details on how to contribute.
Versioning¶
We use SemVer for versioning. For the versions available, see the tags on this repository.
Credits¶
Justin Azoff <jazoff@illinois.edu>
See also the list of `:doc:./contributors`_ who participated in this project.
License¶
This project is licensed under the BSD license. See the `:doc:./LICENSE`_ file for details.
Acknowledgments¶
ESnet team for Zeek Package Cookie Cutter