API Headless Identity: Estensione del flusso guest headless in un flusso utente denominato
Quando si completa un flusso guest headless nell'app esterna alla piattaforma, si ottiene un token di accesso basato su JWT guest con l'ID visitatore univoco dell'utente (UVID) all'interno. Per inserire l'UVID e tutto il contesto associato in una sessione utente denominata, è possibile passare l'UVID in un nuovo flusso di autorizzazione, ad esempio un flusso di accesso o registrazione headless.
Versioni (Edition) richieste
| Disponibile in: Salesforce Classic (non in tutte le organizzazioni) e Lightning Experience |
| Disponibile nelle versioni: Enterprise Edition, Unlimited Edition e Developer Edition |
Mantenendo il contesto per gli utenti, è possibile rendere disponibili nell'app funzionalità avanzate. Ad esempio, si supponga di ospitare un'app di e-commerce all'esterno della piattaforma Salesforce. Nell'app, gli utenti devono effettuare l'accesso per salvare e acquistare articoli. Si desidera attirare più acquirenti rendendo possibile salvare gli articoli in un carrello senza eseguire l'accesso. Con il flusso utente guest, si configura l'app per generare un UVID che identifica in modo univoco l'utente prima che esegua l'accesso. Con alcune modifiche all'app, gli utenti possono ora esplorare i prodotti e salvare articoli nel carrello senza eseguire l'accesso. Quando passano ad acquistare gli articoli, l'app richiede loro di eseguire l'accesso o registrarsi. Durante il processo di accesso, l'app passa l'UVID in una versione utente denominata del flusso Codice di autorizzazione e credenziali. Poiché l'UVID è legato al carrello, l'utente può vedere gli articoli salvati nel carrello dopo aver eseguito l'accesso, con un'esperienza utente ottimizzata.
È possibile applicare lo stesso processo ad altri casi d'uso, ad esempio il consenso per i cookie. Ad esempio, un utente visita 'app e accetta un banner di consenso per i cookie, creando un altro cookie. È possibile collegare questo cookie all'UVID e utilizzarlo per memorizzare informazioni sull'utente, ad esempio le sue preferenze di consenso e l'avvenuta accettazione del banner. Quando l'utente effettua l'accesso, è possibile portare avanti l'UVID e ricordare le sue preferenze, creando un'esperienza più personalizzata e meno confusa.
Tramite il contesto per gli utenti guest, è possibile avere un quadro completo dell'intero percorso all'interno dell'app, dalla prima visita alla registrazione. Con l'assistenza di uno strumento di analisi delle app, queste informazioni possono aiutare a capire quali tipi di esperienze preferiscono gli utenti e quali determinano la creazione di account.
È possibile passare l'UVID a tutte le variazioni del flusso Codice di autorizzazione e credenziali e del flusso server Web OAuth 2.0. Questi flussi condividono uno schema comune del tipo di grant codice di autorizzazione OAuth 2.0, in cui l'app richiede un codice di autorizzazione da Salesforce e lo scambia con un token di accesso. Di seguito è riportato un elenco completo dei flussi utente denominato in cui è possibile utilizzare un UVID.
- Accesso nome utente-password headless con il flusso Codice di autorizzazione e credenziali
- Flusso Registrazione headless
- Flusso Accesso senza password headless
- Flusso server Web
- Flusso server Web ibrido
- Flusso token di aggiornamento app ibrida
Solo i primi tre flussi possono essere utilizzati in modalità headless. Pertanto, se si desidera mantenere l'implementazione headless, evitare le variazioni del flusso server Web.
Questo diagramma mostra una panoramica generale di come passare un token di accesso basato su JWT con UVID in un flusso di autorizzazione utente denominato.
- Nel momento in cui viene avviato il diagramma, il flusso guest è già stato completato. Ad esempio, l'utente ha esplorato l'app ma non ha ancora eseguito l'accesso. L'utente ha una sessione guest collegata al valore UVID restituito nel token di accesso basato su JWT (1).
- L'utente guest decide di registrarsi o eseguire l'accesso. Ad esempio, vuole acquistare qualcosa, quindi l'app gli chiede di registrarsi. Oppure fa clic su un pulsante per cui è necessario accedere a dati protetti, ad esempio la cronologia degli ordini (2).
- L'app ha il valore UVID della sessione guest, per cui, quando l'utente esegue l'accesso, passa l'UVID in un flusso di autorizzazione utente denominato, ad esempio l'accesso headless con il flusso Codice di autorizzazione e credenziali. Per passare il flusso UVID, l'app dispone di tre opzioni.
- Includere un token di accesso basato su JWT guest con un UVID nell'intestazione
Uvid-Hint. Per i token emessi dal flusso guest, l'UVID è nella richiesta dell'oggetto (sub). - Includere un valore UVID normale nell'intestazione del
Uvid-Hint - Includere un valore UVID normale nel parametro del corpo del
uvid-hint
- Includere un token di accesso basato su JWT guest con un UVID nell'intestazione
- Salesforce completa il flusso utente denominato ed emette un token di accesso basato su JWT con l'UVID. A differenza di un token guest, in cui l'UVID è nella richiesta oggetto, il token utente denominato ha l'UVID nella richiesta per conto di (
obo). In un token basato su JWT per utente denominato, la richiesta dell'oggetto contiene il nome utente. A questo punto, l'UVID è stato mantenuto dal momento in cui l'utente ha visitato l'app per la prima volta fino a quando ha eseguito l'accesso (4). - L'app riceve il token di accesso con l'UVID (5).
- L'utente denominato è ora connesso e richiede l'accesso ai dati Salesforce protetti (6).
- Con il token di accesso basato su JWT, l'utente può accedere alle risorse Salesforce protette (7).
