Rentgen

Rentgen is an add-on prepared for Firefox-based browsers. This extension will automatically visualize all the data that a given website steals sends to third parties.

Note: At the moment, we support Polish language because this extension generates mail content that is dedicated to Polish website owners. In further versions of this add-on, we will add other languages as well.

Features:

• analysis of web traffic generated by the visited website;
• visualization of data transmitted to third parties by the visited site (user's browsing history and cookies);
• preparation of screenshots of development tools as evidence of data transmitted to third parties;
• assisting in the evaluation of potential work areas for compliance with GDPR;
• generating a report or email content that can be sent to an administrator and Personal Data Protection Office in Poland.

Installation

Firefox: https://addons.mozilla.org/en-US/firefox/addon/rentgen/

How to build and run Rentgen on your own

Pre-requirements

• OS: Linux x86_64
• Node.js: 16.x version
• npm: 7.x version or higher

Build steps

Firefox

1. Pull repository or download a zip package
2. Go to the root directory of the pulled repository
3. Run command: npm install
4. Run command: npm run build
5. Run command: npm run create-package
6. Go to the web-ext-artifacts directory
7. You will find a zip archive: rentgen-x-x-x.zip (x-x-x means add-on version)

Chrome

1. Pull repository or download a zip package
2. Go to the root directory of the pulled repository
3. Run command: npm install
4. Run command: npm run build:chrome
5. In the root directory you will find dist-chrome folder

Run steps

Firefox

1. Run Firefox and go to about:debugging
2. Click This Firefox tab
3. Click Load Temporary Add-on... button
4. Pick the zip archive from last step of build process.

Chrome

1. Run Chrome and go to chrome://extensions/
2. Click Load Unpacked button
3. Pick the folder from last step of build process.

Issue tracker

If you find a problem, please send us an email: kontakt@internet-czas-dzialac.pl

We don't receive issues on Microsoft Github.

Each issue will be reviewed and moved to an internal issues list of our Gitea instance: https://git.internet-czas-dzialac.pl/icd/rentgen/issues. We use Gitea and most likely in the future with the federalization of Gitea, we will be able to let users in to report issues directly from the Gitea site.

Screenshots

---

Rentgen to wtyczka dla przeglądarek opartych o Firefoxa, która automatycznie wizualizuje, jakie dane zostały wykradzione wysłane do podmiotów trzecich przez odwiedzane strony. Wtyczka obrazuje ilość skryptów śledzących na stronie internetowej i pomaga w sformułowaniu maila do administratora strony, który może być podstawą do skargi RODO w Urzędzie Ochrony Danych Osobowych.

Funkcje Rentgena:

• analiza ruchu sieciowego generowanego przez stronę internetową;
• wizualizacja danych przekazanych do podmiotów trzecich przez odwiedzaną stronę (historia przeglądania użytkownika oraz jego ciasteczka);
• przygotowywanie zrzutów ekranów narzędzi deweloperskich będących dowodem przekazanych danych do podmiotów trzecich;
• pomoc w oszacowaniu potencjalnych obszarów roboczych względem zgodności z RODO;
• generowanie raportu lub treści maila, którą można wysłać do administratora oraz Urzędu Ochrony Danych Osobowych.

Instalacja

Firefox: https://addons.mozilla.org/pl/firefox/addon/rentgen/

Jak zbudować i uruchomić Rentgena ze źródeł

Wymagania wstępne

• System operacyjny: Linux x86_64
• Node.js: 16.x
• npm: 7.x lub wyższy

Proces budowy

Firefox

1. Pobierz repozytorium przez git pull https://git.internet-czas-dzialac.pl/icd/rentgen.git lub pobierz archwium zip
2. Przejdź do głównego katalogu pobranego repozytorium
3. Uruchom komendę: npm install
4. Uruchom komendę: npm run build
5. Uruchom komendę: npm run create-package
6. Przejdź do katalogu web-ext-artifacts
7. Znajdziesz tam archiwum zip: rentgen-x-x-x.zip (x-x-x oznaczają wersję wtyczki)

Chrome

1. Pobierz repozytorium przez git pull https://git.internet-czas-dzialac.pl/icd/rentgen.git lub pobierz archwium zip
2. Przejdź do głównego katalogu pobranego repozytorium
3. Uruchom komendę: npm install
4. Uruchom komendę: npm run build:chrome
5. W katalogu głównym znajdziesz folder dist-chrome

Kroki do uruchomienia

Firefox

1. Uruchom Firefoxa i przejdź do strony about:debugging
2. Kliknij zakładkę This Firefox
3. Kliknij przycisk Load Temporary Add-on...
4. Wybierz archiwum, które zbudowałeś w ostatnim kroku procesu budowy

Chrome

1. Uruchom Chrome i przejdź do strony chrome://extensions/
2. Kliknij przycisk Load Unpacked
3. Wybierz folder, które zbudowałeś w ostatnim kroku procesu budowy

Zgłaszanie błędów

Jeżeli znajdziesz jakieś problem, napisz do nas maila: kontakt@internet-czas-dzialac.pl

Nie przyjmujemy zgłoszeń na platformie Microsoft Github.

Każdy problem zostanie sprawdzony i przeniesiony na wewnętrzną listę problemów na naszej instancji Gitea: https://git.internet-czas-dzialac.pl/icd/rentgen/issues. Korzystamy z Gitea i najprawdopodobniej w przyszłości dzięki federalizacji Gitea będziemy w stanie wpuścić użytkowników do zgłaszania błędów bezpośrednio ze strony Gitea.

---