Conteúdo do curso Lição 66 de 156 · Content Security Policy e enquadramento
Content Security Policy e enquadramento

Nonces, hashes e report-only

Por que isso importa Quase todo site real tem alguns scripts inline próprios. Se o único jeito de mantê-los funcionando for 'unsafe-inline', a CSP para de proteger contra a injeção. Nonces e hashes deixam seus scripts entrarem e mantêm os injetados de fora. O modo report-only permite ligar uma política sem quebrar nada para os visitantes no primeiro dia.

Imagine um show em que a pulseira de cada noite tem uma cor diferente, anunciada só para a equipe uma hora antes de abrir as portas. Uma pulseira falsificada da semana passada não serve para nada. Um nonce é a pulseira desta noite para os seus scripts inline.

Nonces

Nonce: abreviação de "number used once" (número usado uma vez). Um valor aleatório novo que o servidor cria para toda resposta, coloca no cabeçalho como 'nonce-VALUE' e também escreve em cada uma das suas próprias tags de script inline como nonce="VALUE".

Content-Security-Policy: script-src 'self' 'nonce-4fT9qLx2Zb8wRk1e'

<script nonce="4fT9qLx2Zb8wRk1e">startShop();</script>      runs
<script>sendCookies();</script>                          blocked: no nonce

Um atacante que injeta uma tag de script não conhece o valor desta resposta, então o script dele é recusado. Três regras fazem isso ser verdade:

  • Imprevisível: pelo menos 128 bits de uma fonte aleatória segura, como o secrets.token_urlsafe(16) do Python.
  • Novo a cada resposta: nunca um valor fixo em um arquivo de configuração, e cuidado com caches de página que serviriam o mesmo nonce para todo mundo.
  • Só nas suas próprias tags: um template que acrescenta o nonce a qualquer tag de script, incluindo as montadas a partir da entrada do usuário, entrega a pulseira ao atacante.

Este site faz isso com django-csp: todo script inline nos templates é escrito como <script nonce="{{ request.csp_nonce }}">, e o pacote coloca o valor correspondente no cabeçalho.

Hashes

Fonte de hash: 'sha256-BASE64', a impressão digital SHA-256 do texto exato dentro de uma tag de script. Se o texto bater, ele roda. Útil em páginas estáticas em que nada consegue acrescentar um nonce por resposta.

import base64, hashlib
code = "startShop();"          # exactly what is between the tags
print("'sha256-" + base64.b64encode(hashlib.sha256(code.encode()).digest()).decode() + "'")

Todo byte conta: um espaço ou uma quebra de linha a mais dá um hash diferente. Hashes e nonces só cobrem blocos inline <script>, não atributos onclick= (uma palavra-chave pouco usada, 'unsafe-hashes', pode permitir um manipulador com hash, mas mudá-lo de lugar é mais limpo). Mova os manipuladores para o seu script com addEventListener.

Por que às vezes o 'unsafe-inline' fica

Quando há um nonce ou um hash listado, os navegadores que os entendem ignoram 'unsafe-inline'. Navegadores muito antigos não entendem nonces, então recuam para 'unsafe-inline' e o site continua funcionando neles. É por isso que a política do floati.life lista os dois. Sem um nonce ou um hash, porém, 'unsafe-inline' deixa todo script injetado rodar.

Um passo além é 'strict-dynamic': um script em que você confiou com um nonce pode carregar mais scripts, e os navegadores que aceitam isso passam a ignorar as listas de hosts. Combina com apps grandes que carregam código na hora. (O verificador de prática não o modela.)

Implantando com segurança: report-only

Content-Security-Policy-Report-Only: um segundo cabeçalho com a mesma sintaxe. O navegador não bloqueia nada, mas informa o que teria bloqueado, no console e, se você pedir, para um endereço no seu servidor.

Reporting-Endpoints: csp="https://shopd.example/csp-reports"
Content-Security-Policy-Report-Only: default-src 'self'; script-src 'self' 'nonce-...'; report-to csp

report-to nomeia um endpoint do cabeçalho Reporting-Endpoints. Guias mais antigos usam report-uri https://...; muitos sites enviam os dois, e os navegadores que entendem report-to ignoram report-uri. Uma implantação sensata: envie a nova política como report-only por uma ou duas semanas, conserte o que ela informar e depois mude para o cabeçalho que aplica a política. Você pode enviar uma política aplicada e uma report-only mais rigorosa lado a lado.

Nota de privacidade: um informe inclui o endereço da página e o endereço bloqueado. Endereços de página podem carregar dados pessoais nas query strings, então envie os informes para o seu próprio servidor, guarde-os por pouco tempo e nunca para um serviço externo de análise de dados.

Um equívoco comum: "o report-only protege os visitantes enquanto eu testo". Ele não protege ninguém. É uma ferramenta de medição. Não deixe uma política em report-only por meses.

Em outras linguagens
// JavaScript (Node)
const nonce = require("crypto").randomBytes(16).toString("base64");
// Go
b := make([]byte, 16); rand.Read(b)   // crypto/rand
nonce := base64.StdEncoding.EncodeToString(b)
// PHP
$nonce = base64_encode(random_bytes(16));

Resumo

  • Um nonce é um valor novo e impossível de adivinhar por resposta que marca seus próprios scripts inline.
  • Um hash permite um script inline exato; qualquer mudança no texto dele exige um hash novo.
  • 'unsafe-inline' é ignorado quando há um nonce ou um hash listado, e é perigoso quando não há.
  • Implante com Content-Security-Policy-Report-Only e depois aplique; mantenha os informes no seu próprio servidor.

Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição

Este exercício abre em breve

Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.