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

Escreva uma política

Por que isso importa Uma política frouxa demais deixa o ataque passar; uma política apertada demais quebra sua própria página, e aí alguém desliga a CSP "por enquanto". A habilidade é escrever a política mais apertada que ainda deixa sua página funcionar. Você vai fazer isso em código, para que funcione em qualquer página, e um verificador vai avaliar as duas metades.

De volta à lista de convidados. Um bom anfitrião não escreve "qualquer um de casaco bonito". Ele olha quem realmente foi convidado e escreve esses nomes, e mais ninguém. Aqui você faz o mesmo: olhe o que a página realmente carrega e permita exatamente isso.

O ataque a impedir

No Módulo 10, o texto de um atacante em uma página de prática carregava script: um bloco <script> no livro de visitas (Lição 58), um <img onerror> que escapou do filtro de brinquedo (Lição 61) e um código de faz de conta que enviava cookies para prize.example (Lição 62). O escape consertou isso. Aqui você acrescenta a segunda linha, caso um ponto seja esquecido algum dia. Código injetado em geral chega em um de três formatos, e as páginas de prática daqui contêm os três:

  • um bloco inline <script>...</script>;
  • um manipulador de evento inline, um atributo como onerror="..." em uma tag de imagem;
  • um <script src="https://prize.example/x.js"> apontando para o servidor do atacante.

Uma boa política bloqueia os três e ainda deixa a página carregar seu próprio script de app, sua folha de estilos, suas imagens, sua biblioteca de pagamento, seu quadro de vídeo e seu único script inline.

Manipulador de evento inline: script escrito direto em um atributo HTML cujo nome começa com on, como onerror ou onclick. O navegador o roda quando esse evento acontece. A CSP o trata como script inline.

A página de prática e o verificador

practice_site(seed) de watched.leg3a_csp retorna uma página como um dict: sua origin e uma lista de resources. Cada recurso tem um kind (script, style, img, font, connect, frame), ou uma url ou inline: True, e injected, que é True para os três do atacante. O próprio script inline da página carrega um nonce: um valor aleatório que só o servidor real conhece (a Lição 66 o explica por completo).

{"kind": "script", "url": "https://pay.example/lib.js", "injected": False}
{"kind": "script", "inline": True, "nonce": "y334r23xgecgnryn", "injected": False}
{"kind": "script", "inline": True, "handler": True, "injected": True}

evaluate(policy, page) faz o papel do navegador. Ele retorna broken (recursos necessários que sua política bloqueia) e attacks_run (os injetados que ela deixa passar). Você quer os dois vazios. print_report(policy, page) de watched.leg3d_csp_more imprime a mesma coisa de um jeito legível.

Um plano

  1. Comece toda diretiva com 'self', para que seus próprios arquivos carreguem.
  2. Para cada URL externa necessária, acrescente o esquema e o host dela, como https://pay.example, à diretiva do seu tipo. Não https: nem *: eles deixam prize.example entrar também.
  3. Para o próprio script inline da página, acrescente 'nonce-VALUE' a script-src. Nunca 'unsafe-inline'.
  4. Termine com default-src 'self' para todo o resto, mais object-src 'none', base-uri 'none' e frame-ancestors 'none', que não custam nada em uma página que não precisa de nenhum deles.

Repare no que isso faz com o manipulador de evento: nenhuma fonte que você possa acrescentar permite atributos onerror=, exceto 'unsafe-inline', então deixar essa palavra-chave de fora bloqueia todos eles. Repare também que cada tipo tem sua própria lista. Se sua página busca dados de api.example, esse host pertence a connect-src, não a script-src; senão um atacante que consiga enviar um arquivo para lá poderia rodá-lo como script.

Um equívoco comum: "script-src https: é rigoroso porque força o HTTPS". Ele só força o esquema. Qualquer atacante consegue hospedar um script em um endereço HTTPS.

Em outras linguagens

Quando você tem o cabeçalho, todo servidor o define do mesmo jeito:

// JavaScript (Express)
app.use((req, res, next) => {
  res.set("Content-Security-Policy", "default-src 'self'; object-src 'none'; base-uri 'none'");
  next();
});
// Go (net/http)
w.Header().Set("Content-Security-Policy", "default-src 'self'; object-src 'none'; base-uri 'none'")
// PHP
header("Content-Security-Policy: default-src 'self'; object-src 'none'; base-uri 'none'");
# nginx
add_header Content-Security-Policy "default-src 'self'; object-src 'none'; base-uri 'none'" always;

No Django, o pacote django-csp monta o cabeçalho a partir das configurações e acrescenta um nonce novo a cada requisição, que é como este site faz.

Resumo

  • Permita exatamente os hosts de que cada tipo de recurso precisa; nunca * nem https: para scripts.
  • Permita seu próprio script inline com um nonce; deixar 'unsafe-inline' de fora bloqueia blocos injetados e manipuladores de evento.
  • Acrescente object-src 'none', base-uri e frame-ancestors, que não recuam.
  • Confira as duas metades: nada necessário quebrado, nada injetado rodando.
Sua vez

Escreva duas funções:

  1. source_for(url): retorne o esquema e o host de url, como "https://cdn.example" para "https://cdn.example/v3.js?x=1" (sem caminho, query nem fragmento).
  2. write_policy(page): retorne uma string de cabeçalho CSP para uma página de practice_site. Pule os recursos com injected marcado. Para todo outro recurso, use DIRECTIVE_FOR para encontrar a diretiva dele; cada diretiva começa com 'self' e recebe 'nonce-VALUE' para um script inline, ou source_for(url) para uma URL de outra origem (sem repetições). Junte com "; ", começando com default-src 'self' e terminando com object-src 'none', base-uri 'none' e frame-ancestors 'none'. Não use 'unsafe-inline', * nem https:.
Mantenha as últimas linhas, que imprimem um relatório para practice_site(seed=0). Os testes experimentam 20 páginas de prática diferentes e uma feita à mão, e conferem tanto que nada necessário é bloqueado quanto que nenhum script injetado roda.

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.