Skip to content

CovenantSQL/CookieScanner

Repository files navigation

Cookie Tester

Cookie Tester is a simple utility to analyze website cookie status and generate reports for GDPR-compliance.

Installation

Requires MacOS/Linux system.

First, install Google Chrome in your operating system. Or you can start a headless Chrome in docker with

$ docker container run -d -p 9222:9222 zenika/alpine-chrome --no-sandbox \  --remote-debugging-address=0.0.0.0 --remote-debugging-port=9222

Then, install the CookieTester using go get.

$ go get github.com/CovenantSQL/CookieTester

Usage

CookieTester is capable of geneating reports in json/html/pdf format.

$ CookieTester --help usage: CookieTester [<flags>] <command> [<args> ...] website cookie usage report generator Flags: --help Show context-sensitive help (also try --help-long and --help-man). --chrome=CHROME chrome application to run as remote debugger --verbose run debugger in verbose mode --timeout=1m0s timeout for a single cookie scan --wait=WAIT wait duration after page load in scan --classifier=CLASSIFIER classifier database for cookie report --log-level=LOG-LEVEL set log level Commands: help [<command>...] Show help. cli [<flags>] <site> generate report for a single website version get debugger version server [<flags>] start a report generation server $ CookieTester cli --help usage: CookieTester cli [<flags>] <site> generate report for a single website Flags: --help Show context-sensitive help (also try --help-long and --help-man). --chrome=CHROME chrome application to run as remote debugger --verbose run debugger in verbose mode --timeout=1m0s timeout for a single cookie scan --wait=WAIT wait duration after page load in scan --classifier=CLASSIFIER classifier database for cookie report --log-level=LOG-LEVEL set log level --headless run chrome in headless mode --port=9222 chrome remote debugger listen port --json print report as json --html=HTML save report as html --pdf=PDF save report as pdf Args: <site> site url 

Examples

Generate HTML report for covenantsql.io using cli mode.

$ CookieTester cli \ --headless \ --classifier "covenantsql://050cdf3b860c699524bf6f6dce28c4f3e8282ac58b0e410eb340195c379adc3a?config=./config/config.yaml" \ --html cql.html covenantsql.io

Just wait for a while, you will found cql.html showing results like this:

About

Cookie Scanner for GDPR compliance

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published