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

O que é a CSP

Por que isso importa No Módulo 10 você viu como um único comentário sem escape pode colocar o script de um atacante em uma página. O escape é a primeira linha de defesa, mas basta um ponto esquecido. A Content Security Policy é uma segunda linha: mesmo que um script escape para o seu HTML, o navegador se recusa a rodá-lo. Para os visitantes, isso significa que um bug no seu site tem muito menos chance de virar a sessão roubada deles ou os dados deles enviados para outro lugar.

Pense em uma lista de convidados na porta de uma festa. O anfitrião escreve quem pode entrar. A equipe da porta não liga para o quão convincente um desconhecido parece: sem nome na lista, sem entrada. Uma Content Security Policy é uma lista de convidados para tudo o que uma página carrega e roda.

Content Security Policy (CSP): um cabeçalho de resposta, Content-Security-Policy, em que um site diz ao navegador de onde scripts, estilos, imagens, quadros e outros recursos podem vir. O navegador bloqueia qualquer coisa fora da lista e registra uma mensagem no console do DevTools.

Como uma política é montada

Uma política é uma lista de diretivas separadas por ponto e vírgula. Cada diretiva é um nome seguido das suas fontes, separadas por espaços.

Content-Security-Policy: default-src 'self'; img-src 'self' https://img.example; object-src 'none'

Diretiva: uma regra para um tipo de recurso, como script-src (scripts), style-src (folhas de estilos), img-src (imagens), font-src, connect-src (fetch e requisições parecidas feitas por scripts), frame-src (iframes dentro da sua página) e object-src (plug-ins antigos).

Fonte: uma entrada em uma diretiva. 'self' significa sua própria origem (mesmo esquema e mesmo host). https://cdn.example significa aquele host. *.cdn.example significa seus subdomínios. https: significa qualquer endereço HTTPS. * significa quase qualquer coisa. 'none' significa nada. Palavras-chave como 'self' precisam manter as aspas simples; nomes de host não podem tê-las.

A regra de recuo

default-src é a lista de convidados usada para qualquer diretiva de busca que você não escreveu. No cabeçalho acima, scripts e estilos recuam para 'self', enquanto as imagens têm sua própria lista. Três diretivas importantes nunca recuam: frame-ancestors (quem pode enquadrar sua página, Lição 68), base-uri (para onde uma tag <base> pode apontar) e form-action (para onde os formulários podem enviar). Se você as deixar de fora, elas simplesmente não ficam restritas.

O código inline é o grande ponto. Sem ajuda, uma política com script-src 'self' bloqueia todo <script>...</script> escrito na página e todo atributo no estilo onclick=. É exatamente o que você quer contra a injeção, e é por isso que os sites precisam de um jeito de permitir os próprios scripts inline (Lição 66).

Lendo um cabeçalho real: o deste site

Aqui está a parte de scripts da política que o learn.floati.life envia (verificado em outubro de 2026), resumida:

default-src 'self'; base-uri 'self'; object-src 'none';
script-src 'self' 'nonce-RANDOM' 'unsafe-inline' 'unsafe-eval' 'wasm-unsafe-eval'
           https://cdnjs.cloudflare.com https://unpkg.com https://esm.run https://cdn.jsdelivr.net blob:
  • default-src 'self': tudo o que não está listado só carrega deste site.
  • object-src 'none' e base-uri 'self': nada de plug-ins, e uma tag <base> injetada não consegue redirecionar em silêncio os links relativos.
  • 'nonce-RANDOM': um valor aleatório novo a cada carregamento da página. Só os scripts inline que o carregam podem rodar.
  • 'unsafe-inline': parece alarmante, mas os navegadores que entendem nonces o ignoram quando há um nonce listado. Ele só fica para navegadores muito antigos.
  • 'unsafe-eval': um compromisso honesto. O Python no navegador e a IA no dispositivo precisam dele, então o site aceita esse risco e documenta o porquê.
  • Uma lista curta de hosts de script nomeados, em vez de https: ou *. Mesmo um host nomeado só é tão seguro quanto o que ele serve: um CDN público de pacotes como o unpkg.com entrega qualquer pacote que alguém tenha publicado, então permiti-lo deixa um atacante que consegue injetar uma tag carregar o próprio script publicado. Uma política mais rigorosa fixa esses arquivos com hashes ou com 'strict-dynamic', ou os serve a partir deste site. Saber onde sua própria política é fraca faz parte de lê-la com honestidade.

Ler políticas assim, linha por linha, perguntando "o que isto deixa entrar, e por quê?", é a habilidade que este módulo constrói.

Um equívoco comum: "com CSP eu não preciso fazer escape". A CSP é um cinto de segurança, não um freio. Uma política com uma brecha, ou uma página que permite 'unsafe-inline' sem nonces, ainda roda código injetado. Faça o escape primeiro, depois acrescente a CSP.

Experimente Abra o DevTools em qualquer site, vá para a aba Network, recarregue, clique na primeira requisição (a do documento) e procure content-security-policy em Response Headers. Muitos sites grandes enviam uma; muitos pequenos não enviam nenhuma. Depois abra o Console: os recursos bloqueados aparecem lá como mensagens de CSP.

Resumo

  • A CSP é um cabeçalho de lista de convidados: o navegador recusa recursos e código inline que a política não permite.
  • As diretivas cobrem tipos de recurso; default-src substitui as diretivas de busca que faltam, mas frame-ancestors, base-uri e form-action nunca recuam.
  • Bloquear scripts inline é o coração da CSP contra a injeção; os nonces deixam passar seus próprios scripts inline.
  • A CSP é um reforço do escape; ela não o substitui.

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.