Come proteggere immagini specifiche da download non autorizzati e scraping

Dietro le quinte: come Selective Image Guard protegge le tue immagini

Nel mondo digitale di oggi, i contenuti visivi di un creatore sono spesso il suo bene più prezioso. Che tu sia un fotografo, un designer o un blogger, le immagini che produci sono parte integrante del tuo brand e del tuo sostentamento. Tuttavia, sono anche incredibilmente vulnerabili a usi non autorizzati, scraping e veri e propri furti. Proteggere il tuo lavoro non è più solo un’opzione, è una necessità.

Anche se nessuna tecnica lato client può offrire una protezione al 100% contro un attaccante determinato, puoi implementare un forte deterrente per fermare la maggior parte degli utenti occasionali e dei bot automatici. In questo articolo ti mostrerò come il plugin WordPress Selective Image Guard fa esattamente questo. Esploreremo il codice che sta dietro a una difesa a più livelli, da un’impostazione personalizzata della libreria multimediale a una furba manipolazione degli URL e al rilevamento degli screenshot in tempo reale. Vediamo come è stata costruita una guardia per le tue immagini.


Un’immagine protetta in azione

Prima di immergerci nel codice, ecco un’immagine dimostrativa protetta con il plugin. Puoi vedere come l’immagine appare normalmente finché non provi a eseguire un’azione protetta, e a quel punto entrano in azione le difese del plugin.

Sotto il cofano: come funziona il plugin Selective Image Guard

Analizziamo il codice di Selective Image Guard per vedere come protegge le immagini del tuo sito.


Il costruttore: il controllore principale

Il cuore del plugin è la classe SELEIMGU_Image_Protector
Il suo metodo costruttore__construct() viene chiamato automaticamente quando il plugin viene caricato e il suo compito principale è configurare tutti gli hook (azioni e filtri) che fanno funzionare il plugin.


public function __construct() {
    add_action('send_headers', [$this, 'protect_image']);
    // ... other hooks ...
    if( is_admin() ) {
        // ... admin hooks ...
    }
    else{
        // ... front-end hooks ...
    }
}
        

Nota il controllo if ( is_admin() ). Questo permette al plugin di caricare funzionalità diverse a seconda che l’utente si trovi nella bacheca di WordPress (l’area di amministrazione) o nella parte pubblica del sito.


Parte 1: il lato admin (aggiungere la casella di controllo)

Lato admin, il compito del plugin è semplice: darti un modo per selezionare quali immagini proteggere.

  • add_media_library_checkbox(): Questa funzione usa il filtro attachment_fields_to_edit per inserire un nuovo campo con casella di controllo direttamente nella schermata di modifica delle immagini della libreria multimediale. È un ottimo modo per integrare nuove opzioni nell’interfaccia di WordPress.
  • save_attachment_fields(): Quando salvi le modifiche a un’immagine, questa funzione viene attivata dal filtro attachment_fields_to_save. Controlla se la casella “Protect this image” è stata spuntata e salva quello stato nel database usando update_post_meta. È così che WordPress ricorda la tua scelta.
How to protect an image from unauthorized downloads

 

Parte 2: la protezione front-end

È qui che avviene la magia. Sul front-end, il plugin usa un ingegnoso sistema di filtri per modificare il modo in cui vengono caricate le immagini protette.

  • filter_image_url(), filter_image_src(), and filter_image_attrs(): Queste funzioni sono agganciate ai filtri immagine del core di WordPress. Il loro scopo è cambiare l’URL dell’immagine da qualcosa come yoursite.com/uploads/my-image.jpg a un URL personalizzato che il plugin può controllare, come yoursite.com/protect-image/?sig-prot=1&id=123. Il parametro di query sig-prot aggiunto funge da chiave per segnalare che questa immagine è protetta. Il parametro id indica al plugin quale immagine cercare.
  • protect_image(): Questa è la parte più cruciale della protezione. È agganciata a send_headers, che viene eseguito molto presto nel processo della richiesta. Prima ancora che WordPress provi a trovare una pagina da mostrare, questa funzione controlla se esiste il parametro di query sig-prot. In caso affermativo, la funzione carica un file PHP separato (inc/protect-image.php) che si occupa di servire direttamente il contenuto dell’immagine in modo sicuro. L’exit finale impedisce a WordPress di provare a caricare una pagina normale e garantisce che venga servita solo l’immagine. Una volta stampata l’immagine, possiamo fermare il parser PHP.

