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, incluse quelle di acquirenti a cui non è stato dato esplicitamente l’accesso a questa vista catalogo e gli script che esaminano l’API.
Il provisioning delle chiavi di accesso con restrizioni può avvenire 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 integrate con Adobe Commerce Optimizer Connector for B2B, il connettore esegue il provisioning e assegna la chiave iniziale. Quindi gestisci le chiavi e l’assegnazione delle chiavi dall’amministratore di Commerce. Vedi Autenticazione della vista catalogo nella Guida dell’amministratore di Commerce*.
-
Manualmente, per qualsiasi vista catalogo. Per proteggere autonomamente una vista catalogo, ad esempio per un portale partner o per un’anteprima pre-release, seguire i passaggi descritti in questo argomento a partire da Creare una chiave di accesso con restrizioni.
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. Per i cataloghi condivisi B2B, viene impostato automaticamente. Consulta Gestione chiavi e rotazione.
- 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, l’applicazione client fa riferimento al sistema di back-end che autentica gli acquirenti, ad esempio la 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 per le viste catalogo che non fanno parte di un catalogo condiviso B2B.
- 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 è stata 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 autentica l’accesso solo dopo che è stato assegnato a una vista 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.
Gestione delle chiavi e rotazione
Le chiavi di accesso con restrizioni vengono gestite in due modi, a seconda di come si utilizza la protezione del catalogo:
-
Automaticamente, per i 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, il servizio genera e assegna automaticamente la prima chiave di accesso con restrizioni al momento della creazione di una visualizzazione catalogo. Ogni vista catalogo ha la propria chiave. Successivamente, puoi gestire ogni chiave dalle pagine Catalogo condiviso o Account aziendale. Puoi anche visualizzare e gestire le chiavi dalla pagina Amministratore Commerce Chiavi di accesso con restrizioni (Sistema > Trasferimento dati). Consulta Gestire la configurazione della visualizzazione del catalogo.
Ogni combinazione di un catalogo condiviso e di una visualizzazione archivio a cui è assegnato viene proiettata come una visualizzazione catalogo separata. Una proiezione è costituita dalla vista catalogo, dai criteri, dal riferimento del listino prezzi e dai dati di configurazione con chiave di accesso limitato che il connettore esporta in Adobe Commerce Optimizer per tale combinazione. Pertanto, un catalogo condiviso assegnato a più visualizzazioni dello store produce più visualizzazioni del catalogo, ciascuna con la propria chiave. Modifica o ruota una chiave per una vista catalogo senza influire sulle altre.
Le chiavi hanno per impostazione predefinita un periodo di scadenza lungo. Se devi ruotare una chiave, aggiungi il sostituto nell’amministratore e mantieni entrambi attivi fino a quando non rimuovi quello vecchio. Vedi Modifiche al catalogo condiviso B2B.
-
Manualmente, per qualsiasi vista catalogo. Per le viste catalogo non associate a un catalogo condiviso B2B nel backend di Adobe Commerce, la generazione di chiavi, la firma dei token e la rotazione sono gestite interamente dall’applicazione client backend che autentica gli acquirenti. Adobe Commerce Optimizer non genera o ruota queste chiavi per tuo conto. Utilizzare i passaggi precedenti in questo argomento per creare, aggiungere ed eliminare chiavi. Per ruotare una chiave, vedere Ruotare una chiave.
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.
- Modifiche al catalogo condiviso B2B: scopri come Adobe Commerce Optimizer Connector automatizza la gestione delle chiavi per i cataloghi condivisi B2B.