Skip to content
εxodus tracker investigation platform
Python HTML
Branch: master
Clone or download
Latest commit 6ad2e79 Jan 5, 2020
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
etip
files
.flake8
.gitignore
.travis.yml
LICENSE
README.md
requirements.txt

README.md

ETIP - εxodus tracker investigation platform

Build Status Language grade: Python

ETIP is meant to ease investigations on tracker detection. For the moment, it offers few functionalities:

  • track all modifications on trackers
  • detect rules collisions for both network and code signature

Contribute to the identification of trackers

If you wish to help us identify new trackers, you can request an ETIP account by sending a username and an email address to etip@exodus-privacy.eu.org

You can also take a look at to the following repositories:

Development environment

Installation

Clone the project

git clone https://github.com/Exodus-Privacy/etip.git

Create the Python virtual env

cd etip
virtualenv venv -p python3
source venv/bin/activate

Install dependencies

pip install -r requirements.txt

Create the database

export DJANGO_SETTINGS_MODULE=etip.settings.dev
cd etip/
python manage.py migrate

# Import tracker definitions from the official instance of εxodus
python manage.py import_trackers

# Import predefined tracker categories
python manage.py import_categories

Create admin user

python manage.py createsuperuser

Run the tests

export DJANGO_SETTINGS_MODULE=etip.settings.dev
python manage.py test

Start the server

export DJANGO_SETTINGS_MODULE=etip.settings.dev
python manage.py runserver

Useful commands

Some admin commands are available to help administrate the ETIP database.

Compare with Exodus

This command retrieves trackers data from an εxodus instance and looks for differences with trackers in the local database.

python manage.py compare_with_exodus

Note: for now, it only compares with local trackers having the flag is_in_exodus.

The default εxodus instance queried is the public one available at https://reports.exodus-privacy.eu.org (see --exodus-hostname parameter).

API

An API is available to help administrate the ETIP database.

Authenticate

POST /api/get-auth-token/

Example:

curl -X POST http://localhost:8000/api/get-auth-token/ --data "username=admin&password=testtest"

You need to include your token as an Authorization header in all subsequent requests.

Get trackers

GET /api/trackers/

Example:

curl -X GET http://localhost:8000/api/trackers/ -H 'Authorization: Token <your-token>'
You can’t perform that action at this time.