Parte 3: il file `protect-image.php`

Questo file è il custode finale della sicurezza. È quello che si occupa effettivamente di servire il file dell’immagine al browser, ma solo dopo una serie di controlli rigorosi per assicurarsi che la richiesta sia legittima. Vediamo i passaggi chiave:


<?php
defined('ABSPATH') || exit; // Prevent direct access

$referer = isset( $_SERVER['HTTP_REFERER'] ) ? sanitize_text_field( wp_unslash( $_SERVER['HTTP_REFERER'] ) ) : false;
$home_url = get_home_url();

if ( 
    ( ! $referer || empty($referer) || strpos( $referer, $home_url ) !== 0 )
    || ( ! isset( $_GET['id'] ) || empty( $_GET['id'] ) ) // phpcs:ignore WordPress.Security.NonceVerification
    || ( ! isset( $_SERVER['HTTP_SEC_FETCH_DEST'] ) || sanitize_text_field( wp_unslash( $_SERVER['HTTP_SEC_FETCH_DEST'] ) ) !== 'image' ) // phpcs:ignore WordPress.Security.NonceVerification
    || ( isset( $_SERVER['[HTTP_SEC_FETCH_MODE]'] ) && sanitize_text_field( wp_unslash( $_SERVER['[HTTP_SEC_FETCH_MODE]'] ) ) === 'navigate' ) // phpcs:ignore WordPress.Security.NonceVerification
) {
    header( 'HTTP/1.0 403 Forbidden' );
    wp_die( 'Direct access not allowed', 403 );
}
$image_id = sanitize_text_field( wp_unslash( $_GET['id'] ) ); // phpcs:ignore WordPress.Security.NonceVerification
// Get the full file path
$file_path = get_attached_file( $image_id );
if( isset( $_GET['size_slug'] ) && ! empty( $_GET['size_slug'] ) ) {
    $size_slug = sanitize_text_field( wp_unslash( $_GET['size_slug'] ) ); // phpcs:ignore WordPress.Security.NonceVerification
    $info = pathinfo( $file_path );
    $file_path = $info['dirname'] . '/' . $info['filename'] . $size_slug . '.' . $info['extension'];
}
if ( file_exists( $file_path ) ) {
    if( ! function_exists( 'WP_Filesystem' ) ) {
        require_once( ABSPATH . 'wp-admin/includes/file.php' );
    }
    global $wp_filesystem;
    WP_Filesystem();
    // Send headers
    status_header( 200 );
    header( 'Selective-Image-Guard: Protected' );
    header( 'Content-Type: ' . mime_content_type( $file_path ) );
    header( 'Content-Length: ' . filesize( $file_path ) );
    header( 'Expires: Thu, 01 Jan 1970 00:00:00 GMT' ); // Expired in the past
    header( 'Cache-Control: no-store, no-cache, must-revalidate, max-age=0' );
    header( 'Cache-Control: post-check=0, pre-check=0', false ); // for IE
    header( 'Pragma: no-cache'); // HTTP 1.0
    // Output the image content
    echo $wp_filesystem->get_contents( $file_path ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped
    exit;
}
        

Il primo compito di questo script è eseguire una serie di controlli di sicurezza per impedire accessi non autorizzati. I controlli più importanti sono:

  • Controllo dell’hotlinking: Verifica che la richiesta provenga dal tuo sito esaminando l’header **HTTP Referer**. Se il referer non è il tuo dominio, la richiesta viene bloccata.
  • Header della richiesta del browser: Ispeziona header come HTTP_SEC_FETCH_DEST per confermare l’intento del browser. Questo impedisce a un utente di digitare semplicemente l’URL protetto direttamente nella barra degli indirizzi.

Se uno qualsiasi di questi controlli fallisce, lo script invia immediatamente un header **403 Forbidden** e termina. Se i controlli vengono superati, lo script procede a:

  • Individuare il file: Usando l’ID dell’immagine ed eventuali informazioni opzionali sulla dimensione, costruisce il percorso completo del file dell’immagine sul server.
  • Impostare gli header di sicurezza: Invia al browser specifici header HTTP, tra cui i corretti Content-Type e Content-Length. Soprattutto, imposta degli **header no-cache** per assicurarsi che l’immagine non venga mai memorizzata nella cache, garantendo che tutte le richieste future per l’immagine passino attraverso lo script di sicurezza.
  • Restituire l’immagine: Infine, usa il filesystem di WordPress per leggere il contenuto del file dell’immagine e restituirlo direttamente al browser, completando la consegna sicura.

Funzionalità bonus: JavaScript e caching

Il plugin include anche alcune funzionalità ingegnose per assicurarsi che funzioni senza intoppi.

  • Rilevamento di JavaScript: Le funzioni inject_detection_script() e remove_body_class() sono un bel trucco. Aggiungono una speciale classe CSS (image-protector-no-script) al body della pagina. Poi viene iniettato un piccolo snippet JavaScript per rimuovere quella classe. Se JavaScript è disabilitato, la classe rimane, e si può usare una regola CSS per nascondere le immagini protette oppure un tag <noscript> per reindirizzare l’utente.
  • Prevenzione dei problemi di cache: La funzione prevent_caching_issues() gestisce i potenziali problemi con i plugin di cache più popolari.
  • Slug della dimensione dell’immagine: La funzione get_image_size_slug() è un helper che capisce in modo intelligente se l’immagine richiesta è una miniatura o un’immagine a dimensione intera, permettendo al plugin di servire la versione corretta.

Conclusione

Il plugin Selective Image Guard è un potente esempio di come usare gli hook e i filtri di WordPress per costruire un sistema di protezione robusto e selettivo. Separando la logica rivolta all’utente da quella del backend e usando il filtraggio degli URL, offre una solida difesa contro l’hotlinking senza sacrificare l’esperienza utente.

Se hai domande su una funzione specifica o su come estendere le funzionalità del plugin, fammelo sapere!

Nota importante

Questo plugin offre un **deterrente**, non una soluzione a prova di errore. Nessuna tecnica lato client può offrire una protezione al 100% contro un attaccante determinato.
Perché questo plugin funzioni correttamente con una CDN, devi escludere dalla cache tutti gli URL che contengono il parametro sig-prot=1.
Perché **Selective Image Guard** funzioni correttamente, qualsiasi meccanismo di cache sul tuo sito (compresa la cache del browser, del server e della CDN, come Cloudflare, Varnish, ecc.) deve **escludere gli URL che contengono `/protect-image/` e `sig-prot=1`**. Questi URL devono essere serviti direttamente dal tuo server senza essere memorizzati nella cache.

Pronto a proteggere le tue immagini?

Combinando una potente sicurezza lato server con un intelligente script front-end, il plugin **Selective Image Guard** offre una difesa robusta e a più livelli contro il furto e lo scraping delle immagini. Hai visto come funziona il codice dietro le quinte per darti il controllo sui tuoi preziosi contenuti visivi.

Ora è il momento di mettere quel potere nelle tue mani. Puoi scaricare il plugin e iniziare a proteggere le immagini del tuo sito già oggi.

Il plugin si può scaricare cliccando sul pulsante qui sotto…

2 commenti su “Come proteggere immagini specifiche da download non autorizzati e scraping”

I commenti sono chiusi.