|
||
---|---|---|
assets | ||
components | ||
styles | ||
.editorconfig | ||
.gitignore | ||
.prettierrc | ||
README.md | ||
background.ts | ||
email-template-harsh.js | ||
email-template-polite.js | ||
esbuild.config.js | ||
extended-request.ts | ||
manifest.json | ||
mark.ts | ||
memory.ts | ||
options.scss | ||
options.tsx | ||
package-lock.json | ||
package.json | ||
render-data-list.js | ||
request-cluster.ts | ||
safer-emitter.ts | ||
stolen-data-entry.ts | ||
tsconfig.json | ||
util.ts |
README.md
Rentgen
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.
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.
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
- Pobierz repozytorium przez
git pull https://git.internet-czas-dzialac.pl/icd/rentgen.git
lub pobierz archwium zip - Przejdź do głównego katalogu pobranego repozytorium
- Uruchom komendę:
npm install
- Uruchom komendę:
npm run build
- Uruchom komendę:
npm run create-package
- Przejdź do katalogu
web-ext-artifacts
- Znajdziesz tam archiwum zip:
rentgen-x-x-x.zip
(x-x-x
oznaczają wersję wtyczki)
Kroki do uruchomienia
- Uruchom Firefoxa i przejdź do strony
about:debugging
- Kliknij zakładkę This Firefox
- Kliknij przycisk Load Temporary Add-on...
- Wybierz archiwum, które zbudowałeś w ostatnim kroku procesu budowy
Zgłaszanie błędów
Link do issue trackera na naszej instancji Discourse: https://forum.internet-czas-dzialac.pl/c/rentgen-issue-tracker
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.
English description 🇬🇧
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.
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
- Pull repository or download a zip package
- Go to the root directory of the pulled repository
- Run command:
npm install
- Run command:
npm run build
- Run command:
npm run create-package
- Go to the
web-ext-artifacts
directory - You will find a zip archive:
rentgen-x-x-x.zip
(x-x-x
means add-on version)
Run steps
- Run Firefox and go to
about:debugging
- Click This Firefox tab
- Click Load Temporary Add-on... button
- Pick the zip archive from last step of build process.
Issue tracker
Link to issue tracker on our Discourse instance: https://forum.internet-czas-dzialac.pl/c/rentgen-issue-tracker
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
![](/icd/rentgen/media/tag/0.1.8/assets/screenshots/image-14.png)
![](/icd/rentgen/media/tag/0.1.8/assets/screenshots/image-15.png)
![](/icd/rentgen/media/tag/0.1.8/assets/screenshots/3a.png)
![](/icd/rentgen/media/tag/0.1.8/assets/screenshots/3b.png)
![](/icd/rentgen/media/tag/0.1.8/assets/screenshots/4a.png)
![](/icd/rentgen/media/tag/0.1.8/assets/screenshots/4b.png)
![](/icd/rentgen/media/tag/0.1.8/assets/screenshots/5a.png)
![](/icd/rentgen/media/tag/0.1.8/assets/screenshots/5b.png)
![](/icd/rentgen/media/tag/0.1.8/assets/screenshots/2022-07-14_21-04.png)