Componente predefinito di autenticazione

Il componente predefinito di autenticazione raccoglie informazioni dall'utente per raggiungere il livello di autenticazione richiesto. Questo componente copre i requisiti di autenticazione comuni, ma non esclusivi, al settore dei servizi finanziari (FSI). Utilizza i componenti predefiniti Raccolta della data di scadenza della carta di credito, Raccolta della data di nascita e Raccolta del numero di telefono per raccogliere e convalidare i dettagli dell'utente.

Livelli di autenticazione

I diversi componenti predefiniti richiedono più livelli di autenticazione, con livelli più elevati che richiedono più informazioni sull'utente per l'autenticazione.

Il componente di autenticazione consente all'utente di autenticarsi al livello 0 (corrispondenza ANI), al livello 1 (di base) o al livello 2 (a più fattori), come descritto nella tabella seguente:

Livello di autenticazione	Requisiti
Livello 0: corrispondenza ANI	Autentica l'utente chiamando da un numero di telefono o fornendo un numero di telefono che corrisponde a un account registrato. L'utente può autenticarsi al Livello 0 utilizzando il componente predefinito Saluto.
Livello 1: Di base	Autentica l'utente verificando un codice di password monouso (OTP) inviato al suo indirizzo email o numero di telefono. Se la verifica della OTP non va a buon fine, l'utente può fornire risposte a tre delle quattro domande di sicurezza per autenticarsi correttamente: data di nascita, ultime quattro cifre della carta di debito o data di scadenza della carta di credito dell'utente (a seconda che sia titolare di un conto o di una carta), importo dell'ultima transazione e metodo di pagamento dell'ultima fattura della carta di credito.
Livello 2: a più fattori	Inoltre, autentica l'utente verificando un token di sicurezza generato da un'app di autenticazione esterna o da una notifica push.

Tipi di utenti supportati

Il componente di autenticazione supporta i clienti della banca registrati che sono proprietari dell'account, titolari della carta o entrambi. Il componente supporta anche l'autenticazione per gli utenti che non sono clienti registrati della banca, ma che hanno una procura per i conti registrati presso la banca. L'utente può avere uno o più conti o carte registrati presso la banca.

Tipi di autenticazione

Questo componente ti consente di configurare se l'utente deve essere autenticato come proprietario dell'account, titolare della carta o entrambi. Puoi impostare queste opzioni utilizzando i parametri di input $session.params.account_auth_enabled e $session.params.card_auth_enabled.

Questa tabella descrive il comportamento del componente per diverse combinazioni di valori per i flag di autenticazione dell'account e di autenticazione della carta:

account_auth_enabled	card_auth_enabled	Tipo di autenticazione
true	false	L'utente viene autenticato come proprietario dell'account, verificando che possieda uno o più account presso la banca e confermando le domande di sicurezza, tra cui le ultime quattro cifre della carta di debito registrata.
false	true	L'utente viene autenticato come titolare della carta, verificando che possieda una o più carte di credito presso la banca e confermando le domande di sicurezza, inclusa la data di scadenza della carta di credito per una carta di credito registrata.
true	true	Il componente verifica innanzitutto se l'utente è un proprietario dell'account registrato. Se l'utente ha uno o più account presso la banca, il componente lo autentica utilizzando i dati dell'account. Se l'utente non ha account presso la banca, il componente tenta di autenticarlo utilizzando i dati del titolare della carta.
false	false	Il componente verifica innanzitutto se l'utente è un proprietario dell'account registrato. Se l'utente ha uno o più conti presso la banca, il componente lo autentica con l'autenticazione di livello 0. Se l'utente non ha conti presso la banca, il componente controlla se l'utente è un titolare di carta. Se l'utente possiede una o più carte di credito presso la banca, il componente autentica l'utente con l'autenticazione di livello 0.

Limitazioni

Oltre alle limitazioni comuni dei componenti predefiniti, questo componente predefinito presenta le seguenti limitazioni:

• Le OTP vengono inviate solo a un numero di cellulare o a un indirizzo email registrato in precedenza nell'account. Il componente non utilizza l'OTP per autenticare i clienti che chiamano da un numero di telefono alternativo non registrato nel loro account. Quando chiami da un numero di telefono alternativo, le domande di sicurezza autenticano l'utente.
• Questo componente non cripta i dati.

Finestre di dialogo di esempio

