Componente predefinito per l'autenticazione

L'autenticazione raccolte di componenti predefiniti le informazioni dell'utente per autenticarlo al livello di autenticazione richiesto. Questo componente copre i requisiti di autenticazione comuni, ma non dei servizi finanziari (FSI). Questo componente utilizza i componenti predefiniti Raccolta di date di scadenza delle carte di credito, Raccolta di date di nascita e Raccolta di numeri di telefono per raccogliere e convalidare i dettagli dell'utente.

Livelli di autenticazione

Ci sono più livelli di autenticazione richiesti da diverse soluzioni predefinite componenti, con livelli più elevati che richiedono più informazioni dall'utente per l'autenticazione per l'utente. Il componente Authentication consente agli utenti di autenticarsi a livello 0 (corrispondenza ANI), livello 1 (di base) o livello 2 (multifattoriale) come descritto nella tabella del livello di autenticazione.

Livello di autenticazione	Requisiti
Livello 0: ANI Match	L'utente viene autenticato chiamando o fornendo un numero di telefono corrispondente a un account registrato. Un utente può essere autenticato al livello 0 utilizzando il componente predefinito Saluto.
Livello 1. Di base	L'utente viene autenticato verificando un codice OTP (password monouso) inviato al suo indirizzo email o numero di telefono. Se la verifica OTP non va a buon fine, l'utente può fornire le risposte a tre delle quattro domande di sicurezza per autenticarsi correttamente: data di nascita, ultime quattro cifre della carta di debito o della carta di credito dell'utente (a seconda che si tratti di un account o del titolare della carta), importo dell'ultima transazione e metodo di pagamento dell'ultima fattura della carta di credito.
Livello 2: Multi-fattore	L'utente viene inoltre autenticato 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 fornisce assistenza agli utenti che sono clienti bancari registrati, titolari di conto, titolari di carta o entrambi. Il componente supporta anche autenticazione per utenti che non sono clienti bancari registrati, ma che dispongono di procuratore per i conti registrati presso la banca. Gli utenti possono avere uno o più conto o carte registrati presso la banca.

Tipi di autenticazione

Questo componente ti consente di configurare se un utente deve essere autenticato come il titolare di un account, di una carta o di entrambi. Queste opzioni sono configurate l'impostazione di $session.params.account_auth_enabled e $session.params.card_auth_enabled parametri di input. Questa tabella descrive il componente il comportamento di ogni combinazione di valori per l'autenticazione dell'account e i flag di autenticazione delle carte.

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

Limitazioni

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

• Le OTP verranno precedentemente inviate solo a un numero di cellulare o a un indirizzo email registrato per l'utente. Il componente non utilizzerà la OTP per autenticare i clienti chiamare da un numero di telefono alternativo non registrato con il relativo account. Quando un utente chiama da un numero di telefono alternativo, le domande di sicurezza vengono usato per autenticare il chiamante.
• Questo componente non cripta alcun dato.

Finestre di dialogo di esempio

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

Autenticazione di livello 1 riuscita: OTP

L'utente è stato precedentemente autenticato per l'autenticazione di livello 0. Componente invia e chiede all'utente di confermare una OTP inviata al canale scelto dall'utente. L'utente è in grado di fornire un'OTP valida e viene autenticato correttamente 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 per telefono o per 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 è stata completata.

Autenticazione di livello 1 riuscita: domande di sicurezza

Il componente conferma l'autenticazione di livello 0 dell'utente raccogliendo e verificando il numero di telefono fornito. Il componente richiede e convalida le risposte corrette dell'utente a tre domande di sicurezza: data di nascita, ultime quattro cifre del numero della carta di debito dell'utente e importo dell'ultima transazione. Autenticazione dell'utente riuscita a 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 numeri di telefono
	Ok. Il numero indicato è più 1 6502530000, giusto?
Sì
	Bene, abbiamo finito di raccogliere il numero di telefono. Ok, per motivi di sicurezza avremo bisogno di qualche informazione in più per confermare 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, giusto?
