From 6d5f44d489e652743d4596aba0b2c3bd3f3ee250 Mon Sep 17 00:00:00 2001
From: Pierre de La Morinerie <kemenaran@gmail.com>
Date: Tue, 22 Feb 2022 17:17:55 +0100
Subject: [PATCH] config: translate the CSP comments from french to english

---
 .../initializers/content_security_policy.rb   | 23 +++++++++----------
 1 file changed, 11 insertions(+), 12 deletions(-)

diff --git a/config/initializers/content_security_policy.rb b/config/initializers/content_security_policy.rb
index c798a1bed..f0021b58b 100644
--- a/config/initializers/content_security_policy.rb
+++ b/config/initializers/content_security_policy.rb
@@ -5,22 +5,20 @@
 # https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Security-Policy
 
 Rails.application.config.content_security_policy do |policy|
-  # Whitelist image
   images_whitelist = ["*.openstreetmap.org", "*.cloud.ovh.net", "*"]
   images_whitelist << URI(DS_PROXY_URL).host if DS_PROXY_URL.present?
   images_whitelist << URI(MATOMO_IFRAME_URL).host if MATOMO_IFRAME_URL.present?
   policy.img_src(:self, :data, :blob, *images_whitelist)
 
-  # Whitelist JS: nous, sendinblue et matomo
-  # miniprofiler et nous avons quelques boutons inline :(
+  # Javascript: allow us, SendInBlue and Matomo.
+  # We need unsafe_inline because miniprofiler and us have some inline buttons :(
   scripts_whitelist = ["*.sendinblue.com", "*.crisp.chat", "crisp.chat", "*.sibautomation.com", "sibautomation.com", "cdn.jsdelivr.net", "maxcdn.bootstrapcdn.com", "code.jquery.com"]
   scripts_whitelist << URI(MATOMO_IFRAME_URL).host if MATOMO_IFRAME_URL.present?
   policy.script_src(:self, :unsafe_eval, :unsafe_inline, :blob, *scripts_whitelist)
 
-  # Pour les CSS, on a beaucoup de style inline et quelques balises <style>
-  # c'est trop compliqué pour être rectifié immédiatement (et sans valeur ajoutée:
-  # c'est hardcodé dans les vues, donc pas injectable).
-  policy.style_src(:self, "*.crisp.chat", "crisp.chat", 'cdn.jsdelivr.net', 'maxcdn.bootstrapcdn.com', :unsafe_inline)
+  # CSS: We have a lot of inline style, and some <style> tags.
+  # It's too complicated to be fixed right now (and it wouldn't add value: this is hardcoded in views, so not subject to injections)
+  policy.style_src(:self, :unsafe_inline, "*.crisp.chat", "crisp.chat", 'cdn.jsdelivr.net', 'maxcdn.bootstrapcdn.com')
 
   connect_whitelist = ["wss://*.crisp.chat", "*.crisp.chat", "in-automate.sendinblue.com", "app.franceconnect.gouv.fr", "sentry.io", "openmaptiles.geo.data.gouv.fr", "openmaptiles.github.io", "tiles.geo.api.gouv.fr", "wxs.ign.fr"]
   connect_whitelist << ENV.fetch('APP_HOST')
@@ -31,21 +29,22 @@ Rails.application.config.content_security_policy do |policy|
   connect_whitelist << Rails.application.secrets.matomo[:host] if Rails.application.secrets.matomo[:enabled]
   policy.connect_src(:self, *connect_whitelist)
 
+  # Frames: allow Matomo's iframe on the /suivi page
   frame_whitelist = []
   frame_whitelist << URI(MATOMO_IFRAME_URL).host if Rails.application.secrets.matomo[:enabled]
   policy.frame_src(:self, *frame_whitelist)
 
-  # Pour tout le reste, par défaut on accepte uniquement ce qui vient de chez nous
-  # et dans la notification on inclue la source de l'erreur
+  # Everything else: allow us
+  # Add the error source in the violation notification
   default_whitelist = ["fonts.gstatic.com", "in-automate.sendinblue.com", "player.vimeo.com", "app.franceconnect.gouv.fr", "sentry.io", "*.crisp.chat", "crisp.chat", "*.crisp.help", "*.sibautomation.com", "sibautomation.com", "data"]
   default_whitelist << URI(DS_PROXY_URL).host if DS_PROXY_URL.present?
   policy.default_src(:self, :data, :blob, :report_sample, *default_whitelist)
 
   if Rails.env.development?
-    # Les CSP ne sont pas appliquées en dev: on notifie cependant une url quelconque de la violation
-    # pour détecter les erreurs lors de l'ajout d'une nouvelle brique externe durant le développement
+    # CSP are not enforced in development (see content_security_policy_report_only in development.rb)
+    # However we notify a random local URL, to see breakage in the DevTools when adding a new external resource.
     policy.report_uri "http://#{ENV.fetch('APP_HOST')}/csp/"
-    # En développement, quand bin/webpack-dev-server est utilisé, on autorise les requêtes faites par le live-reload
+    # Allow LiveReload requests
     policy.connect_src(*policy.connect_src, "ws://localhost:3035", "http://localhost:3035")
   else
     policy.report_uri CSP_REPORT_URI if CSP_REPORT_URI.present?