https://engineering.fb.com/2022/03/10/security/code-verify/ Skip to content Engineering at Meta Search this site [ ] # * Open Source + Open Source + Meta Open Source * Platforms + Android + iOS + Web * Infrastructure Systems + Core Infra + Data Infrastructure + DevInfra + Production Engineering + Security + Research Publications * Physical Infrastructure + Connectivity + Data Center Engineering + Networking & Traffic + Research Publications * Video Engineering & AR/VR + Video Engineering + Virtual Reality + Research Publications * Artificial Intelligence + ML Applications + AI Research + Research Publications * Watch Videos [ ] POSTED ON MARCH 10, 2022 TO Open Source, Security, Web Code Verify: An open source browser extension for verifying code authenticity on the web WhatsApp Code Verify By Richard Hansen, Vicente Silveira Update on June 16, 2023 at 10:30AM PT: Today we're announcing the introduction of Code Verify for Instagram Web. The Instagram Code Verify extension is offered by Meta Open Source and is available on the official browser extension stores for Google Chrome, Microsoft Edge, and Mozilla Firefox. With Code Verify, you can confirm that your Instagram Web code hasn't been tampered with or altered, and that your Instagram Web experience is the same as everyone else's. Update on August 11, 2022 at 10:30AM PT: Following our introduction of Code Verify for WhatsApp Web, today we're announcing the introduction of Code Verify for Messenger. The Messenger Code Verify extension is offered by Meta Open Source and is available on the official browser extension stores for Google Chrome, Microsoft Edge, and Mozilla Firefox. As with WhatsApp, using Code Verify enables you to confirm that your Messenger Web code hasn't been tampered with or altered, and that the Messenger Web experience you're getting is the same as everyone else's. Originally published on March 10, 2022 at 09:00AM PT: Since WhatsApp introduced multi-device capability last year, we've seen an increase in people accessing WhatsApp directly through their web browser via WhatsApp Web. With this shift in mind, we've been looking at ways to add additional layers of security to the WhatsApp Web experience. Starting today, you can now use Code Verify, an open source web browser extension that automatically verifies the authenticity of the WhatsApp Web code being served to your browser. Code Verify confirms that your WhatsApp Web code hasn't been tampered with or altered, and that the WhatsApp Web experience you're getting is the same as everyone else's. For years, WhatsApp has protected the personal messages you send on WhatsApp Web with end-to-end encryption as they transit from sender to recipient. But security conscious users need to be confident that when WhatsApp Web receives these encrypted messages, it is protected as well. In contrast to a downloadable mobile app, a web app is usually served directly to users, without a third party reviewing and auditing the code. There are many factors that could weaken the security of a web browser that don't exist in the mobile app space, such as browser extensions. Additionally, because the mobile app space was built after the web was created, the security guarantees offered on mobile can be stronger, particularly given that third-party app stores review and approve each app and software update. But today, that's changing, as Code Verify is bringing even more security to WhatsApp Web. Code Verify works in partnership with Cloudflare, a web infrastructure and security company, to provide independent, third-party, transparent verification of the code you're being served on WhatsApp Web. We hope this gives at-risk users peace of mind. No other end-to-end encrypted messaging service has this level of security for people's communications on the web. In addition to deploying Code Verify for WhatsApp Web, it is also being offered as open source so that other services can use it as well. Below is an overview of how Code Verify works, how to use it, and the value of open-sourcing it. How Code Verify works Code Verify expands on the concept of subresource integrity, a security feature that lets web browsers verify that the resources they fetch haven't been manipulated. Subresource integrity applies only to single files, but Code Verify checks the resources on the entire webpage. To do this at scale, and to enhance trust in the process, Code Verify partners with Cloudflare to act as a trusted third party. We've given Cloudflare a cryptographic hash source of truth for WhatsApp Web's JavaScript code. When someone uses Code Verify, the extension automatically compares the code that runs on WhatsApp Web against the version of the code verified by WhatsApp and published on Cloudflare. If there are any inconsistencies, Code Verify will notify the user. While comparing hashes to detect files that have been tampered with is not new, Code Verify does so automatically, with the help of Cloudflare's third-party verification, and at this scale for the first time. WhatsApp's security protections, the Code Verify extension, and Cloudflare all work together to provide real-time code verification. Whenever the code for WhatsApp Web is updated, the cryptographic hash source of truth and extension will update automatically as well. WhatsApp Code VerifyCode Verify matches the WhatsApp Web code you're served with a source of truth verified by WhatsApp and published on Cloudflare to ensure the version of WhatsApp Web you're using is authentic. (Image source: Cloudflare) Cloudflare has provided a deeper dive on how this system works, including their role as a trusted third party, on their blog which can be found here. How to use Code Verify The Code Verify extension is offered by Meta Open Source and will be available on the official browser extension stores for Google Chrome, Microsoft Edge, and Mozilla Firefox. The extension doesn't log any data, metadata, or user data, and it does not share any information with WhatsApp. It also does not read or access the messages you send or receive. In fact, neither WhatsApp nor Meta will know whether someone has downloaded the Code Verify extension. Additionally, the Code Verify extension never sends messages or chats between WhatsApp users to Cloudflare. Once installed, Code Verify will run automatically when you go to WhatsApp Web and act as a real-time alert system for the code you're being served on WhatsApp Web. Pinning the extension to your web browser's toolbar will allow you to see its findings without any additional steps. You can think of Code Verify as a traffic light for your WhatsApp Web code: * Code Verify will run immediately, and if the WhatsApp Web code is fully validated, the Code Verify icon in the browser will appear green (see below). * If the Code Verify icon appears orange (see below), it means that you need to refresh your page or another browser extension is interfering with Code Verify. In this instance, Code Verify will recommend that you pause your other browser extensions. * If the Code Verify icon appears red (see below), it will indicate that there is a possible security issue with the WhatsApp Web code you're being served. WhatsApp Code VerifyMore information about using Code Verify and steps to take in the event of a validation failure or other issues can be found here. Open source for others to leverage as well Code Verify is available on GitHub. Open-sourcing the Code Verify extension has a few important benefits. First, it allows other companies, groups, and individuals to apply this same level of transparency to their own applications and freely share new ideas with one another to help improve the feature. Second, it puts the power of transparency squarely in the hands of the people. As a browser extension that exists independently of WhatsApp and its infrastructure, people can see for themselves that the extension hasn't been tampered with. Third, that same discoverability also protects the extension itself. Since it exists in the public eye, it can benefit from the protections of a watchful open source community. We believe that with Code Verify, we are charting new territory with automatic third-party code verification, particularly at this scale. We hope that more services use the open source version of Code Verify and make third-party verified web code the new norm. And in doing so, we hope this helps bring additional security protections to people all over the world and move the entire industry forward. Download the Code Verify extension for: Chrome Edge Firefox Share this: * Facebook * Threads * X * LinkedIn * Hacker News * Email * TAGS: WhatsApp Read More in Security View All [Eng-Blog-Self-Serve-Hero-Images-PRIVACY-103-Navy-1] DEC 6, 2023 Building end-to-end security for Messenger [English_New-Security-Protections-in-WhatsApp-Calling] NOV 8, 2023 Enhancing the security of WhatsApp calls [Eng-Blog-Self-Serve-Hero-Images-DEBUGGING-202-Navy] SEP 12, 2023 Meta Quest 2: Defense through offense [Scheduling-Jupyter-Notesbooks-HERO] AUG 29, 2023 Scheduling Jupyter Notebooks at Meta [Eng-Blog-Self-Serve-Hero-Images-PRIVACY-103-Blue-x2] AUG 8, 2023 How Meta is improving password security and preserving privacy [Eng-Blog-Self-Serve-Hero-Images-PRIVACY-103-Navy-1] AUG 7, 2023 Using short-lived certificates to protect TLS secrets Related Posts --------------------------------------------------------------------- [WhatsApp-Multi-Device_Hero-Image_FINAL] Jul 14, 2021 How WhatsApp enables multi-device capability [Whatsapp_E2EE-Backups_EngBlog-1] Sep 10, 2021 How WhatsApp is enabling end-to-end encrypted backups [DIT-1] Apr 16, 2021 DIT -- enabling de-identified data collection on WhatsApp Related Positions --------------------------------------------------------------------- * Software Engineer (Technical Leadership) - Privacy Tech MENLO PARK, US * Software Engineer, Camera Driver - Reality Labs BURLINGAME, US * Software Engineer - Data Center Networking BELLEVUE, US * Software Engineer - Data Center Networking MENLO PARK, US * Software Engineer - Data Center Networking SEATTLE, US See All Jobs Available Positions --------------------------------------------------------------------- * Software Engineer (Technical Leadership) - Privacy Tech MENLO PARK, US * Software Engineer, Camera Driver - Reality Labs BURLINGAME, US * Software Engineer - Data Center Networking BELLEVUE, US * Software Engineer - Data Center Networking MENLO PARK, US * Software Engineer - Data Center Networking SEATTLE, US See All Jobs Stay Connected * footer-fb-engineering Engineering at Meta Like * footer-fbopensource Meta Open Source Follow * footer-research Meta Research Like * footer-developers Meta for Developers Like * footer-rss RSS Subscribe Open Source Meta believes in building community through open source technology. Explore our latest projects in Artificial Intelligence, Data Infrastructure, Development Tools, Front End, Languages, Platforms, Security, Virtual Reality, and more. * android ANDROID * ios iOS * web WEB * backend BACKEND * hardware HARDWARE Learn More Meta Engineering at Meta is a technical news resource for engineers interested in how we solve large-scale technical challenges at Meta. * Home * Company Info * Careers (c) 2024 Meta * Terms * Privacy * Cookies * Help To help personalize content, tailor and measure ads and provide a safer experience, we use cookies. By clicking or navigating the site, you agree to allow our collection of information on and off Facebook through cookies. Learn more, including about available controls: Cookie Policy Accept *