challenge-bypass-extension

 

Privacy Pass Extension

This browser extension implements the client-side of the Privacy Pass protocol providing unlinkable cryptographic tokens. For example, these tokens can be used on Cloudflare-protected websites to redeem a token instead of solving a CAPTCHA.

Home page: https://privacypass.github.io

Installation

Chrome	Firefox

How it works?

Privacy Pass Providers: 🟩 Cloudflare 🟩 hCaptcha

Get tokens

• Click on the extension icon, and click on top of one of the providers.
• One page will open with a CAPTCHA to be solved.
• Solve successfully the CAPTCHA and the extenison will get some tokens.

Use tokens

• When a page shows a CAPTCHA from one of the providers, and if the extension has tokens, the browser uses a token to pass the provider's challenge without any interaction.
• Otherwise, the user must solve the CAPTCHA, which grants some tokens for future use.

See FAQs and Known Issues section: if something is not working as expected.

Installing from Sources

We recommend to install the extension using the official browser stores listed in Installation section above. If you want to compile the sources or your browser is not supported, you can install the extension as follows.

Building

git clone https://github.com/privacypass/challenge-bypass-extension
nvm use 16
npm ci
npm run build

Once these steps complete, the dist folder will contain all files required to load the extension.

Running Tests

nvm use 16
npm ci
npm test

Manually Loading Extension

Firefox

1. Open Firefox and navigate to about:debugging#/runtime/this-firefox/
2. Click on 'Load Temporary Add-on' button.
3. Select manifest.json from the dist folder.
4. Check extension logo appears in the top-right corner of the browser.

Chrome

1. Open Chrome and navigate to chrome://extensions/
2. Turn on the 'Developer mode' on the top-right corner.
3. Click on 'Load unpacked' button.
4. Select the dist folder.
5. Check extension logo appears in the top-right corner of the browser.
6. If you cannot see the extension logo, it's likely not pinned to the toolbar.

Edge

• Open Edge and navigate to edge://extensions/
• Turn on the 'Developer mode' on the left bar.
• Click on 'Load unpacked' button in the main panel.
• Select the dist folder.
• The extension will appear listed in the main panel.
• To see the extension in the bar, click in the puzzle icon and enable it, so it gets pinned to the toolbar.

from https://github.com/privacypass/challenge-bypass-extension