Content Security Policy para Ferramentas de Teste A/B: O Que o TI Precisa Permitir e Por Quê

·Atualizado em outubro de 2026
Requisitos de CSP documentados na documentação da Varify
unsafe-eval pode ser limitado às rotas que executam experimentos
Enterprise: entrega de script a partir do seu próprio subdomínio
Pontos-chave
  • Uma Content Security Policy (CSP) informa ao navegador quais fontes uma página pode carregar e executar. Uma ferramenta de teste A/B afeta quatro diretivas: script-src, connect-src, frame-src e frame-ancestors.
  • Os experimentos são definidos depois de a página ser implementada, pelo que o seu código não é conhecido no momento em que a CSP é escrita. Hashes e nonces cobrem apenas código conhecido com antecedência. É por isso que as ferramentas que executam JavaScript de variante personalizado em tempo real precisam de unsafe-eval em script-src.
  • A Varify exige unsafe-eval em script-src para que o JavaScript definido pelo usuário possa ser executado dentro das variantes. O CSP pode ser configurado por rota, de modo que unsafe-eval se aplique apenas onde os experimentos são executados.
  • Implemente o CSP primeiro no modo Report-Only, verifique os relatórios e só então aplique-o. A lista de domínios da Varify está na documentação da Varify, em um único lugar.

Uma Content Security Policy é um cabeçalho HTTP que limita quais scripts, conexões e frames uma página pode usar. É uma das defesas mais eficazes contra cross-site scripting, e muitas equipes de segurança a tornam obrigatória para todo site público. Uma ferramenta de teste A/B precisa se encaixar nessa política, porque carrega um script, se comunica com os próprios servidores e altera a página enquanto está em execução.

Esta página é a página de decisão para uma revisão de segurança: quais diretivas estão envolvidas, por que experimentos em runtime precisam de unsafe-eval, e como manter essa exceção o mais restrita possível. Os domínios exatos que a Varify precisa estão listados na documentação da Varify em Content Security Policy error; esta página aponta para essa lista e não a repete, para que haja apenas uma fonte a manter atualizada.

Por que ferramentas de teste A/B esbarram em CSPs rígidos

Uma CSP estrita assume que todos os scripts de uma página são conhecidos no momento da implementação. A política lista as origens permitidas ou fixa cada script inline com um hash ou um nonce. Tudo o resto é bloqueado.

Uma ferramenta de testes A/B do lado do cliente funciona ao contrário. A tua equipa cria um experimento no editor da ferramenta, muitas vezes dias depois de a página ter sido implementada. O experimento pode alterar texto, trocar imagens, mover elementos ou executar JavaScript personalizado. Esse código chega ao navegador do visitante em tempo real, como parte da configuração do experimento, e o script de testes executa-o nesse momento.

Daqui decorrem três consequências para a CSP:

  • A própria origem do script de testes tem de ser permitida em script-src.
  • Os pedidos que o script envia, por exemplo para carregar configurações de experimentos ou reportar eventos, têm de ser permitidos em connect-src.
  • Código que só existe em tempo real não pode ser fixado antecipadamente com um hash ou nonce. Executá-lo exige uma exceção em script-src.

A mesma restrição aplica-se a qualquer ferramenta que execute JavaScript de variante personalizado no navegador através de funções do tipo eval.

Quais diretivas estão envolvidas

Quatro diretivas determinam se uma ferramenta de testes A/B funciona sob a tua CSP. A coluna Varify remete para a documentação, onde as entradas exatas são mantidas.

DiretivaO que controla numa ferramenta de testes A/BEntrada Varify
script-srcCarregar o script de testes e executar o código do experimento em tempo realVer documentação, incluindo unsafe-eval
connect-srcPedidos do script aos servidores do fornecedor, por exemplo configurações de experimentos e eventosVer documentação
frame-srcFrames que a ferramenta abre na tua página, por exemplo para funcionalidades do editorVer documentação
frame-ancestorsSe a tua página pode ser exibida dentro de um frame, por exemplo por funcionalidades do editorVer documentação

Duas outras diretivas podem ser relevantes consoante o que os teus experimentos fazem: img-src, se as variantes carregarem imagens de uma nova origem, e style-src, se as variantes adicionarem estilos. Verifica-as em relação aos experimentos que a tua equipa planeia executar.

Por que experimentos em tempo real precisam de unsafe-eval

Uma CSP oferece duas formas de permitir um script específico sem permitir tudo: um hash do conteúdo do script, ou um nonce, um valor aleatório que o servidor define para cada resposta e repete em cada tag de script permitida. Ambos só funcionam para código que o servidor conhece no momento em que envia a página.

O código de experimento não cumpre essa condição. É escrito na ferramenta de teste, entregue como dados e transformado em código executável no navegador. Nem um hash nem um nonce podem ser calculados para ele com antecedência. Quando essa etapa usa eval ou funções semelhantes, o navegador só permite isso se o script-src contiver unsafe-eval.