Le seguenti finestre di dialogo di esempio mostrano scenari comuni gestiti da questo componente predefinito. Le finestre di dialogo mostrano il comportamento quando la telefonia chiama il componente, che attiva l'intent di benvenuto predefinito e la prima risposta dell'agente all'inizio della conversazione.

Autenticazione di livello 1 riuscita: OTP

1. Il componente verifica che l'utente sia stato autenticato al Livello 0.
2. Il componente invia una OTP al canale scelto dall'utente.
3. Il componente chiede all'utente di confermare la OTP.
4. L'utente fornisce una OTP valida per l'autenticazione al Livello 1.

Input utente	Risposta dell'agente
	Per motivi di sicurezza, dobbiamo convalidare la tua identità, quindi ti invieremo un codice. Preferisci ricevere il codice via telefono o via email?
Telefono
	Abbiamo inviato un codice al tuo numero di telefono registrato che termina con 0000. L'operazione potrebbe richiedere alcuni secondi. Puoi confermare il codice?
Il codice è 123457
	Grazie, l'autenticazione è riuscita.

Autenticazione di livello 1 riuscita: domande di sicurezza

1. Il componente conferma l'autenticazione di livello 0 dell'utente raccogliendo e verificando il numero di telefono fornito.
2. Il componente richiede e convalida le risposte corrette dell'utente a tre domande di sicurezza, tra cui la data di nascita, le ultime quattro cifre del numero della carta di debito dell'utente e l'importo dell'ultima transazione.
3. L'utente esegue l'autenticazione al livello 1.

Input utente	Risposta dell'agente
	Sei un cliente della nostra banca o hai una procura? Conferma dicendo "Sì" o "No".
Sì
	Ok, dobbiamo raccogliere il tuo numero di telefono per recuperare i dettagli del tuo account.
	L'agente raccoglie il numero di telefono dell'utente utilizzando il componente predefinito Raccolta dei numeri di telefono.
	Ok. Il numero che hai indicato è [phone], è corretto?
Sì
	Ottimo, abbiamo raccolto il numero di telefono. Ok, per motivi di sicurezza abbiamo bisogno di ulteriori informazioni per convalidare la tua identità.
	L'agente raccoglie la data di nascita dell'utente utilizzando il componente predefinito Raccolta della data di nascita.
	Ok, la tua data di nascita è il 3 febbraio 1995, è corretto?
Sì
	Ottimo, abbiamo raccolto la tua data di nascita. Comunicaci le ultime quattro cifre del numero della tua carta di debito.
È 1234
	Comunicaci l'importo in dollari della tua ultima transazione. Ad esempio, se l'importo dell'ultima transazione era di 100,30 $, di' "100".
Era di 500 $.
	Grazie, l'autenticazione è riuscita.

Successo dell'autenticazione di livello 2: autenticazione a due fattori

1. L'utente è stato precedentemente autenticato al livello 1.
2. L'utente genera un token di sicurezza utilizzando l'app della propria banca o l'app di autenticazione.
3. L'utente fornisce il token di sicurezza al componente per l'autenticazione al Livello 2.

Input utente	Risposta dell'agente
	Condividi il tuo token di sicurezza. Genera il token di sicurezza di 6 cifre nell'app della tua banca o nell'app di autenticazione, quindi pronuncia o inserisci le cifre.
232425
	Grazie, l'autenticazione è riuscita.

Negazione di informazioni

1. L'utente rifiuta di fornire le informazioni necessarie per l'autenticazione.
2. Il componente esce con un messaggio di errore.

Input utente	Risposta dell'agente
	Per motivi di sicurezza, dobbiamo convalidare la tua identità, quindi ti invieremo un codice. Preferisci ricevere il codice via telefono o via email?
No, non voglio condividere
	Ok, per motivi di sicurezza avremo bisogno di ulteriori informazioni per convalidare la tua identità.
	L'agente raccoglie la data di nascita dell'utente utilizzando il componente predefinito Raccolta della data di nascita.
	Ok, la tua data di nascita è il 3 febbraio 1995, è corretto?
Sì
	Ottimo, abbiamo raccolto la tua data di nascita. Comunicaci le ultime quattro cifre del numero della tua carta di debito.
È 1234
	Comunicaci l'importo in dollari della tua ultima transazione. Ad esempio, se l'importo dell'ultima transazione era di 100,30 $, di' "100".
Non voglio condividere i dettagli
	Non è stato possibile autenticarti, pertanto non possiamo completare questa azione. Ci scusiamo per gli eventuali disagi arrecati.

Convenzioni di denominazione

