Skip to content

mantasdaraciunas/CookieScanner

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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
  --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
  --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 www.google.com using cli mode.

$ CookieTester cli --headless --html google.html www.google.com

Just wait for a while, you will found google.html showing results containing cookie descriptions like NID.

About

Cookie Scanner for GDPR compliance

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Go 99.3%
  • Dockerfile 0.7%