This browser extension shows you whether consent registered by cookie banners of IAB Europe's Transparency & Consent Framework corresponds to your choice
Update September 2020: CMPs switched to TCFv2 in August 2020. This extension only handles TCFv1 and is therefore obsolete unless work is done to integrate pull request 10. Project is currently abandoned.
In the paper Do Cookie Banners Respect my Choice? Measuring Legal Compliance of Banners from IAB Europe's Transparency and Consent Framework, we show that Consent Management Providers (CMPs) of IAB Europe's Transparency & Consent Framework (TCF) do not always respect user's choice. This extension allows you to verify that your consent is stored appropriately.
This extension for Firefox and Chrome queries CMPs of IAB Europe's TCF in the same position as a third-party advertiser, making it possible to see consent set by CMPs in real time. In other words, you can see whether consent registered by cookie banners is actually the consent you gave. Will only work with cookie banners of IAB Europe's TCF.
We also added a functionality to manually decode a so-called "consent string" of the framework.
Author: Célestin Matte (Université Côte d'Azur, Inria, France)
This is a research project made at Inria. Stage: complete. TCFv2 support might be added later.
You can either install the extension from browsers' addon stores (simple, easy), or manually install it from source.
Chrome / Chromium : https://chrome.google.com/webstore/detail/cookie-glasses/gncnjghkclkhpkfhghcbobednpchjifk
Firefox: https://addons.mozilla.org/fr/firefox/addon/cookie-glasses/
The extension has been tested on Firefox, Chromium and Firefox mobile.
- Download the ZIP file of Cookie Glasses on your computer.
- Unzip the ZIP file you just downloaded on your computer.
- Open Chrome and enter the following URL in your tab bar: chrome://extensions/
- Enable Developer mode in the top right.
- Click "Load unpacked"
- Choose the
Cookie-Glasse-master
folder on your computer. - Visit websites implementing the Transparency & Consent Framework
- Enjoy detecting violations!
On Firefox, out-of-store addons can only be loaded for the duration of the session (you will have to redo these steps if you close your browser).
- Download the ZIP file of Cookie Glasses on your computer.
- Unzip the ZIP file you just downloaded on your computer.
- Open Firefox and enter the following URL in your tab bar: about:debugging#/runtime/this-firefox
- Click "Load temporary addon"
- Choose the
manifest.json
file in theCookie-Glasse-master
folder on your computer. - Visit websites implementing the Transparency & Consent Framework
- Enjoy detecting violations!
As explained in the paper, there are two ways for advertisers to query the CMP:
- through a direct call to the __cmp() function if they are in a first-party position,
- through a postMessage sent to the __cmpLocator iframe if they are in a third-party position.
Because of the security mechanisms of browsers extensions, Cookie Glasses can only use the second method. According to our measurement, this method is working on 79% of websites using the TCF.
If you want to see consent on the remaining 21% of websites, here's a manual workaround:
- Open the developer console (ctrl+maj+i)
- Run the following code:
__cmp("getConsentData", null, function(v, success) { console.log(v); });
- If you obtain a response, copy-paste the string in the "consentData" field in Cookie Glasses' popup's "decode consent string" field and click on "decode".
For now, the extension does not display the global shared cookie (which is a cookie storing consent, readable and writable by all CMPs of the framework).
Cookie Glasses does not handle any personal information. Cookie Glasses only processes consent information from IAB Europe's Transparency and Consent Framework (TCF) locally, and does not send any information to a distant server.