Questo componente predefinito utilizza le seguenti convenzioni di denominazione:

Funzionalità	Formato	Esempio
Flow	[Component Name]	Autenticazione
Intent specifico del componente	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_authentication_power_of_attorney
Tipo di entità	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_authentication_payment_mode
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_authentication:telephony_verification

Parametri di input

I parametri di input configurano determinati comportamenti del componente. Una o più condizioni all'interno del flusso utilizzano i parametri per determinare il comportamento del componente. L'utente deve impostare i parametri con ambito flusso nella pagina iniziale del componente, come descritto nella tabella seguente. Il chiamante può impostare parametri con ambito di sessione utilizzando un flusso di chiamata o nella pagina iniziale di questo componente.

Questo componente predefinito accetta i seguenti parametri di input:

Nome parametro	Descrizione	Formato di input
$session.params.auth_level	(Facoltativo) Indica l'attuale livello di autenticazione dell'utente.	integer
$session.params.auth_level_req	Definisce il livello di autenticazione con cui l'utente verrà autenticato. I valori validi sono 0, 1 o 2.	integer
$session.params.account_auth_enabled	Indica se l'utente deve essere autenticato come proprietario dell'account. Il comportamento del componente dipende da questo valore e dal valore di $session.params.card_auth_enabled, come descritto in Livelli di autenticazione.	boolean
$session.params.card_auth_enabled	Indica se l'utente deve essere autenticato come titolare della carta. Il comportamento del componente dipende da questo valore e dal valore di $session.params.account_auth_enabled, come descritto in Livelli di autenticazione.	boolean
$session.params.phone_number	(Facoltativo) Il numero di telefono locale dell'utente, senza il prefisso internazionale. Se questo parametro non viene fornito, il componente raccoglierà il numero di telefono dell'utente.	string
$flow.max_retry_telephone_counter	Specifica il numero di tentativi consentiti per la raccolta del numero di telefono dell'utente. Il valore predefinito è 1.	integer
$flow.max_retry_security_ans_count	Specifica il numero di tentativi consentiti per la raccolta delle risposte di sicurezza. Il valore predefinito è 3.	integer
$flow.max_retry_security_key	Specifica il numero di nuovi tentativi consentiti durante la raccolta del token di sicurezza. Il valore predefinito è 3.	integer
$flow.max_retry_otp_not_received	Specifica il numero di nuovi tentativi consentiti quando la password monouso (OTP) non viene ricevuta. Il valore predefinito è 1.	integer
$flow.max_retry_otp_count	Specifica il numero di tentativi consentiti per la raccolta della password monouso (OTP). Il valore predefinito è 3.	integer
$flow.security_ans_denial_count	Specifica il numero di nuovi tentativi consentiti quando un utente rifiuta di fornire le informazioni richieste. Il valore predefinito è 1.	integer
$flow.security_ans_mid_count	Specifica il numero di risposte di sicurezza errate che un utente può fornire. Il valore predefinito è 2, il che significa che se il chiamante fornisce risposte errate a due domande diverse, il componente esce con un errore.	integer
$flow.max_retry_card_counter	Specifica il numero di tentativi consentiti per la raccolta delle ultime quattro cifre della carta di debito dell'utente. Il valore predefinito è 2.	integer
$flow.security_key_length	Specifica la lunghezza valida del token di sicurezza fornito dall'app di autenticazione per l'autenticazione di livello 2. Il valore predefinito è 6.	integer
$flow.otp_length	Specifica la lunghezza valida della password monouso (OTP) per l'autenticazione di livello 1. Il valore predefinito è 6.	integer

Per configurare i parametri di input per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona l'agente.
4. Seleziona la scheda Build.
5. Fai clic sul componente importato nella sezione Flussi.
6. Fai clic sulla pagina iniziale nella sezione Pagine.
7. Fai clic sulla route true nella pagina iniziale.
8. Nella finestra Route (Percorso), modifica i valori di Parameter Presets (Preset dei parametri) in base alle tue esigenze.
9. Fai clic su Salva.

Parametri di output

I parametri di output sono parametri di sessione che rimangono attivi dopo che l'utente esce dal componente. Questi parametri contengono informazioni importanti raccolte dal componente.

Questo componente predefinito fornisce i valori per i seguenti parametri di output:

