- 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-evalem script-src. - A Varify exige
unsafe-evalem 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 queunsafe-evalse 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.
| Diretiva | O que controla numa ferramenta de testes A/B | Entrada Varify |
|---|---|---|
script-src | Carregar o script de testes e executar o código do experimento em tempo real | Ver documentação, incluindo unsafe-eval |
connect-src | Pedidos do script aos servidores do fornecedor, por exemplo configurações de experimentos e eventos | Ver documentação |
frame-src | Frames que a ferramenta abre na tua página, por exemplo para funcionalidades do editor | Ver documentação |
frame-ancestors | Se a tua página pode ser exibida dentro de um frame, por exemplo por funcionalidades do editor | Ver 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:
- Uma CSP por rota. A CSP pode ser configurada de forma diferente para cada rota, de modo a que
unsafe-evalse 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. - Primeiro em Report-Only. Envia a nova política como
Content-Security-Policy-Report-Onlydurante 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çalhoContent-Security-Policyaplicado. 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. - 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:
- Content Security Policy error: a lista de domínios por diretiva, incluindo o valor
unsafe-evalem script-src. - Strict CSP does not allow unsafe evaluation: por que os experimentos precisam dele, e como configurar a CSP por rota.
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-srceconnect-srcforam retirados da documentação atual do fornecedor, com a data em que foram verificados. - O motivo para
unsafe-evalestá documentado, caso a ferramenta o exija. - As rotas que permitem
unsafe-evalestã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-Onlyantes da aplicação, e os relatórios foram revistos. - A regra interna sobre quem pode publicar JavaScript personalizado em variantes está documentada.
frame-srceframe-ancestorssã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.