| Adrià Vilanova MartÃnez | 413cb44 | 2021-09-06 00:30:45 +0200 | [diff] [blame] | 1 | # Kill Switch |
| 2 | The "Kill Switch" is a system which allows the extension maintainer and some |
| 3 | authorized people to remotely disable a specific feature which is misbehaving |
| 4 | to everyone. |
| 5 | |
| 6 | This folder contains the code that the extension uses to interact with the Kill |
| 7 | Swtich server to determine whether a feature should be disabled or not. |
| 8 | |
| 9 | ## Explanation |
| 10 | The kill switch mechanism works as follows: |
| 11 | |
| 12 | 1. There's a dashboard available at https://twpt-dashboard.avm99963.com/. There, |
| 13 | some authorized users can set some features to be disabled for everyone, |
| 14 | according to some criteria (it might be specified that only some versions of the |
| 15 | extension or some browsers are affected by this). |
| 16 | 1. When a feature is set from the dashboard as force disabled (what we call |
| 17 | "enable a kill switch"), an entry is added to the server's database. |
| 18 | 1. Every 30 minutes, the extension queries the server behind the dashboard, to |
| 19 | retrieve a list of force disabled features from the database. |
| 20 | 1. The extension processes this list, and if any of the features in the list |
| 21 | apply to the extension according to the linked criteria, it force disables |
| 22 | those. If, on the contrary, a feature which was force disabled is no longer |
| 23 | force disabled, the previous status is restored. |