Nome parametro	Descrizione	Formato di output
auth_level	Indica il livello di autenticazione corrente dell'utente.	integer
phone_number	Il numero di telefono locale fornito dall'utente, senza il prefisso internazionale.	string
transfer_reason	Questo parametro indica il motivo per cui il flusso è stato interrotto, se non è andato a buon fine. Il valore restituito è uno dei seguenti: agent: l'utente ha richiesto un agente umano in un momento della conversazione. denial_of_information: l'utente ha rifiutato di condividere le informazioni richieste dal componente. max_no_input: la conversazione ha raggiunto il numero massimo di nuovi tentativi per gli eventi di mancato input. Consulta gli eventi integrati di assenza di input. max_no_match: la conversazione ha raggiunto il numero massimo di nuovi tentativi per gli eventi di mancata corrispondenza. Consulta gli eventi integrati no-match. webhook_error: si è verificato un errore del webhook. Consulta l'evento integrato webhook.error. webhook_not_found: un URL webhook non era raggiungibile. Consulta l'evento integrato webhook.error.not-found.	string

Impostazione di base

Per configurare questo componente predefinito:

1. Importa il componente predefinito.
2. Configura i webhook flessibili forniti con le impostazioni che descrivono i tuoi servizi esterni, consulta Configurazione dei webhook.

Configurazione del webhook

Per utilizzare questo componente, l'utente deve configurare i webhook flessibili inclusi per recuperare le informazioni necessarie dai propri servizi esterni.

Verifica telefonica

Il webhook prebuilt_components_authentication:telephony_verification viene utilizzato dal componente per recuperare i dettagli dell'account utente in base al numero di telefono fornito.

Parametri di richiesta API

Il componente fornisce i seguenti parametri come input per la richiesta API:

Nome parametro	Descrizione	Formato di input
$session.params.phone_number	Il numero di telefono locale dell'utente, senza il prefisso internazionale.	string

Parametri di risposta dell'API

Il componente estrae i seguenti parametri dalla risposta dell'API:

Nome parametro	Descrizione	Formato di output
account_count	Il numero di account associati al numero di telefono registrato. Questi account includono account personali e account per i quali l'utente dispone di una procura.	integer
last_four_digit_of_account_number	Se un utente ha un solo account, vengono restituite le ultime quattro cifre del numero di conto bancario. Se un utente ha più di un account, il valore di questo parametro è null.	string
email	L'indirizzo email registrato con l'account. Se non è presente un indirizzo email registrato con l'account, il valore di questo parametro è null.	string

Per configurare il webhook di verifica della telefonia per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona l'agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_authentication:telephony_verification.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il metodo appropriato nel menu a discesa.
8. Esamina e aggiorna il corpo della richiesta per formare il formato di richiesta appropriato per il webhook.
9. Esamina e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, poiché sono richiesti dal componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Recupera i dati della carta di credito

Il componente utilizza il webhook prebuilt_components_account_services:get_credit_card_details per recuperare informazioni sulle carte di credito registrate per un utente.

Parametri di richiesta API

Il componente fornisce i seguenti parametri come input per la richiesta API:

Nome parametro	Descrizione	Formato di input
$session.params.phone_number	Il numero di telefono locale dell'utente, senza il prefisso internazionale.	string

Parametri di risposta dell'API

Il componente estrae i seguenti parametri dalla risposta dell'API:

Nome parametro	Descrizione	Formato di output
credit_card_count	Il numero di carte di credito associate al numero di telefono registrato.	integer
last_four_digit_of_credit_card_number	Se un utente ha una sola carta di credito, vengono restituite le ultime quattro cifre del numero della carta. Se un utente ha più di una carta, il valore di questo parametro è null.	string
email	L'indirizzo email registrato con l'account. Se non è presente un indirizzo email registrato con l'account, il valore di questo parametro è null.	string

Per configurare il webhook Recupera i dati della carta di credito per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona l'agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_account_services:get_credit_card_details.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il metodo appropriato nel menu a discesa.
8. Esamina e aggiorna il corpo della richiesta per formare il formato di richiesta appropriato per il webhook.
9. Esamina e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, poiché sono richiesti dal componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Invia OTP

Il webhook prebuilt_components_authentication:send_otp invia una password monouso (OTP) a un canale registrato che selezioni.

Parametri di richiesta API

Il componente fornisce i seguenti parametri come input per la richiesta API:

Nome parametro	Descrizione	Formato di input
$session.params.phone_number	Il numero di telefono locale dell'utente, senza il prefisso internazionale.	string
$flow.channel	Il canale selezionato dall'utente per ricevere la OTP. I valori validi sono definiti dall'entità personalizzata prebuilt_components_authentication_channel. Per impostazione predefinita, sono supportati email e mobile.	string