Sì
	Bene, abbiamo raccolto la tua data di nascita. Facci sapere le ultime quattro cifre del numero della tua carta di debito.
È 1234
	Dicci l'importo in dollari della tua ultima transazione. Ad esempio, se l'importo dell'ultima transazione è stato di 100,30 $, pronuncia "100".
Era 500 dollari
	Grazie, l'autenticazione è stata completata.

Autenticazione di livello 2 riuscita: autenticazione a due fattori

L'utente è stato precedentemente autenticato per l'autenticazione di livello 1. La chiede all'utente di generare un token di sicurezza utilizzando la propria banca oppure app di autenticazione. L'utente conferma il token di sicurezza generato e sta autenticati al Livello 2.

Input utente	Risposta dell'agente
	Condividi il token di sicurezza. Genera il token di sicurezza a 6 cifre nell'app della tua banca o nell'app di autenticazione. Poi di' o inserisci le cifre.
232425
	Grazie, l'autenticazione è stata completata.

Negazione di informazioni

L'utente rifiuta di fornire le informazioni richieste per l'autenticazione. Il componente 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 per telefono o per email?
No, non voglio condividere
	Ok, per motivi di sicurezza avremo bisogno di qualche altra informazione per confermare 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ì
	Bene, abbiamo raccolto la tua data di nascita. Facci sapere le ultime quattro cifre del numero della tua carta di debito.
È 1234
	Dicci l'importo in dollari della tua ultima transazione. Ad esempio, se l'importo dell'ultima transazione era pari a 100,30 $, di' "100".
Non voglio condividere i dettagli
	Non siamo riusciti ad autenticarti, pertanto non siamo in grado di 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
Flusso	[Nome componente]	Autenticazione
Intent specifico 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 sono parametri utilizzati per configurare determinati comportamenti del componente. I parametri verranno utilizzati da una o più condizioni all'interno di per determinare il comportamento del componente. I parametri basati sul flusso devono essere impostati nella pagina iniziale del componente come descritto di seguito. Con ambito sessione possono essere impostati da un flusso di chiamata o all'inizio pagina di questo componente.

Questo componente predefinito accetta i seguenti parametri di input:

Nome parametro	Descrizione	Formato di input
$session.params.auth_level	(Facoltativo) Indica il livello di autenticazione corrente dell'utente finale.	integer
$session.params.auth_level_req	Definisce il livello di autenticazione a cui verrà autenticato l'utente finale. 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) Numero di telefono dell'utente finale. Se questo parametro non viene fornito, il componente raccoglierà il numero di telefono dall'utente finale.	string
$flow.max_retry_telephone_counter	Specifica il numero di nuovi tentativi consentiti durante 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 durante la raccolta delle risposte di sicurezza. Il valore predefinito è 3.	integer
$flow.max_retry_security_key	Specifica il numero di 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 non viene ricevuta la password monouso (OTP). 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 si chiude con un errore.	integer
$flow.max_retry_card_counter	Specifica il numero di nuovi tentativi consentiti durante la raccolta delle ultime quattro cifre della carta di debito dell'utente finale. 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

Parametri di output

I parametri di output sono parametri di sessione che rimarranno attivi dopo l'uscita del componente. Questi parametri contengono informazioni importanti raccolte dal componente. Questo componente predefinito fornisce valori per il seguente output parametri:

Nome parametro	Descrizione	Formato di output
auth_level	Indica l'attuale livello di autenticazione dell'utente finale.	integer
phone_number	Il numero di telefono locale dell'utente, senza il codice paese, utilizzato per identificare l'utente.	string
transfer_reason	Questo parametro indica il motivo per cui il flusso è stato chiuso, se non è andato a buon fine. Il valore restituito è uno dei seguenti: agent: l'utente finale ha richiesto un agente umano a un certo punto della conversazione. denial_of_information: l'utente finale 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 senza input. Vedi gli eventi integrati senza input. max_no_match: la conversazione ha raggiunto il numero massimo di nuovi tentativi per eventi senza corrispondenza. Vedi gli eventi integrati senza corrispondenza. webhook_error: si è verificato un errore relativo al webhook. Vedi l'evento integrato webhook.error. webhook_not_found: l'URL di un webhook non è raggiungibile. Vedi webhook.error.not-found-in-evento integrato.	string

