Table of contents
This page was set to be reviewed before 2018-06-21 by the page owner: #govuk-developers. This might mean the content is out of date. Read how to review a page.

Cookies and sessions in GOV.UK frontend apps

GOV.UK frontend applications, with the exception of Licensing and Email Alert Frontend, do not currently require cookies.

We configure Varnish to strip cookies for inbound and outbound requests.

This means any features in frontend application relying on sessions/cookies will not work.

CSRF protection

By default, Rails enforces CSRF protection by adding a hidden athenticity_token to forms. This is verified by Rails on the subsequent POST. In order to verify the authenticity_token, Rails needs to set and access a session cookie.

Because we strip cookies, verifying the CSRF authenticity_token causes an error and displays a Rails based “The change you wanted was rejected” error.

If your front end application does not need CSRF protection, you can disable it on a per-application basis or per-method basis. A per-method basis is preferred because it exposes the smallest unit of risk from a security perspective. To disable CSRF protection, you can add an exception to your controller:

protect_from_forgery except: [:a_method_or_two]

Enabling cookies and sessions

Email Alert Frontend uses cookies to enable sessions for subscribing, unsubscribing and managing subscriptions. It sets the Cache-Control HTTP header to private for these routes to ensure the pages are not cached by browsers, the CDN or other intermediate caches.

Fastly’s cache-control documentation notes that you should set your Cache-Control to private if you want to ensure Fastly does not cache the resource (note that no-cache and no-store apparently are not respected by Fastly). You will also need to update the Varnish configuration to allow cookies for your application for both inbound and outbound requests.

This page was set to be reviewed before 2018-06-21 by the page owner: #govuk-developers. This might mean the content is out of date. Read how to review a page.