1
0
Fork 0
mirror of https://github.com/gorhill/uMatrix.git synced 2024-06-02 10:24:59 +12:00

this fixes #39

This commit is contained in:
gorhill 2014-11-03 16:04:59 -05:00
parent 3ddb31a96c
commit 4f5cc46e4e
4 changed files with 34 additions and 134 deletions

View file

@ -1,8 +1,6 @@
HTTP Switchboard (FOSS) put you in FULL control of where your browser is allowed to connect, what type of data it is allowed to download, and what it is allowed to execute. Nobody else decides for you: You choose. You are in full control of your privacy.
µMatrix (FOSS) put you in FULL control of where your browser is allowed to connect, what type of data it is allowed to download, and what it is allowed to execute. Nobody else decides for you: You choose. You are in full control of your privacy.
HTTP Switchboard filtering engine is composed of two specialized filtering engines: The matrix filtering engine (firewall-like filters), and the ABP filtering engine (Adblock Plus-compatible filters).
[IMPORTANT: Out of the box, HTTP Switchboard works in block-all/allow-exceptionally mode, meaning web sites which require scripts are likely to be "broken". With two clicks, HTTP Switchboard can be set to work in allow-all/block-exceptionally mode, which generally will not break web sites. See https://github.com/gorhill/httpswitchboard/wiki/How-to-use-HTTP-Switchboard:-Two-opposing-views for more details on this topic.]
[IMPORTANT: Out of the box, µMatrix works in relax block-all/allow-exceptionally mode, meaning web sites which require 3rd-party scripts are likely to be "broken". With two clicks, µMatrix can be set to work in allow-all/block-exceptionally mode, which generally will not break web sites. See https://github.com/gorhill/httpswitchboard/wiki/How-to-use-HTTP-Switchboard:-Two-opposing-views for more details on this topic.]
[IMPORTANT: Regarding the myth that "Chromium-based browsers can't reliably block javascript", see: https://github.com/gorhill/httpswitchboard/wiki/Blocking-javascript-execution-reliably-in-Chromium-based-browsers]
@ -14,7 +12,7 @@ HTTP Switchboard filtering engine is composed of two specialized filtering engin
* You do not have to solely rely on just one particular curated blacklist (arguably with many missing entries) outside which nothing else can be blocked.
* Ease of use: HTTP Switchboard lets you easily whitelist/blacklist net requests which originate from within a web page according to a point-and-click matrix:
* Ease of use: µMatrix lets you easily whitelist/blacklist net requests which originate from within a web page according to a point-and-click matrix:
- domain names (left column)
* from very specific
@ -32,13 +30,13 @@ HTTP Switchboard filtering engine is composed of two specialized filtering engin
You can blacklist/whitelist a single cell, an entire row, a group of rows, an entire column, or the whole matrix with just one click.
HTTP Switchboard's matrix filtering engine uses precedence logic to evaluate what is blocked/allowed according to which cells are blacklisted/whitelisted. For example, this allows you to whitelist a whole page with one click, without having to repeatedly whitelist whatever new data appear on the page.
µMatrix's filtering engine uses precedence logic to evaluate what is blocked/allowed according to which cells are blacklisted/whitelisted. For example, this allows you to whitelist a whole page with one click, without having to repeatedly whitelist whatever new data appear on the page.
You can also create scopes for your whitelist/blacklist rules. For example, this allows you to whitelist `facebook.com` ONLY when visiting Facebook web site.
The goal of this extension is to make the allowing or blocking of web sites, wholly or partly, as straightforward as possible, so as to not discourage those users who give up easily on good security and privacy habits.
As of April 2014, the extension comes with preset blacklists totaling over 55,000 distinct hostnames (each list can be disabled/enabled according to your choice, and there are more preset blacklists which you can activate if you wish so.)
The extension comes 3rd-party hosts files totaling over 58,000 distinct hostnames (lists can be disabled/enabled according to your choice).
Ultimately, you can choose however you browse the net:
@ -58,7 +56,7 @@ FEEDBACK: For any question/issue you might have, use the "Send Feedback" button
=====
This is pre-version 1.0, more work is intended. Bugs/issues/suggestions are addressed as quickly as possible. See: https://github.com/gorhill/httpswitchboard/issues?state=open
Bugs/issues/suggestions are addressed as quickly as possible. See: https://github.com/gorhill/httpswitchboard/issues?state=open
You are very welcomed to contribute your views on open issues and suggestions, various arguments for/against help me in deciding what is needed to improve the extension.
@ -84,18 +82,6 @@ This extension is also useful if you wish to speed up your browsing, by blocking
=====
HTTP Switchboard is the fruit of a personal project, there no company of any kind involved, therefore no agenda other than giving users the tools to be in complete control of their browser. I appreciate the thought, but I do not want donation, now or in the future. If you **REALLY** want to give something in return, then my wish would be that you direct your donation to an organisation genuinely dedicated to defend basic principles of democracy. Examples: Freedom of the Press Foundation (https://pressfreedomfoundation.org/), EFF (https://www.eff.org/), Wikileaks (https://wikileaks.org/), or whatever non-for-profit organisation fits the "genuinely dedicated to defend basic principles of democracy" profile in your home country.
Source code is GPLv3, available at https://github.com/gorhill/umatrix
Contributors: https://github.com/gorhill/httpswitchboard/graphs/contributors
=====
Source code is GPLv3, available at https://github.com/gorhill/httpswitchboard
----------
Latest changes:
0.9.0.0
2014-04-27
https://github.com/gorhill/httpswitchboard/wiki/Change-log#0900
Latest changes: https://github.com/gorhill/umatrix/releases

View file

@ -1,101 +0,0 @@
HTTP Switchboard (Gratuit et Open Source) vous donne les PLEINS POUVOIRS sur votre navigateur et sur les endroits vers lesquels ce dernier peut se connecter, ce qu'il peut télécharger, et ce qu'il peut exécuter. Personne d'autre ne décidera pour vous : VOUS décidez. Vous avez toutes les cartes en main pour contrôler votre vie privée en ligne.
Le moteur de filtrage d'HTTPSB (abréviation d'HTTP Switchboard) comprend deux types de filtrage spécialisé : Le moteur de filtrage matriciel (utilisant des filtres similaires à ceux d'un parefeu), et le moteur de filtrage type ABP (employant des filtres compatibles Adblock Plus).
[IMPORTANT : Par défaut, HTTPSB fonctionne en mode Blocage total/Permissions exceptionnelles, ce qui veut dire que les sites Web utilisant des scripts peuvent dysfonctionner. En seulement deux clics, l'extension peut être configurée pour travailler en mode Tout autoriser/Blocage exceptionnel, ce qui en général n'empêchera pas des sites Web de fonctionner. Pour plus d'information à ce sujet, consultez cette page Web en Anglais : https://github.com/gorhill/httpswitchboard/wiki/How-to-use-HTTP-Switchboard:-Two-opposing-views ]
[IMPORTANT : À propos du soi-disant fait que "les navigateurs à moteurs Chromium ne peuvent bloquer le code JavaScript en toute fiabilité", consultez cette page Web en Anglais : https://github.com/gorhill/httpswitchboard/wiki/Blocking-javascript-execution-reliably-in-Chromium-based-browsers]
Caractéristiques d'HTTP Switchboard :
* Consultez TOUTES les tentatives de connexions distantes, échouées ou réussies, selon qu'elles soient bloquées ou autorisées(c'est vous qui en décidez)
* En un clic, vous pouvez mettre en liste blanche/noire une ou plusieurs sortes de requêtes d'après la destination et le type des données (sachant qu'une requête bloquée ne "sortira" JAMAIS de votre navigateur)
* Mise en liste noire efficace : Les cookies ne sortiront pas de votre navigateur, le code JavaScript ne sera pas exécuté, les plugins ne démarreront pas, les pixels de pistage ne seront pas téléchargés, etc
* Attention à ne pas simplement compter que sur une seule liste noire prédéfinie pour vous protéger, pensez à utiliser les multiples listes prédéfinies pour renforcer le moteur de filtrage type ADB
* Facilité d'utilisation : HTTPSB vous laisse facilement mettre en liste blance/noire des requêtes réseau provenant d'une page Web d'après une matrice qui vous permet de manipuler en quelques clics de souris :
- Les noms de domaine (colonne de gauche)
* De très spécifique
* À très générique
- Les types de requête (première ligne)
* cookies
* stylesheets (connu sous l'abréviation CSS) (et polices Web)
* images
* objects (objets)
* scripts
* XHR (requêtes effectuées par des scripts)
* frames
* others (autres)
Vous pouvez en un clic mettre en liste noire/blanche une simple cellule, une ligne entière, un ensemble de lignes, une colonne entière, ou la matrice toute entière.
Le moteur de filtrage matriciel d'HTTP Switchboard utilise une logique de priorité pour évaluer ce qui doit être bloqué/autorisé d'après l'état des cellules (liste noire/blanche). Par exemple, cela vous permet de mettre en liste blanche tout une page Web en un clic, sans avoir à mettre en liste blanche de manière répétitive toute nouvelle donnée apparaissant sur la page.
Vous pouvez aussi créer des règles de différentes portées pour vos règles blanches/noires. Par exemple, cela vous permet de mettre en liste blanche "twitter.com" UNIQUEMENT si vous visitez le site Web de Twitter.
Le but de cette extension est de rendre l'autorisation/le refus de sites Web, en totalité ou partiellement, aussi direct(e) que possible, pour ne pas décourager les utilisateurs qui abandonnent facilement les bonnes habitudes en matière de sécurité et de confidentialité.
Au mois d'Avril 2014, HTTPSB fournit des listes prédéfinies de blocage totalisant plus de 55 000 noms de domaine différents, sachant que chacune de ces listes peut être désactivée/activé selon vos choix, et qu'il y a des listes prédéfinies supplémentaires qui peuvent aussi être activées si vous le souhaitez.
Enfin, vous pouvez choisir comment surfer sur le Net :
* Tout mettre en liste noire, et accorder des permissions exceptionnelles si besoin est (il s'agit du mode par défaut)
* Tout mettre en liste blanche, et bloquer exceptionnellement si nécessaire (non recommandé)
Sitôt l'installation de l'extension terminée, vous aurez le choix entre différents modes de filtrage matriciel, une fois le mode choisi, il ne tient qu'à vous de le personnaliser et de l'accorder à vos besoins !
De toute manière, vous bénéficierez toujours des listes de règles prédéfinis pour avoir ne serait-ce qu'une protection basique contre les pisteurs, les sites Web malveillants, etc. Ou vous pouvez désactiver tout cela (non recommandé) !
Encore une fois, c'est votre choix.
Retrouvez ici en langue anglaise de la documentation rassemblée aléatoirement sur l'extension : https://github.com/gorhill/httpswitchboard/wiki
=====
RETOURS : Pour n'importe quel doute/souci que vous pourriez avoir, n'hésitez pas à me contacter. Je ne suis pas en mesure de répondre directement aux avis des utilisateurs sur Chrome/Opera Web Store, mais je serais ravi de vous répondre directement.
=====
Il s'agit d'une préversion qui nécessite encore un peu de travail, bien que proche de la version 1.0. Les anomalies/problèmes/suggestions sont traités le plus rapidement possible. Rendez-vous ici (en Anglais) : https://github.com/gorhill/httpswitchboard/issues?state=open
Vous êtes plus que bienvenue pour apporter vos points de vue sur les problèmes et suggestions discutés, et argumenter en sa faveur/défaveur peut m'aider à me décider de ce qui doit être fait pour améliorer l'extension.
La facilité d'utilisation est l'objectif principal. J'ai déjà vu des utilisateurs jeter l'éponge au sujet de l'extension NoScript à cause du fait qu'elle leur a paru trop contraignante, alors plutôt que de les blâmer pour de piètres habitudes de sécurité, je préfère en vouloir aux développeurs; et ce projet est une tentative de rectifier ces erreurs qui ont entrainé l'abandon des bonnes habitudes de sécurité chez certaines personnes.
HTTP Switchboard est également utile pour comprendre ce qu'effectue en coulisses une page Web dans votre navigateur. Vous pouvez parfaitement voir et décider avec quoi une page Web communique, et restreindre ces différentes communications.
Le nombre qui apparait sur l'icone de l'extension correpond au nombre total de requêtes distinctes tentées (et réussies ou non selon qu'elles ont été autorisées/refusées) en coulisses.
Cliquez simplement à l'endroit approprié dans la matrice pour mettre en liste blanche/noire/grise un élément. La liste grise signifie que leur statut d'autorisation/de refus est héritier depuis une entrée parent dans la matrice.
Rectangle rouge = Mise en liste noire, c'est-à-dire que le moteur de filtrage matriciel empêche les requêtes d'atteindre la destination qu'elles convoitaient :
* Rectangle rouge vif : Le nom de domaine et/ou le type de requête est tout particulièrement mis en liste noire
* Rectangle rouge pâle : Le statut de liste blanche est tributaire de l'élément parent (placé sur liste grise)
Rectangle vert = Mise en liste blanche, c'est-à-dire que les requêtes sont autorisées à atteindre la destination qu'elles convoitaient :
* Rectangle vert vif : Le nom de domaine et/ou le type de requête est tout particulièrement mis en liste blanche
* Rectangle vert pâle : Le statut de liste blanche est tributaire de l'élément parent (placé sur liste grise)
La cellule en haut à gauche de la matrice ("all") représente le paramètre global par défaut, qui vous permet de choisir ce qui est autorisé ou bloqué entièrement dans le comportement par défaut. D'aucuns préfèrent tout autoriser et bloquer exceptionnellement. Personnellement je préfère l'inverse, tout bloquer et autoriser exceptionnellement.
Cette extension est aussi utile si vous souhaitez accélérer votre navigation, en bloquant toutes les requêtes d'images par exemple.
=====
HTTP Switchboard est le fruit d'un projet personnel, il n'y a aucune entreprise impliquée, ainsi je n'ai pas de cahier des charges à tenir, seulement à donner aux utilisateurs les outils pour pouvoir tout contrôler de leurs navigateurs. J'apprécie le geste, mais je ne veux pas de dons, que ce soit maintenant ou à l'avenir. Si vous tenez VRAIMENT à donner quelque chose en retour, alors je souhaiterais que vous fassiez vos dons à un organisme authentiquement dédié à la défense de principes basiques de la démocratie, comme par exemple, la Fondation pour la Liberté de la Presse (https://pressfreedomfoundation.org/), l'Electronic Frontier Foundation (https://www.eff.org/), Wikileaks (https://wikileaks.org/), ou tout organisme à but non-lucratif répond au critère de "défendeur des valeurs de la démocratie" et qui se trouve dans votre pays.
Contributeurs: https://github.com/gorhill/httpswitchboard/graphs/contributors
=====
Le Code Source est sous licence GPLv3, et est disponible à l'adresse suivante : https://github.com/gorhill/httpswitchboard
----------
Consultez le Journal des changements à l'adresse suivante (en Anglais) : https://github.com/gorhill/httpswitchboard/wiki/Change-log

26
doc/INSTALL.md Normal file
View file

@ -0,0 +1,26 @@
## INSTALL
### Manual installation
- Download and unzip `uMatrix.chromium-{version}.zip` ([latest release desirable](https://github.com/gorhill/uMatrix/releases)).
- Rename the unzipped directory to `uMatrix.chromium`
- When you later update manually, replace the **content** of the `uMatrix.chromium` folder with the **content** of the latest zipped version.
- This will ensure that all the extension settings will be preserved
- As long as the extension loads **from same folder path from which it was originally installed**, all your settings will be preserved.
- Go to chromium/chrome *Extensions*.
- Click to check *Developer mode*.
- Click *Load unpacked extension...*.
- In the file selector dialog:
- Select the directory `uMatrix.chromium` which was created above.
- Click *Open*.
The extension will now be available in your chromium/chromium-based browser.
Remember that you have to update manually also. For some users, updating manually is actually an advantage because:
- You can update when **you** want
- If ever a new version sucks, you can easily just re-installed the previous one
### Vendor stores
- Opera store (coming)
- Chrome store (coming)

View file

@ -1,11 +0,0 @@
## INSTALL
- Download and unzip `httpswitchboard_{version}.zip` (latest version desirable).
- Go to chromium/chrome *Extensions*.
- Click to check *Developer mode*.
- Click *Load unpacked extension...*.
- In the file selector dialog:
- Select the directory `httpswitchboard` which was created when you unzipped `httpswitchboard.zip`.
- Click *Open*.
The extension will now be available in your chromium/chrome browser.