A documentação da Varify é explícita quanto a isso:

  • "Também precisas do valor unsafe-eval na diretiva script-src."
  • "Nota: a entrada unsafe-eval é necessária para que o JavaScript definido pelo utilizador possa ser executado dentro das variantes."
  • "Não, tecnicamente falando, criar e entregar experimentos não é possível sem unsafe-eval."

A explicação completa está no artigo da documentação Strict CSP does not allow unsafe evaluation. Para a tua análise, a questão relevante é, portanto, até onde essa exceção se estende.

Como limitar o risco

unsafe-eval alarga o que um script na página pode fazer. O objetivo da análise é manter esse alargamento tão reduzido quanto possível. Três medidas funcionam em conjunto:

  1. Uma CSP por rota. A CSP pode ser configurada de forma diferente para cada rota, de modo a que unsafe-eval se aplique apenas onde os experimentos são executados, por exemplo em páginas de produto e landing pages. Mantém a política estrita nas páginas de login, conta e pagamento. Uma política por rota restringe onde a exceção se aplica; páginas da mesma origem ainda conseguem comunicar entre si, por isso não substitui as outras duas medidas.
  2. Primeiro em Report-Only. Envia a nova política como Content-Security-Policy-Report-Only durante um período de tráfego normal. O navegador reporta violações sem bloquear nada. Corrige a política até os relatórios mostrarem apenas o que esperas e, só depois, muda para o cabeçalho Content-Security-Policy aplicado. Mantém o período Report-Only tempo suficiente para abranger os experimentos que a tua equipa planeia, porque uma página sem um experimento em execução não mostra o que um experimento necessita.
  3. Controla o que entra nos experimentos. Decide internamente quem pode publicar variantes com JavaScript personalizado e revê esse código antes de ser publicado. A exceção da CSP só é tão segura quanto o processo aplicado ao código que a utiliza.

A Varify também oferece contexto first-party no plano Enterprise: "First-party context (CNAME): Deliver the Varify script from your own subdomain for better performance and fewer blockers." A configuração está descrita na página sobre first-party context (CNAME).

Requisitos de CSP da Varify

Os domínios e valores de diretivas que a Varify precisa são mantidos num único local, a documentação da Varify. Usa estes dois artigos para a tua configuração:

O DPA da Varify lista "Provision of data via encrypted connections such as SFTP or HTTPS" entre as suas medidas técnicas.

Para o resto da revisão de segurança, consulta a lista de verificação de segurança de 25 pontos para ferramentas de teste A/B.

Lista de verificação para a revisão de segurança

Documenta estes pontos na tua análise de qualquer ferramenta de testes A/B:

  • Os requisitos de CSP do fornecedor estão documentados, por diretiva.
  • Os domínios em script-src e connect-src foram retirados da documentação atual do fornecedor, com a data em que foram verificados.
  • O motivo para unsafe-eval está documentado, caso a ferramenta o exija.
  • As rotas que permitem unsafe-eval estão listadas, e as rotas que não permitem também estão listadas.
  • As páginas de login, conta e pagamento mantêm a política estrita.
  • A política foi executada em modo Report-Only antes da aplicação, e os relatórios foram revistos.
  • A regra interna sobre quem pode publicar JavaScript personalizado em variantes está documentada.
  • frame-src e frame-ancestors são verificados em relação às funcionalidades do editor da ferramenta.
  • A decisão é revista quando o fornecedor altera os seus domínios ou quando os experimentos passam para novas rotas.

Fala sobre CSP com a nossa equipa

Traz a tua Content Security Policy para a demo e planeia quais as rotas que vão correr experimentos.

Perguntas frequentes sobre CSP e testes A/B

A Varify funciona com nonces ou hashes?

Nonces e hashes cobrem código que é conhecido quando a página é enviada. O código do experimento é criado mais tarde e executado em tempo real. A documentação da Varify afirma: "No, technically speaking, creating and delivering experiments isn't possible without unsafe-eval." Ver Strict CSP does not allow unsafe evaluation.

Podemos permitir unsafe-eval apenas em algumas páginas?

Sim. A CSP pode ser configurada de forma diferente para cada rota, de modo a que unsafe-eval seja permitido apenas nas páginas que executam experimentos, mantendo-se a política estrita em todo o resto.

Quais domínios da Varify pertencem à nossa CSP?

A lista atual está na documentação da Varify em Content Security Policy error. Ela é mantida apenas lá, para que a tua configuração siga sempre uma única fonte.

Por que o editor visual precisa de frame-src?

Algumas funcionalidades do editor mostram a tua página dentro de um frame ou abrem um frame por cima dela. Dependendo de como uma ferramenta faz isto, a tua CSP tem de permitir o frame em frame-src, ou permitir que a tua página seja colocada num frame em frame-ancestors. Qual a funcionalidade da Varify que precisa destas entradas, e quais os valores a definir, está listado na documentação de CSP.

O que um revisor de segurança deve documentar sobre unsafe-eval?

O motivo pelo qual é necessário, as rotas onde é permitido, as rotas onde não é, o período de Report-Only e os seus resultados, e a regra interna sobre quem pode publicar JavaScript personalizado em variantes. Revê a decisão novamente quando os experimentos forem movidos para novas rotas.