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

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)

Run steps

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.

Docker Usage

Build and extract artifacts directly

docker buildx build . --output artifacts

This will build the extension and extract the .zip file to the artifacts/ directory.

Build with tests (typecheck + lint)

docker build --target test -t rentgen-test .

Traditional build (creates full development environment)

docker build -t rentgen .
docker run --rm rentgen ls -lh /app/web-ext-artifacts/

Run commands in the container

docker run --rm rentgen npm run build:chrome
docker run --rm rentgen npm run typecheck

Run extension in Firefox (headless)

docker build --target runtime -t rentgen-run .
docker run --rm -it rentgen-run

Using docker-compose

docker compose up rentgen_check     # Build only
docker compose up rentgen_run       # Run in Firefox
docker compose up rentgen_verify    # Build and verify with tests

Using Makefile (recommended for testing)

make verify     # Build, test, and verify extension (exits with error if verification fails)
make clean      # Clean up Docker resources
make help       # Show available targets

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

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)

Kroki do uruchomienia

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

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.

---