Chiavi di accesso con restrizioni
Le chiavi di accesso con restrizioni consentono alle applicazioni client autorizzate di accedere a una vista di catalogo privata. Solo le richieste che contengono un token firmato valido da una chiave assegnata possono recuperare i dati del catalogo. Tutte le altre richieste vengono negate, comprese quelle di acquirenti anonimi, di acquirenti a cui non è stato dato esplicitamente accesso a questa vista catalogo e di script che esaminano l’API.
Casi d’uso chiave di accesso limitati
In Adobe Commerce Optimizer, Price Book ID determina i prezzi visualizzati da una richiesta, ovvero i prezzi, non chi può effettuare la richiesta. Qualsiasi cliente che conosce l’ID di una vista catalogo e l’ID di un listino prezzi può recuperare tali dati tramite l’API Merchandising. Le chiavi di accesso con restrizioni aggiungono un controllo separato e complementare: definiscono gli utenti che possono accedere a una visualizzazione di catalogo, indipendentemente dal listino prezzi dedicato.
Le chiavi di accesso con restrizioni sono comunemente utilizzate per:
- Determinazione prezzi B2B basata su contratto: limitare una visualizzazione di catalogo collegata a un listino prezzi dedicato in modo che solo l’acquirente a cui si applica possa eseguire query. Le altre organizzazioni di acquisto e il pubblico non possono.
- Portali per partner e rivenditori - Limita un sottoinsieme del catalogo ai partner approvati che si integrano direttamente con l’API Merchandising.
- Anteprime pre-release: consente a un sistema interno o partner attendibile di visualizzare in anteprima i prodotti in arrivo prima che siano visibili pubblicamente.
Funzionamento delle chiavi di accesso con restrizioni
Una chiave ad accesso limitato è il componente pubblico di una coppia di chiavi RSA. L’applicazione client genera e utilizza questa chiave per dimostrare di essere autorizzata a leggere una vista di catalogo privata. In questo contesto, per “applicazione client” si intende il sistema back-end che autentica gli acquirenti, ad esempio una logica personalizzata su Adobe Commerce o un back-end di terze parti, mai il front-end storefront stesso.
I passaggi seguenti descrivono come una coppia di chiavi e un token firmato passano dalla creazione alla convalida:
- L’applicazione client genera una coppia di chiavi RSA e mantiene la chiave privata.
- La chiave public in Commerce Optimizer è stata registrata come chiave ad accesso limitato.
- L’applicazione client firma un token web JSON (JWT) con la chiave privata e lo include con ogni richiesta a una vista di catalogo privata.
- Commerce Optimizer convalida la firma del token in base alla chiave pubblica registrata e, se valida, restituisce i dati del catalogo richiesti.
Creare una chiave di accesso con restrizioni
Per il test iniziale delle visualizzazioni del catalogo privato, generare una coppia di chiavi utilizzando uno strumento quale OpenSSL. Mantieni segreta la chiave privata: solo la chiave pubblica viene caricata in Commerce Optimizer.
openssl genrsa -out private-key.pem 2048
openssl rsa -in private-key.pem -pubout -out public-key.pem
La dimensione della chiave deve essere compresa tra 2048 e 8192 bit. public-key.pem contiene il valore incollato nel campo Public key di seguito.
Aggiungi una chiave di accesso con restrizioni a Commerce Optimizer
-
Dal menu a sinistra di Adobe Commerce Optimizer Studio, vai a Store setup e fai clic su Restricted access keys.
-
Fare clic su Add Restricted Access Key.
-
Immetti i dettagli chiave:
- Title - Etichetta per identificare la chiave, visualizzata nell’elenco delle chiavi e nel selettore delle chiavi di visualizzazione del catalogo, ad esempio
ACME Corp wholesale portal — Tier 1 pricing. - Expiration date - Data e ora (UTC) dopo le quali la chiave non viene più rispettata, anche per un token non ancora scaduto.
- Public key: la chiave pubblica RSA con codifica PEM in formato SPKI (Subject Public Key Info), inclusi i marcatori
-----BEGIN PUBLIC KEY-----e-----END PUBLIC KEY-----. Deve essere univoco in tutto l’ambiente.
- Title - Etichetta per identificare la chiave, visualizzata nell’elenco delle chiavi e nel selettore delle chiavi di visualizzazione del catalogo, ad esempio
-
Fare clic su Save.
Le chiavi non sono modificabili dopo la creazione. Per modificare un valore, elimina la chiave e creane una nuova. Vedere Ruotare una chiave per eseguire questa operazione senza interrompere l’accesso.
Assegnare una chiave a una vista catalogo
Una chiave di accesso con restrizioni limita l’accesso solo dopo che è stata assegnata a una visualizzazione catalogo con Catalog Protection abilitato. Consulta Proteggere una vista catalogo per i passaggi di configurazione.
Eliminare una chiave
-
Nella pagina Restricted access keys trovare la chiave che si desidera rimuovere e fare clic su Delete.
Se la chiave viene assegnata a una o più visualizzazioni catalogo, un avviso spiega che le applicazioni client che si basano su tale chiave perdono l’accesso. Le visualizzazioni del catalogo rimangono protette, non diventano accessibili al pubblico.
-
Conferma l’eliminazione.
Ruotare una chiave
Per ruotare una chiave senza interrompere l’accesso, tieni presente che a una vista catalogo possono essere assegnate fino a tre chiavi alla volta:
- Genera una nuova coppia di chiavi e aggiungi la nuova chiave pubblica come nuova chiave ad accesso limitato.
- Assegna la nuova chiave alla vista catalogo insieme alla chiave esistente.
- Inizia a firmare nuovi token con la nuova chiave privata per completare il rollover della chiave.
- Una volta confermate tutte le applicazioni client sulla nuova chiave, rimuovi ed elimina la chiave precedente.
Limiti
Vedi Visualizzazioni catalogo e limiti dei criteri.
Altri argomenti correlati
- Visualizzazioni catalogo privato—Scopri come proteggere una visualizzazione catalogo con chiavi di accesso limitato.