forked from Exodus-Privacy/etip
-
Notifications
You must be signed in to change notification settings - Fork 0
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
docs: Lint README.md & CONTRIBUTING.md (Exodus-Privacy#119)
- Loading branch information
Showing
2 changed files
with
27 additions
and
16 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,7 +1,9 @@ | ||
# ETIP - εxodus tracker investigation platform | ||
|
||
[![Build Status](https://travis-ci.org/Exodus-Privacy/etip.svg?branch=master)](https://travis-ci.org/Exodus-Privacy/etip) [![Language grade: Python](https://img.shields.io/lgtm/grade/python/g/Exodus-Privacy/etip.svg?logo=lgtm&logoWidth=18)](https://lgtm.com/projects/g/Exodus-Privacy/etip/context:python) | ||
|
||
ETIP is meant to ease investigations on tracker detection. For the moment, it offers few features: | ||
|
||
* track all modifications on trackers | ||
* detect rules collisions for both network and code signature | ||
|
||
|
@@ -10,8 +12,9 @@ ETIP is meant to ease investigations on tracker detection. For the moment, it of | |
If you wish to help us identify new trackers, you can **request an ETIP account** by sending a username and an email address to [email protected] | ||
|
||
You can also take a look at to the following repositories: | ||
- https://github.com/YalePrivacyLab/tracker-profiles | ||
- https://github.com/jawz101/potentialTrackers | ||
|
||
* <https://github.com/YalePrivacyLab/tracker-profiles> | ||
* <https://github.com/jawz101/potentialTrackers> | ||
|
||
## Contributing to ETIP development | ||
|
||
|
@@ -23,25 +26,27 @@ An API is available to help administrate the ETIP database. | |
|
||
### Authenticate | ||
|
||
``` | ||
```sh | ||
POST /api/get-auth-token/ | ||
``` | ||
|
||
Example: | ||
``` | ||
|
||
```sh | ||
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 | ||
|
||
``` | ||
```sh | ||
GET /api/trackers/ | ||
``` | ||
|
||
Example: | ||
``` | ||
|
||
```sh | ||
curl -X GET http://localhost:8000/api/trackers/ -H 'Authorization: Token <your-token>' | ||
``` | ||
|
||
|
@@ -50,24 +55,28 @@ curl -X GET http://localhost:8000/api/trackers/ -H 'Authorization: Token <your-t | |
### Installation | ||
|
||
Clone the project | ||
``` | ||
|
||
```sh | ||
git clone https://github.com/Exodus-Privacy/etip.git | ||
``` | ||
|
||
Create the Python virtual env | ||
``` | ||
|
||
```sh | ||
cd etip | ||
virtualenv venv -p python3 | ||
source venv/bin/activate | ||
``` | ||
|
||
Install dependencies | ||
``` | ||
|
||
```sh | ||
pip install -r requirements.txt | ||
``` | ||
|
||
Create the database | ||
``` | ||
|
||
```sh | ||
export DJANGO_SETTINGS_MODULE=etip.settings.dev | ||
cd etip/ | ||
python manage.py migrate | ||
|
@@ -80,20 +89,21 @@ python manage.py import_categories | |
``` | ||
|
||
Create admin user | ||
``` | ||
|
||
```sh | ||
python manage.py createsuperuser | ||
``` | ||
|
||
### Run the tests | ||
|
||
``` | ||
```sh | ||
export DJANGO_SETTINGS_MODULE=etip.settings.dev | ||
python manage.py test | ||
``` | ||
|
||
### Start the server | ||
|
||
``` | ||
```sh | ||
export DJANGO_SETTINGS_MODULE=etip.settings.dev | ||
python manage.py runserver | ||
``` | ||
|
@@ -105,10 +115,11 @@ 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. | ||
``` | ||
|
||
```sh | ||
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). | ||
The default εxodus instance queried is the public one available at <https://reports.exodus-privacy.eu.org> (see `--exodus-hostname` parameter). |