Autorizzazioni e autenticazione spiegate

Informazioni su questo documento

Pandectes GDPR Compliance aiuta il tuo store a rispettare gli obblighi in materia di privacy, consenso e accessibilità nelle diverse regioni del mondo. Per farlo, l'app richiede un insieme definito di autorizzazioni Shopify, note come access scopes.

Questo documento spiega, in modo semplice, ogni autorizzazione richiesta dall'app: per cosa Shopify utilizza ciascuna autorizzazione e come la utilizza Pandectes. Descrive poi come l'app viene installata e autenticata, perché le autorizzazioni sono configurate in questo modo e come puoi verificare di persona l'uso che ne viene fatto.

L'obiettivo è la massima trasparenza. Non serve alcuna conoscenza tecnica di come è costruita l'app; spieghiamo semplicemente cosa chiediamo e perché.

Come Pandectes gestisce i tuoi dati

Prima di passare alle singole autorizzazioni, è utile comprendere un principio che vale per l'intera app:

• Nessuna archiviazione interna dei dati dei tuoi clienti o dei tuoi ordini. Pandectes non conserva i dati dei tuoi clienti o dei tuoi ordini nel proprio database.
• Consultazioni, non copie. Quando una funzionalità ha bisogno di verificare qualcosa (ad esempio, confermare che un indirizzo email appartiene a un cliente, oppure che un'email e un ID ordine corrispondono a un ordine reale), Pandectes esegue una consultazione tramite i propri server applicativi e utilizza solo il risultato di quel controllo.
• La persistenza resta all'interno di Shopify. Quando un record deve davvero essere salvato (ad esempio una richiesta di recesso UE registrata), viene scritto nell'archivio di Shopify e collegato all'ordine pertinente, anziché essere conservato da Pandectes.

Questo approccio di minimizzazione dei dati è il motivo per cui diverse autorizzazioni qui sotto sono descritte come "solo consultazioni".

Come Pandectes viene installata e autenticata

Pandectes utilizza la Shopify managed installation, il metodo moderno che Shopify consiglia per installare le app e mantenerne aggiornate le autorizzazioni.

Con la managed installation, è Shopify stesso a occuparsi dell'installazione dell'app e dell'applicazione di eventuali modifiche alle autorizzazioni, senza farti passare per ulteriori schermate di autorizzazione. Per te questo significa installazioni e aggiornamenti più rapidi e fluidi, senza reindirizzamenti di pagina, schermate che sfarfallano o richieste di consenso ripetute. Dietro le quinte, l'app ottiene token di accesso di breve durata tramite il token exchange sicuro di Shopify, invece dei vecchi flussi basati sui reindirizzamenti.

Una caratteristica fondamentale della managed installation è che un'app dichiara l'insieme completo delle autorizzazioni che può utilizzare in un'unica configurazione centrale che invia a Shopify. Shopify applica poi questa configurazione in modo coerente a ogni store che installa l'app. Pandectes non richiede, e con questo modello non può richiedere, un insieme di autorizzazioni diverso e scelto manualmente per ogni singolo store.

Perché le autorizzazioni sono dichiarate in modo centralizzato

È una scelta architetturale deliberata e lavora a tuo favore in diversi modi:

• Un'unica configurazione coerente e verificabile. Ogni store utilizza Pandectes con lo stesso insieme di autorizzazioni esaminato. Non ci sono variazioni da store a store da tenere sotto controllo, il che rende il comportamento dell'app prevedibile e facile da comprendere per te, per Pandectes e per Shopify.
• Attivazione immediata delle funzionalità, senza attriti. Pandectes è modulare: il cookie banner, l'accessibility widget, le Data Subject Requests, Do Not Sell My Data e l'EU Withdrawal Button possono essere attivati o disattivati in qualsiasi momento. Poiché le autorizzazioni necessarie sono già presenti, attivare un modulo funziona subito: nessuna reinstallazione, nessuna nuova schermata di autorizzazione e nessuna interruzione per il tuo storefront.
• Un'autorizzazione concessa non è un'autorizzazione utilizzata. Il fatto che un'autorizzazione sia stata concessa significa solo che l'app può usarla, se e quando abiliti la funzionalità correlata. Un'autorizzazione che appartiene a un modulo che non hai attivato rimane semplicemente inattiva. Insieme al principio di minimizzazione dei dati descritto sopra, questo significa che Pandectes legge o scrive solo ciò di cui una funzionalità attiva ha effettivamente bisogno.

Quindi, se ad esempio non hai abilitato l'EU Withdrawal Button, le autorizzazioni relative agli ordini ad esso associate restano inutilizzate finché non decidi di abilitare quella funzionalità.

Esaminate e convalidate da Shopify

L'insieme di autorizzazioni richiesto da Pandectes non è scelto arbitrariamente e non può essere modificato di nascosto. Ogni autorizzazione è esaminata e confermata da Shopify nel contesto di due programmi a cui Pandectes partecipa:

• Shopify Plus Partner. Pandectes è un Shopify Plus Partner riconosciuto, uno status che Shopify concede a partner selezionati e affermati che rispettano i suoi standard di qualità, competenza e affidabilità.
• Built for Shopify. Pandectes GDPR Compliance ha ottenuto la designazione Built for Shopify, il massimo livello di riconoscimento delle app di Shopify, assegnato solo alle app che soddisfano i suoi rigorosi requisiti di qualità, prestazioni, sicurezza e gestione responsabile dei dati.

Poiché Pandectes partecipa a entrambi i programmi, le autorizzazioni descritte in questo documento sono state esaminate e convalidate da Shopify rispetto ai propri standard pubblicati, e qualsiasi modifica a ciò che l'app richiede è soggetta alla stessa revisione. In breve, l'accesso richiesto da Pandectes è sottoposto agli standard di Shopify e non è stabilito a esclusiva discrezione di Pandectes, in modo da garantire il rispetto di tutti gli standard applicabili.

Puoi verificare come vengono utilizzate le autorizzazioni

Shopify offre una schermata di gestione per ogni app installata nell'admin del tuo store. Da lì puoi esaminare le autorizzazioni esatte concesse a Pandectes e vedere se ciascuna è stata effettivamente utilizzata, inclusa l'informazione se una determinata autorizzazione sia mai stata utilizzata nel tuo store. Poiché è il modo più chiaro per confermare che l'accesso reale dell'app corrisponde a quanto descritto qui, la sezione "Understanding Shopify's 'Manage app' screen" più sotto illustra esattamente cosa mostra e come corrisponde alle autorizzazioni di questo documento.

Autorizzazioni richieste da Pandectes

Qui sotto trovi tutte le autorizzazioni richieste da Pandectes, raggruppate per finalità. Per ciascuna troverai la definizione di Shopify dell'autorizzazione insieme a una spiegazione di come la utilizza Pandectes.

Una nota sulle autorizzazioni "write": su Shopify, un'autorizzazione write_ in genere concede anche l'accesso in lettura corrispondente per la stessa risorsa. Per questo motivo potresti non vedere autorizzazioni "read" separate per contenuti, file, temi o metaobject: l'autorizzazione write corrispondente copre già la lettura. Nei casi in cui Pandectes ha bisogno solo di leggere una risorsa (ad esempio, controllare il tuo theme.liquid), lo fa senza modificare nulla.

Gruppo 1: consenso e applicazione delle regole di privacy regionali

Queste autorizzazioni permettono al cookie banner di applicare il corretto comportamento di consenso e di passare i segnali di consenso ai tuoi altri strumenti.

write_privacy_settings
Definizione di Shopify. Accesso alle impostazioni di privacy dello store e alla configurazione del cookie banner (PrivacySettings, CookieBanner).

Come la utilizza Pandectes. Configura le impostazioni di privacy regionali del tuo store, definendo quali regioni del mondo richiedono il consenso e quali no. È essenziale affinché il cookie banner si comporti correttamente in ciascuna regione, in modo che le regole appropriate (come il GDPR nello SEE/UE e il CPRA/CCPA in California) vengano applicate a ogni visitatore.

write_pixels
Definizione di Shopify. Accesso alla Web Pixels API per creare e gestire un web pixel.

Come la utilizza Pandectes. Registra i Web Pixels che permettono alle integrazioni di Pandectes, come Google Consent Mode, di funzionare in modo coerente lungo l'intero percorso del cliente: lo storefront (pre-checkout), il checkout e la pagina di ringraziamento post-checkout.

Gruppo 2: posizionare Pandectes sul tuo storefront

Queste autorizzazioni permettono all'app di aggiungere le proprie funzionalità al tuo store e di fornire risorse di supporto, restando entro i metodi consigliati da Shopify.

write_content
Definizione di Shopify. Accesso ai contenuti dell'online store come Pages, Blogs, Articles e Comments.

Come la utilizza Pandectes. Crea le pagine dello storefront che ospitano i blocchi dell'app, come le pagine Cookie Declaration, Data Subject Request, Do Not Sell My Data ed EU Withdrawal, così non devi crearle e collegarle a mano.

write_files
Definizione di Shopify. Accesso ai File generici nell'archiviazione file dello store.

Come la utilizza Pandectes. Carica risorse di supporto nell'area Files del tuo store, in modo che vengano distribuite tramite la CDN di Shopify, veloce e altamente resiliente. Queste risorse includono i loghi utilizzati nel cookie banner e nell'accessibility widget, e il file pandectes-rules.js che contiene le regole dell'auto-blocker di Pandectes.

write_themes
Definizione di Shopify. Accesso ai file e agli asset del tema dell'online store (OnlineStoreTheme).

Come la utilizza Pandectes. Utilizzata in modo volutamente limitato. Negli store moderni legge principalmente il tuo theme.liquid per rilevare se gli app embed del cookie banner e dell'accessibility widget sono attivi, e viene utilizzata per ripulire gli asset che le versioni precedenti dell'app avevano aggiunto al tema. In linea con il programma Built for Shopify, a cui Pandectes partecipa, l'app non crea, modifica né elimina più gli asset del tema.

write_script_tags
Definizione di Shopify. Accesso agli oggetti ScriptTag, che caricano script sullo storefront.

Come la utilizza Pandectes. Mantenuta principalmente per compatibilità. Nei temi "vintage" più vecchi che non supportano Online Store 2.0, gli script tag sono l'unico modo disponibile per aggiungere il codice dello storefront di cui l'app ha bisogno. Negli store moderni, Pandectes distribuisce il proprio cookie banner e il proprio accessibility widget tramite app embed (il metodo consigliato da Shopify), quindi in pratica questa autorizzazione è ora utilizzata soprattutto per rimuovere gli script tag legacy e sostituirli con app embed quando uno store viene migrato. Come per gli asset del tema, il programma Built for Shopify non consente alle app di aggiungere script tag, quindi negli store moderni Pandectes non li crea; questa autorizzazione serve solo per compatibilità legacy e pulizia.

Gruppo 3: moduli per i diritti sulla privacy (Data Subject Requests ed EU Withdrawal)

Queste autorizzazioni supportano le funzionalità che permettono ai tuoi acquirenti di esercitare i propri diritti. I dati qui sono consultati, non memorizzati da Pandectes; quando un risultato deve essere salvato, viene scritto in Shopify.

read_customers
Definizione di Shopify. Accesso ai record dei clienti e ai relativi dati di Segment, Company e Company Location.

Come la utilizza Pandectes. Alimenta il modulo Data Subject Requests (DSR). Quando un visitatore esercita un diritto sulla privacy, che sia il diritto di accesso e portabilità dei dati, il diritto di rettifica o il diritto alla cancellazione ("diritto all'oblio"), Pandectes consulta l'indirizzo email da lui fornito per confermare se appartiene a un cliente del tuo store, prima di avviare il processo di verifica. Il modulo è disponibile sia come app block che puoi aggiungere a qualsiasi pagina, sia come customer-account extension mostrata nell'area degli account cliente quando la abiliti. Si tratta di sole consultazioni; Pandectes non memorizza questi dati dei clienti.

read_orders
Definizione di Shopify. Accesso a Orders, Fulfillments, Order Transactions e Abandoned Checkouts (per impostazione predefinita, quelli degli ultimi 60 giorni).

Come la utilizza Pandectes. Alimenta l'EU Withdrawal Button. Un acquirente che desidera recedere da un acquisto inserisce il proprio indirizzo email e l'ID ordine, e Pandectes verifica che questa combinazione corrisponda a un ordine reale prima di consentire alla richiesta di recesso di procedere.

read_all_orders
Definizione di Shopify. Estende l'accesso agli ordini oltre la finestra predefinita di 60 giorni di Shopify. Questa autorizzazione viene concessa solo dopo una revisione dedicata di Shopify e viene utilizzata insieme a read_orders.

Come la utilizza Pandectes. Estende l'EU Withdrawal Button in modo che possa verificare anche gli ordini effettuati più di 60 giorni prima, poiché i diritti di recesso possono applicarsi ad acquisti meno recenti. Amplia soltanto l'intervallo di tempo della stessa verifica degli ordini descritta sopra e non introduce alcun nuovo utilizzo dei dati degli ordini.

write_metaobject_definitions
Definizione di Shopify. Accesso per creare e modificare le definizioni dei metaobject, che descrivono la struttura di un metaobject.

Come la utilizza Pandectes. Definisce la struttura dei dati utilizzata dall'EU Withdrawal Button, in particolare lo schema per registrare che per un ordine è stato richiesto un recesso o un reso. Stabilire questa struttura è ciò che permette di memorizzare la richiesta in modo nativo in Shopify e di associarla all'ordine pertinente.

write_metaobjects
Definizione di Shopify. Accesso per creare e modificare i record dei metaobject che seguono la struttura definita.

Come la utilizza Pandectes. Crea i singoli record sulla base della definizione sopra. Quando un acquirente completa una richiesta di recesso, Pandectes la registra come metaobject collegato all'ordine, segnalando all'interno di Shopify che è stato richiesto un recesso o un reso. Come per tutti i dati di Pandectes, viene memorizzato in Shopify, non in un database di Pandectes.

Understanding Shopify's "Manage app" screen

Shopify mostra una schermata "Manage app" per ogni app installata nel tuo admin, ed è il modo più diretto per verificare a cosa può accedere Pandectes e cosa ha effettivamente utilizzato. La schermata raggruppa l'accesso dell'app sotto le etichette di alto livello di Shopify, che corrispondono direttamente alle autorizzazioni descritte in precedenza in questo documento.

Activity and permissions vs. unused access

Shopify separa l'accesso dell'app in due elenchi:

• Activity and permissions: le aree che l'app ha utilizzato di recente, insieme a quando sono state utilizzate l'ultima volta.
• Unused access: le aree a cui l'app può accedere ma che non ha utilizzato negli ultimi 30 giorni.

Le aree che compaiono in ciascun elenco dipendono dalle funzionalità di Pandectes che hai abilitato. È il principio "un'autorizzazione concessa non è un'autorizzazione utilizzata" reso visibile: un'autorizzazione legata a una funzionalità che non hai attivato si trova semplicemente sotto Unused access. Ad esempio, uno store che non ha attivato i moduli Data Subject Requests o EU Withdrawal vedrà tipicamente le aree Customers e Orders (e, se non è attiva alcuna integrazione basata su pixel, Store analytics) elencate come inutilizzate.

La tabella seguente associa ogni etichetta di area mostrata da Shopify alle autorizzazioni Pandectes sottostanti:

L'etichetta "All order history" mostrata accanto a Orders riflette l'autorizzazione read_all_orders, che permette all'EU Withdrawal Button di verificare gli ordini più vecchi della finestra predefinita di 60 giorni di Shopify.

Privacy: i dati personali a cui questa app può accedere

La stessa schermata elenca le categorie di dati personali a cui l'app può accedere, e Shopify mostra qui una conferma che Pandectes rispetta i suoi requisiti di gestione dei dati e di privacy.

Sotto Customers, vedrai due categorie:

• Sensitive data (Name and Email address). Sono utilizzati dai moduli Data Subject Requests ed EU Withdrawal Button e derivano dall'autorizzazione read_customers. Sono dati che Pandectes richiede esplicitamente, perché verificare l'identità di un acquirente è essenziale per queste funzionalità basate sui diritti. Come indicato in precedenza, i dati vengono consultati, non memorizzati da Pandectes.
• Device and activity data (Geolocation, IP address, Browser and operating system, Browsing behavior, and Client ID cookie). Questi accompagnano il Web Pixel (write_pixels). Sono dichiarati automaticamente da Shopify per qualsiasi app che utilizza un web pixel e non sono dati che Pandectes richiede o raccoglie esplicitamente per i propri scopi.

Sotto Staff and contributors, Shopify elenca i dati relativi al proprietario dello store e ai collaboratori del blog (come nome, indirizzo email e indirizzo IP). Queste voci sono aggiunte automaticamente da Shopify per ogni app e non sono specifiche di Pandectes.

Riferimento rapido

Riferimenti e ulteriori letture

Questa sezione raccoglie le fonti autorevoli alla base delle normative che questa app ti aiuta a rispettare, insieme alla documentazione ufficiale di Shopify che regola come l'app viene installata e a cosa può accedere.

Riferimenti normativi

• Diritto di recesso UE, Direttiva (UE) 2023/2673, che modifica la Direttiva sui diritti dei consumatori (2011/83/UE). Sebbene riguardi principalmente i contratti di servizi finanziari a distanza, aggiunge un nuovo Articolo 11a alla Direttiva sui diritti dei consumatori che richiede una funzione di recesso online ("pulsante di recesso") chiaramente visibile e facile da usare. Si applica ai contratti a distanza conclusi tramite un'interfaccia online (sito web, app o portale clienti) ovunque esista un diritto di recesso legale di 14 giorni, senza estendere i diritti di recesso né modificare le eccezioni esistenti. Il principio è che recedere da un contratto online deve essere almeno tanto semplice quanto stipularlo, e l'obbligo riguarda anche le aziende extra-UE che rivolgono le loro attività ai consumatori UE. Gli Stati membri dovevano recepirla nel diritto nazionale entro il 19 dicembre 2025, con le norme che si applicano dal 19 giugno 2026.
• Sintesi in linguaggio semplice: https://eur-lex.europa.eu/EN/legal-content/summary/consumer-information-right-of-withdrawal-and-other-consumer-rights.html
• Testo ufficiale: https://eur-lex.europa.eu/eli/dir/2023/2673/oj/eng
• GDPR, Regolamento (UE) 2016/679. Il Regolamento generale sulla protezione dei dati dell'UE, che stabilisce i diritti degli interessati come accesso, portabilità dei dati, rettifica e cancellazione ("diritto all'oblio").
• Testo ufficiale: https://eur-lex.europa.eu/eli/reg/2016/679/oj/eng
• Sintesi in linguaggio semplice: https://eur-lex.europa.eu/EN/legal-content/summary/general-data-protection-regulation-gdpr.html
• Direttiva ePrivacy, Direttiva 2002/58/CE, come modificata dalla Direttiva 2009/136/CE (la modifica sui "cookie"). Disciplina la privacy nel settore delle comunicazioni elettroniche, incluso l'obbligo di ottenere il consenso prima di memorizzare o accedere a cookie non essenziali sul dispositivo di un utente.
• Direttiva 2002/58/CE: https://eur-lex.europa.eu/eli/dir/2002/58/oj/eng
• Versione consolidata (inclusa la modifica del 2009): https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX%3A02002L0058-20091219
• Direttiva modificativa 2009/136/CE: https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=celex:32009L0136

Documentazione Shopify

• Shopify API access scopes: https://shopify.dev/docs/api/usage/access-scopes
• Enable Shopify-managed installations for your app: https://shopify.dev/docs/apps/build/authentication-authorization/app-installation
• Managing access scopes: https://shopify.dev/docs/apps/build/authentication-authorization/app-installation/manage-access-scopes
• Token exchange (how embedded apps obtain access tokens): https://shopify.dev/docs/apps/build/authentication-authorization/access-tokens/token-exchange
• Web Pixels API: https://shopify.dev/docs/api/web-pixels-api
• Protected customer data requirements: https://shopify.dev/docs/apps/launch/protected-customer-data

Programmi di qualità di Shopify

• Built for Shopify overview: https://shopify.dev/docs/apps/launch/built-for-shopify
• Built for Shopify requirements: https://shopify.dev/docs/apps/launch/built-for-shopify/requirements

Questo documento descrive le autorizzazioni richieste da Pandectes GDPR Compliance e come vengono utilizzate. Se hai domande su una qualsiasi autorizzazione, o desideri confermarne l'utilizzo, puoi consultare in qualsiasi momento la schermata di gestione dell'app nel tuo admin Shopify.

Aggiornato il: 20/10/2026