brandur.org

Simple and stateless CSRF protection with the `Origin` header

I’ve previously written about how much I like static sites. You can’t beat them for speed, simplicity, or scalability (during relatively rare peak load times this site will serve ~20k uniques/day without breaking a sweat, and for only a few dollars a month), but of course their inherent downside is that introducing any kind of dynamic elements to a site becomes hard or impossible.

I’ve been running what is probably the world’s most infrequently-sent newsletter for about a year now 1, and to get perfect control over email layout decided (against all of my own advice to avoid NIH software) to build it on a tech stack of my own design. Receiving new signups and adding them to the list needs dynamic communication with my mailing list provider, and my static site obviously wasn’t able to provide that.

To plug the hole I ended up building a separate Go app and linking prospective users from here to there to sign up. It worked, but the user experience left a lot to be desired in that subscribing became an awkward multi-step process (link to the newsletter page, get linked to the signup app, then submit the signup form). And because the app was hosted on Heroku’s free tier, following a link to it usually involved a lengthy wait for it to come out of hibernation.

If you’re wondering why I couldn’t just render a form on the static site and have it submit to the dynamic signup app, well, it hasn’t historically been possible to do this safely.

Every application should protect itself against cross-site submissions to prevent CSRF attacks. The traditional way of doing so is to generate a CSRF protection token and put in a user’s cookie and also embed it as a hidden field in the form to be submitted. When receiving a submitted form, the token in the cookie is compared to the token in the form, and the contents rejected unless they match (or the form field is empty). The complication in this approach is that because the token needs to be included in the form to be submitted, you need a dynamic app just to render the form in addition to receiving its payload.

Fortunately, the addition of the Origin header that came in with CORS gives us a new option. Origin is a little like the classic Referer header (which contains the URL of the referring site) except that it contains strictly less information to reduce the amount of user information being exposed to a destination site. It still contains an origin domain, but the path is stripped. That means that even conscientious web browsers can send the header liberally without worrying about leaking as much of their user’s browsing information.

Applications can take advantage of Origin to implement simplified CSRF protection that checks its value against a known whitelist instead of using a token and cookie. Origin is a forbidden header, which means that it can’t be altered programmatically through JavaScript, and therefore an attacker can’t prevent it from being sent or modify its value. Apps receiving it can rely on its validity.

I ended up using Origin for my cross-site newsletter signup process. I wrote a Go CSRF protection middleware that relies only on the header’s value and started hosting a form directly on my static site’s newsletter page. The signup app whitelists the static site’s URL https://brandur.org along with its own https://passages-signup.herokuapp.com, and will allow form submissions from either origin.

Submitting a form from a static site to a dynamic signup app.
Submitting a form from a static site to a dynamic signup app.

I also “solved” (with a hammer) the app unidle wait by having the static newsletter page try to load a tiny image from the dynamic app that it submits its form to, giving the app a chance to spin up while the user is entering an email address 2.

More generally, in practically every case you’d be wise to just use whatever CSRF protection the framework you’re using offers, but in case you need a simplified setup for some reason, Origin is a useful trick.

Lastly, I’ll note that token-based CSRF protection is still the recommended approach to mitigating CSRF according to OWASP (the Open Web Application Security Project). An Origin-based solution has previously been recommended as primary defense, but was moved to a “defense in depth” recommendation after it came to light that certain browsers don’t include the header in some situations. For example, IE11 when issuing a CORS request across sites in a trusted zone.

For the time being, those cases are rare enough that Origin approach should be fine, especially if you also configure your protection middleware to allow an empty Origin value (again, an attacker doesn’t have a way to spoof that). However, as noted by OWASP, token-based protection will provide the best possible compatibility.

1 And with a new issue on the way, now is a great time to sign up.

2 At the cost of some false positives for users who land on the page and decide not to sign up. Luckily, unidling a 7 MB Go slug is not an overly expensive operation.

Did I make a mistake? Please consider sending a pull request.