Visualizzazioni di cataloghi privati
Per impostazione predefinita, una visualizzazione catalogo è pubblica. Limita l’accesso a una vista catalogo in modo che solo le richieste con un token firmato valido possano recuperare i relativi dati.
Una vista catalogo diventa privata in uno dei due modi seguenti:
-
[Private Beta]{class="badge yellow" title="Richiede l’estensione B2B del connettore Adobe Commerce Optimizer, attualmente in versione beta privata."} Automaticamente, per i cataloghi condivisi B2B. Per le distribuzioni Commerce che utilizzano l’integrazione Adobe Commerce Optimizer Connector con l’estensione B2B, le visualizzazioni del catalogo privato vengono create e configurate automaticamente, in base alla configurazione del catalogo condiviso in Adobe Commerce. Vedi Visualizzazioni automatiche di cataloghi privati per cataloghi condivisi B2B.
-
Manualmente, per qualsiasi vista catalogo. Per limitare l’accesso a una vista catalogo che sarebbe altrimenti pubblica, inclusa una vista catalogo B2C, seguire la procedura descritta in Proteggere una vista catalogo. Consulta Casi d’uso con chiave di accesso limitato per esempi, come portali per partner e anteprime pre-release.
La protezione del catalogo si applica solo alla vista catalogo selezionata. Non modifica i criteri o i livelli della vista. La visualizzazione è limitata a un singolo listino prezzi dedicato. Vedere Limitazione del listino prezzi dedicato alle visualizzazioni di cataloghi privati.
Comprendere il limite di protezione
La protezione del catalogo si applica solo alla visualizzazione del catalogo in cui è abilitata. Protegge le richieste di cataloghi e di ricerca ma non modifica i criteri o i livelli della visualizzazione, non protegge altre visualizzazioni di catalogo né protegge le operazioni di carrello, pagamento o ordine.
Il back-end Commerce connesso deve applicare in modo indipendente l’idoneità all’acquisto.
Limitazione del listino prezzi dedicato alle visualizzazioni di cataloghi privati
Una vista catalogo privata può fare riferimento a un solo listino prezzi dedicato. Questo differisce da una vista catalogo pubblica, che può utilizzare più listini prezzi.
Quando Catalog Protection è abilitato, il selettore del listino prezzi nel modulo di visualizzazione catalogo passa da un controllo a selezione multipla a un controllo a selezione singola (pulsante di opzione).
- Se si abilita Catalog Protection in una visualizzazione catalogo a cui sono assegnati più listini prezzi, non sarà possibile salvare la visualizzazione fino a quando non si rimuove tutti i listini prezzi tranne uno.
- Se in precedenza è stata salvata una vista catalogo privata con più assegnazioni del listino prezzi dedicato prima dell’esistenza di questa restrizione, la configurazione della vista catalogo non viene modificata automaticamente. Tuttavia, alla successiva modifica della vista, è necessario rimuovere tutti i listini prezzi tranne uno prima di poter salvare gli aggiornamenti.
In ciascuno di questi casi, Adobe Commerce Optimizer visualizza il seguente messaggio di convalida: A protected catalog view can use only one price book. Select 'Single price book only' to continue.
Le visualizzazioni del catalogo pubblico non sono interessate da questa restrizione e possono continuare a fare riferimento a più listini prezzi.
Visualizzazioni automatiche di cataloghi privati per cataloghi condivisi B2B
[Private Beta]{class="badge yellow" title="Richiede l’estensione B2B del connettore Adobe Commerce Optimizer, attualmente in versione beta privata."}
Per le distribuzioni integrate con Adobe Commerce Optimizer Connector for B2B per il supporto di cataloghi condivisi, l’estensione crea e configura automaticamente le visualizzazioni del catalogo privato, in base alla configurazione del catalogo condiviso in Adobe Commerce. Questa configurazione include la vista catalogo, il criterio, una chiave di accesso con restrizioni iniziale e un riferimento al listino prezzi dedicato. Con questa configurazione, puoi gestire le chiavi di accesso con restrizioni dalla pagina Amministratore Commerce Chiavi di accesso con restrizioni (Sistema > Trasferimento dati). Per informazioni dettagliate, vedere Modifiche al catalogo condiviso B2B nella Guida all’integrazione Adobe Commerce Optimizer Connector.
Se non si utilizzano cataloghi condivisi B2B, ad esempio per proteggere una visualizzazione di catalogo per un portale partner o per l’anteprima pre-release, utilizzare le istruzioni in Proteggi una visualizzazione di catalogo per configurarne manualmente una.
Proteggere una vista catalogo
Prima di iniziare, crea una chiave ad accesso limitato dalla chiave pubblica generata dall’applicazione client.
-
Nella visualizzazione del catalogo creare o modificare il modulo, impostare Catalog Protection su Enabled.
-
In Restricted Access Keys, selezionare fino a tre chiavi di accesso con restrizioni da assegnare a questa visualizzazione catalogo.
-
Fare clic su Save catalog view.
La vista catalogo è ora protetta. Solo le richieste contenenti un token firmato valido da una chiave assegnata possono recuperarne i dati.
note NOTE Attendere fino a cinque minuti per rendere effettive le modifiche alla configurazione di Protezione catalogo.
Verificare che l’accesso sia applicato
Per confermare che una vista del catalogo privato rifiuta le richieste non autorizzate, chiama il relativo endpoint GraphQL con e senza un token firmato, utilizzando le intestazioni seguenti:
AC-View-IDAC-Price-Book-IDAC-Catalog-View-Access-TokenUna richiesta senza un token valido restituisce un errore GraphQL invece dei dati di catalogo, ad esempio:
{
"errors": [
{
"message": "Access key validation failed: Missing token",
"extensions": { "x-commerce-exception": "access-key-invalid" }
}
]
}
Una richiesta con un token firmato da una chiave assegnata e non scaduta restituisce i dati del catalogo come previsto. Per informazioni dettagliate sulla firma di un JWT e sulla chiamata all’API Merchandising, consulta la documentazione per gli sviluppatori.
Gestire le chiavi di accesso con restrizioni
Se Catalog Protection è abilitato e tutte le chiavi assegnate scadono, la visualizzazione del catalogo diventa inaccessibile. Gli storefront che si basano su questa vista catalogo non possono fornire dati da essa. Assegna una nuova chiave non scaduta per ripristinare l’accesso. Per istruzioni, vedere Ruotare le chiavi.
Altri argomenti correlati
- Visualizzazioni catalogo: scopri come le visualizzazioni catalogo organizzano il catalogo prodotti per struttura aziendale, criteri e prezzi.
- Chiavi di accesso limitate—Creare, assegnare e ruotare le chiavi utilizzate per firmare i token per la protezione del catalogo.