X-Git-Url: https://git.siccegge.de//index.cgi?p=dane-monitoring-plugins.git;a=blobdiff_plain;f=README.md;h=15af1fa4a7bb971230d244ac2b6a1e951ae5253d;hp=8c9d80e8f6260cbfe2eb06092296a2f236b93035;hb=19426697a401ad52cf88d88700b3e14f05a9d4a7;hpb=948f10d4320d6365f16b482954a61fe25dce3411 diff --git a/README.md b/README.md index 8c9d80e..15af1fa 100644 --- a/README.md +++ b/README.md @@ -1,3 +1,12 @@ +# Scope + +The set of monitoring plugins in this repository is intended to serve +as icinga / nagios / .. checks for DANE enabled network services. The +central functionality therefore is checking whether the services +conforms with the DANE records. However, all service plugins are also +supposed to work as *the* plugin for each service and should be able +to monitor all relevant properties. + # Getting the Code The main repository is located at [git.siccegge.de][1] but mirrors can @@ -6,4 +15,18 @@ processed by mail as well as on both platforms. [1]: https://git.siccegge.de/?p=dane-monitoring-plugins.git [2]: https://gitlab.com/siccegge/dane-monitoring-plugins -[3]: https://github.com/siccegge/dane-monitoring-plugins \ No newline at end of file +[3]: https://github.com/siccegge/dane-monitoring-plugins + +# Dependencies + +The plugins need `pyasn1`, `pyasn1-modules` and the python `unbound` +as well as python3. The `check_dnssec` module needs additionally the +python `ldns` module. Unfortunately the unbound package in Debian only +provides python2 modules currently. Building unbound with python3 +support from source works fine however. + +# License + +Unfortunately the problems at hand tend to result in a dependency on +OpenSSL which makes plain GPL inviable. Until a proper decision is +made you can assume GPLv3 with OpenSSL exception