From af5f1e494d895685916df7d68faa8a4329c9ec8c Mon Sep 17 00:00:00 2001 From: nico Date: Sat, 22 Dec 2018 04:46:57 +0100 Subject: code finishup and cleanup + yaml composing ejabberd conformal + added README.md + added .gitignore + added requirements.txt --- README.md | 31 +++++++++++++++++++++++++++++++ 1 file changed, 31 insertions(+) create mode 100644 README.md (limited to 'README.md') diff --git a/README.md b/README.md new file mode 100644 index 0000000..2d2ff33 --- /dev/null +++ b/README.md @@ -0,0 +1,31 @@ +## Blacklist import script + +### ejabberd config +To use this script properly, a separate `yml` file is necessary, as the script will overwrite the file. To further +protect the config the `allow_only` sections defines only `acl` rules. +```yaml + "/etc/ejabberd/blacklist.yml": + allow_only: + - acl +``` + +### script configuration + +The script is meant to be used in an automatic fashion. +Arguments: + +- -dr , --dry-run : perform a dry run. `blacklist.txt` and `.etag` are written but no yaml file is overwritten. +- -o , --outfile filepath : set path to output file + +The dry-run argument will output the file path, if set, in addition to the contents of the yaml file which would have be produced. + +### script workflow +1. check if `.etag` file is present +2. HEAD request + 2.1 requests etag and `.etag` are equal + ​ 2.1.1 use local `blacklist.txt` file + 2.2 requests etag and `.etag` are _not_ equal + ​ 2.2.1 request new `blacklist.txt` + ​ 2.2.2 save new `.etag` and `blacklist.txt` file +3. process `blacklist.txt` and parse output file + -- cgit v1.2.3-18-g5258