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

Laboratório de auditoria

Por que isso importa A maioria das políticas que você encontra no trabalho real não é sua: você as herda, ou alguém pergunta "nossa CSP é boa?". Ler uma política no olho é lento e fácil de errar, principalmente com as regras de recuo. Uma pequena pontuação repetível permite comparar políticas, achar a mais fraca rápido e mostrar a uma equipe exatamente o que mudar.

Pense em um vistoriador de segurança residencial com uma prancheta. Ele não reprojeta sua casa. Ele marca cinco itens (alarme de fumaça, gás, fiação, fechaduras, rota de fuga), dá uma nota e entrega uma lista curta de consertos. Este laboratório é essa prancheta para a CSP.

Rubrica: uma lista fixa de verificações, cada uma valendo alguns pontos, aplicada do mesmo jeito a toda política. Como ela nunca muda, duas pessoas pontuando o mesmo cabeçalho chegam ao mesmo número.

As cinco verificações

Cada verificação vale 20 pontos, para uma nota de 0 a 100. Use allows e effective_sources de watched.leg3a_csp, que já aplicam as regras de recuo (Lição 64). Compare as fontes em minúsculas. As palavras-chave mantêm as aspas simples dentro da string do Python, então object-src 'none' volta como ["'none'"], não ['none']. A página de teste é ORIGIN = "https://shopd.example".

NomePassa quandoImpede
inline-scriptsallows(header, {"kind": "script", "inline": True}, ORIGIN) é Falseum script inline injetado
outside-scriptsallows(header, {"kind": "script", "url": "https://prize.example/x.js"}, ORIGIN) é Falseum script do servidor do atacante
pluginso object-src efetivo é exatamente ["'none'"]conteúdo de plug-ins antigos
base-urio base-uri efetivo é exatamente ["'none'"] ou ["'self'"]uma tag <base> injetada
framingframe-ancestors está presente, não está vazio e não tem nenhum de *, https:, http:clickjacking

As cinco políticas

FIVE_POLICIES guarda cinco cabeçalhos realistas: uma loja antiga que permite tudo, um blog com script-src 'self' https:, uma política que só define o enquadramento, uma política rigorosa baseada em nonces e a própria política deste site (resumida). Tente prever a nota de cada uma antes de rodar o código.

Aqui está um resultado honesto, adiantado: a política do floati.life perde os pontos de enquadramento. Isso não é um buraco no site real, porque ele envia X-Frame-Options: DENY no lugar (Lição 68), e esta rubrica só lê a CSP. A lição: uma nota é uma ferramenta para fazer perguntas, não um veredito. A política também mantém 'unsafe-eval', que a rubrica não pontua, para o Python no navegador.

Consertando a mais fraca

fix(header) deve mudar o mínimo possível:

  1. Se o cabeçalho já tira 100, retorne-o sem mudança.
  2. Senão, faça o parse_policy dele. Pegue as fontes de script efetivas (effective_sources(policy, "script-src"), que podem vir de default-src), tire as que estão em DANGEROUS (compare em minúsculas) e defina script-src com o que sobrar, ou ["'self'"] se não sobrar nada. Hosts nomeados e nonces sobrevivem.
  3. Só para as verificações que falharam: defina object-src como ["'none'"], base-uri como ["'self'"], frame-ancestors como ["'self'"].
  4. Deixe toda outra diretiva como estava e junte de volta com "; ", cada diretiva escrita como seu nome e suas fontes separados por espaços.

Tirar 'unsafe-eval' é o certo para uma loja que não precisa dele. Em um site real, confira antes: algumas ferramentas, como o executor de Python daqui, realmente precisam dele. Anote essa decisão em vez de mantê-la em silêncio.

Um equívoco comum: "uma nota 100 significa que o site é seguro". Esta rubrica confere cinco brechas comuns. Ela não vê um nonce reutilizado em toda página, um CDN confiável que hospeda arquivos de qualquer um, nem uma injeção no DOM que o Trusted Types pegaria. Use-a para achar os problemas óbvios rápido e depois leia a política direito.

Em outras linguagens

Interpretar um cabeçalho é o mesmo pequeno loop em todo lugar: divida no ;, depois nos espaços, e o primeiro nome vence.

// JavaScript
function parsePolicy(header) {
  const policy = {};
  for (const part of header.split(";")) {
    const [name, ...sources] = part.trim().split(/\s+/);
    if (name && !(name.toLowerCase() in policy)) policy[name.toLowerCase()] = sources;
  }
  return policy;
}
// Go
policy := map[string][]string{}
for _, part := range strings.Split(header, ";") {
    bits := strings.Fields(part)
    if len(bits) == 0 { continue }
    name := strings.ToLower(bits[0])
    if _, seen := policy[name]; !seen { policy[name] = bits[1:] }
}
// Rust
let mut policy = std::collections::HashMap::new();
for part in header.split(';') {
    let mut bits = part.split_whitespace();
    if let Some(name) = bits.next() {
        policy.entry(name.to_lowercase()).or_insert(bits.collect::<Vec<_>>());
    }
}

Resumo

  • Cinco verificações pegam as brechas comuns: scripts inline, scripts externos, plug-ins, base-uri e enquadramento.
  • Sempre pontue com as regras de recuo aplicadas; a leitura no olho as perde.
  • Conserte com a menor mudança: limpe a lista de scripts, acrescente as diretivas que faltam, mantenha os hosts nomeados e os nonces.
  • Uma nota começa a conversa; o contexto, como X-Frame-Options ou uma biblioteca que precisa de eval, a termina.
Sua vez

Escreva três funções:

  1. score_policy(header): rode as cinco verificações da tabela na ordem de CHECKS. Retorne {"score": 20 * passed, "failed": [names of failed checks, in CHECKS order]} (a lista traz os nomes das verificações que falharam, na ordem de CHECKS).
  2. weakest(policies): policies é um dict de nome para cabeçalho. Retorne o nome com a menor nota; em caso de empate, o nome que vem primeiro em ordem de A a Z.
  3. fix(header): siga os quatro passos acima para que o resultado tire 100, mantenha os hosts de script nomeados e os nonces, e deixe as outras diretivas sem mudança.
Mantenha as linhas de impressão no fim: elas pontuam FIVE_POLICIES, nomeiam a mais fraca e imprimem o conserto dela. Os testes também usam 40 políticas aleatórias de random_policy(seed).

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.