- Una Content Security Policy (CSP) indica al browser quali sorgenti una pagina può caricare ed eseguire. Uno strumento di A/B testing coinvolge quattro direttive: script-src, connect-src, frame-src e frame-ancestors.
- Gli esperimenti vengono definiti dopo che la pagina è stata pubblicata, quindi il loro codice non è noto quando viene scritta la CSP. Gli hash e i nonce coprono solo codice noto in anticipo. Per questo motivo gli strumenti che eseguono JavaScript personalizzato delle varianti a runtime richiedono
unsafe-evalin script-src. - Varify richiede
unsafe-evalin script-src affinché il JavaScript definito dall'utente possa essere eseguito all'interno delle varianti. La CSP può essere configurata per singola route, in modo cheunsafe-evalsi applichi solo dove vengono eseguiti gli esperimenti. - Attiva la CSP prima in modalità Report-Only, controlla i report, poi applicala. L'elenco dei domini Varify si trova nella documentazione Varify, in un unico punto.
Una Content Security Policy è un header HTTP che limita quali script, connessioni e frame una pagina può utilizzare. È una delle difese più efficaci contro il cross-site scripting, e molti team di sicurezza la rendono obbligatoria per ogni sito web pubblico. Uno strumento di A/B testing deve adattarsi a questa policy, perché carica uno script, comunica con i propri server e modifica la pagina mentre è in esecuzione.
Questa pagina è la pagina di riferimento per una revisione di sicurezza: quali direttive sono coinvolte, perché gli esperimenti a runtime richiedono unsafe-eval, e come mantenere questa eccezione il più limitata possibile. I domini esatti richiesti da Varify sono elencati nella documentazione Varify sotto Content Security Policy error; questa pagina rimanda a quell'elenco e non lo ripete, così esiste un'unica fonte da mantenere aggiornata.
Perché gli strumenti di A/B testing incontrano CSP rigorose
Una CSP rigorosa presuppone che ogni script di una pagina sia noto al momento del deploy. La policy elenca le fonti consentite oppure fissa ogni script inline con un hash o un nonce. Tutto il resto viene bloccato.
Uno strumento di A/B testing lato client funziona al contrario. Il tuo team crea un esperimento nell'editor dello strumento, spesso giorni dopo che la pagina è stata pubblicata. L'esperimento può modificare testi, sostituire immagini, spostare elementi o eseguire JavaScript personalizzato. Quel codice raggiunge il browser del visitatore a runtime, come parte della configurazione dell'esperimento, e lo script di testing lo esegue lì.
Ne derivano tre conseguenze per la CSP:
- La fonte dello script di testing stesso deve essere consentita in script-src.
- Le richieste inviate dallo script, ad esempio per caricare le configurazioni degli esperimenti o segnalare eventi, devono essere consentite in connect-src.
- Il codice che esiste solo a runtime non può essere fissato in anticipo da un hash o un nonce. Eseguirlo richiede un'eccezione in script-src.
Lo stesso vincolo vale per qualsiasi strumento che esegue nel browser JavaScript personalizzato delle varianti tramite funzioni di tipo eval.
Quali direttive sono coinvolte
Quattro direttive determinano se uno strumento di A/B testing funziona nella tua CSP. La colonna Varify rimanda alla documentazione, dove sono conservate le voci esatte.
| Direttiva | Cosa controlla per uno strumento di A/B testing | Voce Varify |
|---|---|---|
script-src | Caricamento dello script di testing ed esecuzione del codice degli esperimenti a runtime | Vedi la documentazione, incluso unsafe-eval |
connect-src | Richieste dallo script ai server del fornitore, ad esempio configurazioni degli esperimenti ed eventi | Vedi la documentazione |
frame-src | Frame che lo strumento apre sulla tua pagina, ad esempio per le funzionalità dell'editor | Vedi la documentazione |
frame-ancestors | Se la tua pagina può essere mostrata all'interno di un frame, ad esempio dalle funzionalità dell'editor | Vedi la documentazione |
Altre due direttive possono essere rilevanti a seconda di cosa fanno i tuoi esperimenti: img-src se le varianti caricano immagini da una nuova fonte, e style-src se le varianti aggiungono stili. Verificale in base agli esperimenti che il tuo team intende eseguire.
Perché gli esperimenti a runtime richiedono unsafe-eval
Una CSP offre due modi per consentire uno script specifico senza consentire tutto: un hash del contenuto dello script, oppure un nonce, un valore casuale che il server imposta per ogni risposta e ripete su ogni tag di script consentito. Entrambi funzionano solo per codice che il server conosce quando invia la pagina.
Il codice degli esperimenti non soddisfa questa condizione. Viene scritto nello strumento di testing, consegnato come dati e trasformato in codice eseguibile nel browser. Né un hash né un nonce possono essere calcolati in anticipo per esso. Quando questo passaggio usa eval o funzioni simili, il browser lo consente solo se script-src contiene unsafe-eval.
La documentazione di Varify è esplicita a riguardo:
- "È necessario anche il valore unsafe-eval nella direttiva script-src."
- "Nota: la voce unsafe-eval è necessaria affinché il JavaScript definito dall'utente possa essere eseguito all'interno delle varianti."
- "No, tecnicamente parlando, creare e distribuire esperimenti non è possibile senza
unsafe-eval."
La spiegazione completa si trova nell'articolo della documentazione Strict CSP does not allow unsafe evaluation. Ai fini della tua revisione, la domanda rilevante è quindi fino a che punto si estende l'eccezione.
Come limitare il rischio
unsafe-eval amplia ciò che uno script sulla pagina può fare. L'obiettivo della revisione è mantenere questo ampliamento il più ridotto possibile. Tre misure lavorano insieme:
- Una CSP per ogni route. La CSP può essere configurata in modo diverso per ogni route, così che
unsafe-evalsi applichi solo dove vengono eseguiti gli esperimenti, ad esempio sulle pagine prodotto e landing page. Mantieni la policy rigorosa sulle pagine di login, account e pagamento. Una policy per route restringe dove si applica l'eccezione; le pagine della stessa origine possono comunque raggiungersi a vicenda, quindi non sostituisce le altre due misure. - Prima Report-Only. Invia la nuova policy come
Content-Security-Policy-Report-Onlyper un periodo di traffico normale. Il browser segnala le violazioni senza bloccare nulla. Correggi la policy finché i report mostrano solo ciò che ti aspetti, poi passa all'headerContent-Security-Policyche applica le restrizioni. Esegui il periodo Report-Only abbastanza a lungo da coprire gli esperimenti che il tuo team ha in programma, perché una pagina senza un esperimento in corso non mostra ciò di cui un esperimento ha bisogno. - Controlla cosa entra negli esperimenti. Decidi internamente chi può pubblicare varianti con JavaScript personalizzato, e rivedi quel codice prima che vada live. L'eccezione CSP è sicura solo quanto lo è il processo per il codice che la utilizza.
Varify offre anche il contesto first-party nel piano Enterprise: "First-party context (CNAME): consegna lo script Varify dal tuo stesso sottodominio per prestazioni migliori e meno blocchi." La configurazione è descritta nella pagina su first-party context (CNAME).
I requisiti CSP di Varify
I domini e i valori delle direttive di cui Varify ha bisogno sono mantenuti in un unico posto, la documentazione Varify. Usa questi due articoli per la tua configurazione:
- Content Security Policy error: l'elenco dei domini per direttiva, incluso il valore
unsafe-evalin script-src. - Strict CSP does not allow unsafe evaluation: perché gli esperimenti ne hanno bisogno, e come configurare la CSP per rotta.
Il DPA di Varify elenca "Provision of data via encrypted connections such as SFTP or HTTPS" tra le sue misure tecniche.
Per il resto della revisione di sicurezza, vedi la checklist di sicurezza in 25 punti per gli strumenti di A/B testing.
Checklist per la revisione di sicurezza
Documenta questi punti nella revisione di qualsiasi strumento di A/B testing:
- I requisiti CSP del fornitore sono documentati, per ogni direttiva.
- I domini in
script-srceconnect-srcsono presi dalla documentazione attuale del fornitore, con la data in cui l'hai verificata. - Il motivo di
unsafe-evalè documentato, se lo strumento lo richiede. - Le route che consentono
unsafe-evalsono elencate, così come le route che non lo consentono. - Le pagine di login, account e pagamento mantengono la policy rigorosa.
- La policy è stata eseguita in modalità
Report-Onlyprima dell'applicazione, e i report sono stati esaminati. - La regola interna su chi può pubblicare JavaScript personalizzato nelle varianti è messa per iscritto.
frame-srceframe-ancestorssono verificati rispetto alle funzionalità dell'editor dello strumento.- La decisione viene rivista quando il fornitore cambia i propri domini o quando gli esperimenti passano a nuove route.
Parla di CSP con il nostro team
Porta la tua Content Security Policy alla demo e pianifica quali route eseguiranno esperimenti.