Protezione del sito e servizi esterni

Mappe, video o pagamenti bloccati dopo un aggiornamento della sicurezza: cosa verificare

Scorri per leggere la guida
Un tecnico e la titolare verificano una pagina web su un monitor nel negozio

Dopo una modifica alle protezioni del sito, il riquadro della mappa resta vuoto, un video non parte o il pagamento non completa il caricamento. Una possibile causa è la Content Security Policy, abbreviata CSP: regole che indicano al browser quali risorse e operazioni sono consentite nella pagina. Il sintomo, però, non basta per attribuire il problema a quella configurazione.

Questa guida aiuta a raccogliere gli indizi, distinguere le regole coinvolte e organizzare una correzione con il tecnico. Se il problema dipende dalla scelta del consenso consulta anche la guida al cookie banner che blocca il sito; se compare solo con un’estensione, quella ai problemi con AdBlock. Sono verifiche complementari, non cause intercambiabili.

In breve

Associa il componente bloccato a un messaggio preciso del browser, identifica la policy effettivamente applicata e correggi la direttiva pertinente. Collauda in un ambiente di prova e conserva le restrizioni utili, senza autorizzare indiscriminatamente ogni origine.

  • Raccogliere pagina, azione e messaggio di blocco prima di cambiare le regole.
  • Distinguere script, connessioni e contenuti incorporati.
  • Controllare le policy inviate da applicazione, server e CDN.
  • Provare l’intero percorso, compresi errori e conferme del servizio esterno.
Passaggio 01

Collegare il problema a una prova e a un messaggio preciso

Annota quando è iniziato il difetto e quali modifiche sono state pubblicate: plugin di sicurezza, impostazioni dell’hosting, CDN o integrazione esterna. Conserva la pagina e la sequenza che lo riproduce. Un pagamento può aprirsi correttamente e bloccarsi soltanto dopo la scelta di un metodo, quindi il primo caricamento non basta a escludere il problema.

Chiedi al tecnico di leggere console e richieste di rete del browser. Un messaggio che cita una violazione della Content Security Policy è un indizio specifico; un errore generico, una risposta 403 o una chiave API rifiutata richiedono altre verifiche. La guida MDN alla CSP descrive lo scopo di queste regole e come vengono applicate.

Raccogli il messaggio con la direttiva e l’origine coinvolta, evitando di diffondere registri completi contenenti dati dei clienti. Il confronto utile è tra un’azione osservata e la regola che interviene, non tra due screenshot di un riquadro vuoto.

Passaggio 02

Distinguere il tipo di risorsa che il browser sta bloccando

Un servizio esterno può richiedere codice, connessioni e un riquadro incorporato. Autorizzare una sola parte può lasciare ferme le altre. Il tecnico deve associare il messaggio alla direttiva pertinente, usando la documentazione dell’integrazione e gli indirizzi realmente necessari.

Direttive da distinguere nella diagnosi
DirettivaAmbito da verificare
script-srcCaricamento ed esecuzione degli script
connect-srcConnessioni avviate da interfacce come fetch
frame-srcOrigini dei contenuti caricati nei frame
frame-ancestorsPagine autorizzate a incorporare il documento

MDN documenta separatamente script-src e connect-src. Non basta aggiungere un dominio alla prima per permettere automaticamente le richieste governate dalla seconda. Conserva l’elenco delle origini con il loro scopo e verifica quelle di test e produzione senza trattarle come equivalenti.

Passaggio 03

Trovare dove vengono definite le regole effettive

La configurazione può essere inviata dall’applicazione, dal server o da un servizio intermedio. Chiedi di controllare la risposta ricevuta dal browser sulla pagina interessata, non soltanto il pannello in cui qualcuno ricorda di aver inserito la regola. Una copia in cache o un’impostazione della CDN può far arrivare una configurazione diversa da quella attesa.

La documentazione MDN dell’header CSP chiarisce che più policy applicate possono restringere ulteriormente ciò che è consentito. Una seconda regola più permissiva non annulla automaticamente la prima. Occorre quindi conoscere tutti i punti che contribuiscono alla risposta.

Prepara una consegna con responsabile, posizione della configurazione e procedura di aggiornamento. Se il tema aggiunge una dichiarazione nella pagina mentre l’hosting invia un header, registra entrambe le fonti e le loro differenze. Intervenire nel punto sbagliato può dare l’impressione che la correzione non funzioni e portare ad accumulare ulteriori eccezioni.

Passaggio 04

Capire chi sta impedendo l’incorporamento di una pagina

Per un video, una mappa o un sistema di prenotazione incorporato, distingui due direzioni. La policy del tuo sito può limitare quali origini caricare nel riquadro attraverso frame-src. Il documento esterno può invece stabilire chi è autorizzato a incorporarlo attraverso frame-ancestors.