Impostazione di base

Per configurare questo componente predefinito:

1. Importa il componente predefinito.
2. Configura l'oggetto fornito webhook flessibili con che descrive i servizi esterni, vedi webhook la configurazione riportata di seguito.

Configurazione webhook

Per utilizzare questo componente, è necessario configurare lo strumento webhook flessibili per recuperare le informazioni necessarie dai tuoi servizi esterni.

Verifica telefonia

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

Parametri di richiesta API

I seguenti parametri sono forniti dal componente 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 codice paese, utilizzato per identificare l'utente.	string

Parametri di risposta dell'API

I seguenti parametri vengono estratti dalla risposta dell'API per essere utilizzati dal componente.

Nome parametro	Descrizione	Formato di output
account_count	Il numero di account associati al numero di telefono registrato. Questi account includono account self-service e account per i quali l'utente dispone di una procura.	integer
last_four_digit_of_account_number	Se un utente dispone di un solo account, vengono restituite le ultime quattro cifre del numero di conto. 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 esiste un indirizzo email registrato con l'account, il valore di questo parametro è null.	string

Ottieni i dettagli della carta di credito

Il webhook prebuilt_components_account_services:get_credit_card_details viene utilizzato dal componente per ottenere informazioni sulle carte di credito registrate a un utente.

Parametri di richiesta API

I seguenti parametri sono forniti dal componente 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 codice paese, utilizzato per identificare l'utente.	string

Parametri di risposta dell'API

I seguenti parametri vengono estratti dalla risposta dell'API per essere utilizzati dal componente.

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 dispone di un'unica carta di credito, vengono restituite le ultime quattro cifre del numero della carta. Se un utente ha più di una scheda, il valore di questo parametro è null.	string
email	L'indirizzo email registrato con l'account. Se non esiste un indirizzo email registrato con l'account, il valore di questo parametro è null.	string

Invia OTP

Il webhook prebuilt_components_authentication:send_otp viene utilizzato dal componente per inviare una password monouso (OTP) a un canale registrato selezionato dall'utente finale.

Parametri di richiesta API

I seguenti parametri sono forniti dal componente 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 codice paese, utilizzato per identificare l'utente.	string
$flow.channel	Il canale su cui l'utente ha selezionato di ricevere l'OTP. I valori validi sono definiti dall'entità personalizzata prebuilt_components_authentication_channel. Per impostazione predefinita, sono supportati i criteri email e mobile.	string

Parametri di risposta dell'API

I seguenti parametri vengono estratti dalla risposta dell'API per essere utilizzati dal componente.

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

Risposte di sicurezza

Il webhook prebuilt_components_authentication:security_answers viene utilizzato per recuperare le risposte di sicurezza dell'utente finale dal suo account registrato.

Parametri di richiesta API

I seguenti parametri sono forniti dal componente 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 codice paese, utilizzato per identificare l'utente.	string

Parametri di risposta dell'API

I seguenti parametri vengono estratti dalla risposta dell'API per essere utilizzati dal componente.

Nome parametro	Descrizione	Formato di output
security_last_trans_amount	Indica l'importo completo dell'ultima transazione dell'utente, senza il simbolo di 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 (DOB) 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)

Convalida a due fattori

Il webhook prebuilt_components_authentication:2fa_validation viene utilizzato per convalidare il token di sicurezza fornito dall'utente finale per autenticazione.

Parametri di richiesta API

I seguenti parametri sono forniti dal componente 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 codice paese, utilizzato per identificare l'utente.	string
$flow.security_key	Il token di sicurezza fornito dall'utente finale, generato utilizzando un'app della banca o un'app di autenticazione.	string

Parametri di risposta dell'API

I seguenti parametri vengono estratti dalla risposta dell'API per essere utilizzati dal componente.

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

Completa

L'agente e i relativi webhook ora dovrebbero essere configurati e pronti per il test.