Parametri di risposta dell'API

Il componente estrae i seguenti parametri dalla risposta dell'API:

Nome parametro	Descrizione	Formato di output
generated_otp	Il valore della OTP generata e inviata all'utente tramite il canale selezionato.	string

Per configurare il webhook Invia OTP per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona l'agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_authentication:send_otp.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il metodo appropriato nel menu a discesa.
8. Esamina e aggiorna il corpo della richiesta per formare il formato di richiesta appropriato per il webhook.
9. Esamina e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, poiché sono richiesti dal componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Risposte alle domande di sicurezza

Il webhook prebuilt_components_authentication:security_answers recupera le risposte di sicurezza dell'utente dal suo account registrato.

Parametri di richiesta API

Il componente fornisce i seguenti parametri come input per la richiesta API:

Nome parametro	Descrizione	Formato di input
$session.params.phone_number	Il numero di telefono locale dell'utente, senza il prefisso internazionale.	string

Parametri di risposta dell'API

Il componente estrae i seguenti parametri dalla risposta dell'API:

Nome parametro	Descrizione	Formato di output
security_last_trans_amount	Indica l'importo totale dell'ultima transazione dell'utente, senza il simbolo della valuta. Ad esempio, se l'importo dell'ultima transazione dell'utente è 100,30 $, il valore previsto di questo campo è "100.30".	string
last_payment_mode	Il metodo di pagamento utilizzato per l'ultima transazione dell'utente, con valori validi definiti dall'entità personalizzata prebuilt_components_authentication_payment_mode. Per impostazione predefinita, questi valori includono mobile, upi, online, debit, credit e account.	string
security_card_number	Le ultime quattro cifre del numero della carta di debito dell'utente.	string
user_dob	La data di nascita dell'utente nel formato AAAA-MM-GG.	string
cards_exp_date_all	Le date di scadenza di tutte le carte di credito registrate con l'utente nel formato MMAAAA.	Elenco (stringa)

Per configurare il webhook delle risposte di sicurezza per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona l'agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_authentication:security_answers.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il metodo appropriato nel menu a discesa.
8. Esamina e aggiorna il corpo della richiesta per formare il formato di richiesta appropriato per il webhook.
9. Esamina e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, poiché sono richiesti dal componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Convalida a due fattori

Il webhook prebuilt_components_authentication:2fa_validation consente al componente di convalidare il token di sicurezza fornito dall'utente per l'autenticazione a due fattori.

Parametri di richiesta API

Il componente fornisce i seguenti parametri come input per la richiesta API:

Nome parametro	Descrizione	Formato di input
$session.params.phone_number	Il numero di telefono locale dell'utente, senza il prefisso internazionale.	string
$flow.security_key	Il token di sicurezza fornito dall'utente, generato utilizzando un'app bancaria o un'app di autenticazione.	string

Parametri di risposta dell'API

Il componente estrae i seguenti parametri dalla risposta dell'API:

Nome parametro	Descrizione	Formato di output
security_key_verified	Indica se la chiave di sicurezza fornita dall'utente è valida. true indica che il token di sicurezza fornito è valido. false indica che il token di sicurezza fornito non è valido.	boolean

Per configurare il webhook di convalida a due fattori per questo componente, espandi per visualizzare le istruzioni.

1. Apri la console Dialogflow CX.
2. Scegli il tuo progetto Google Cloud.
3. Seleziona l'agente.
4. Seleziona la scheda Gestisci.
5. Fai clic su Webhook.
6. Seleziona il webhook prebuilt_components_authentication:2fa_validation.
7. Sostituisci l'URL nel campo URL webhook di Dialogflow CX con l'endpoint del servizio con cui vuoi eseguire l'integrazione. Seleziona il metodo appropriato nel menu a discesa.
8. Esamina e aggiorna il corpo della richiesta per formare il formato di richiesta appropriato per il webhook.
9. Esamina e aggiorna la configurazione della risposta per estrarre campi specifici dalla risposta del webhook. Non modificare i nomi dei parametri, poiché sono richiesti dal componente per accedere ai valori dei campi restituiti.
10. Esamina e aggiorna le impostazioni di autenticazione in base alle esigenze.
11. Fai clic su Salva.

Completa

Il componente predefinito e i relativi webhook sono ora configurati e pronti per il test.