Se è il fornitore a vietare l’incorporamento, ampliare le regole del tuo sito non supera quel divieto. Verifica di usare l’indirizzo e la modalità di integrazione supportati: un normale collegamento pubblico non è necessariamente progettato per essere inserito in un frame.

Controlla inoltre domini di prova, sottodomini e cambio dell’indirizzo del sito. Alcune integrazioni richiedono una configurazione del dominio autorizzato nel servizio esterno. Documenta la modifica con il fornitore e prova il percorso previsto. Se l’incorporamento non è disponibile, valuta un collegamento esplicito al servizio, mantenendo chiaro al cliente che sta proseguendo altrove.

Passaggio 05

Preparare una modifica mirata senza cancellare le protezioni

La consegna al tecnico dovrebbe indicare funzione da ripristinare, origine necessaria e direttiva coinvolta. Evita di copiare una policy generica trovata online: potrebbe non descrivere le dipendenze del sito o autorizzare risorse che l’attività non usa. Per script inseriti direttamente nella pagina, la soluzione può richiedere anche modifiche al codice o al modo in cui viene autorizzato.

Usa la documentazione aggiornata del servizio per riconoscere le risorse legittime. Non aggiungere automaticamente ogni indirizzo comparso in console: alcune richieste possono provenire da estensioni del browser o da componenti non più necessari. Distingui il difetto riproducibile del sito dagli elementi aggiunti all’ambiente di prova.

Prepara il cambiamento in uno staging configurato per i test, conservando la versione precedente delle regole. Per pagamenti e prenotazioni, usa modalità e dati di prova supportati. La verifica deve ripristinare la funzione mantenendo una configurazione comprensibile e gestibile da chi seguirà gli aggiornamenti.

Passaggio 06

Usare le segnalazioni per valutare una policy prima di applicarla

Quando si prepara una nuova policy, il tecnico può valutarne il comportamento attraverso la modalità di sola segnalazione, chiamata Report-Only. Questa modalità osserva le violazioni della policy proposta senza applicarne i blocchi. Deve essere configurata e interpretata nel contesto del sito, con un destinatario per le segnalazioni quando previsto.

Una policy in osservazione non disattiva una policy già applicata. Se il componente è bloccato dalle regole attive, aggiungere un header Report-Only non lo ripristina. La distinzione è essenziale quando si confrontano segnalazioni di una configurazione futura e guasti presenti.

Organizza le segnalazioni per pagina, direttiva e componente, cercando ricorrenze coerenti con i test. Definisci chi le esamina e quali percorsi devono essere verificati prima del rilascio. Raccogliere avvisi senza un responsabile non sostituisce il collaudo e può lasciare inosservato proprio il passaggio commerciale più importante.

Passaggio 07

Verificare il servizio fino alla conferma finale

Dopo la modifica, ripeti il percorso originario sulla configurazione pubblicata. Per la mappa verifica interazione e indicazioni; per il video avvio e comandi; per un pagamento prova, con le modalità concordate, il passaggio fino allo stato registrato dell’ordine. La sola scomparsa dell’errore in console non dimostra che tutti i passaggi funzionino.

  • La pagina riceve le regole previste da server e CDN.
  • La risorsa necessaria viene caricata senza eccezioni indiscriminate.
  • Le funzioni dipendenti dal consenso rispettano le scelte effettuate.
  • Errori e annullamenti del servizio producono messaggi comprensibili.
  • La configurazione e la procedura di ripristino sono documentate.

Controlla anche un visitatore nuovo e i browser coinvolti nelle segnalazioni. Mantieni questa prova dopo aggiornamenti del fornitore o delle protezioni. Se il pagamento presenta ancora un esito incerto, segui la verifica di pagamento e ordine non allineati prima di chiedere una nuova operazione al cliente.

Domande frequenti

Un riquadro vuoto indica sempre un blocco CSP?

No. Può dipendere anche da consenso, credenziali del servizio, rete, dimensioni del contenitore o estensioni. Serve collegare il sintomo a un messaggio specifico del browser e alla risorsa coinvolta.

Posso risolvere autorizzando tutti i domini?

Non è una correzione mirata. Occorre identificare le origini necessarie, la direttiva corretta e le indicazioni del fornitore, verificando il percorso senza eliminare indiscriminatamente le restrizioni utili.

Report-Only sblocca un pagamento fermato dalla CSP?

No. Una policy Report-Only osserva la configurazione proposta senza applicarne i blocchi, ma non annulla una policy attiva. Il blocco presente va ricondotto alle regole effettivamente applicate e corretto in quel punto.

Fonti e approfondimenti

Riferimenti ufficiali per verificare le indicazioni e applicarle al proprio sito.

Ripristiniamo le integrazioni con regole verificate.

Analizziamo i blocchi del browser, individuiamo le configurazioni coinvolte e collaudiamo le modifiche fino al funzionamento del servizio esterno.

Scopri come possiamo intervenire sul tuo sito

Parliamo del tuo sitoUn primo confronto chiaro, senza impegno e con un referente dedicato.