Vordefinierte Authentifizierungskomponente

Die Authentifizierung vordefinierte Komponente erfasst Informationen vom Nutzer, um ihn bis zur erforderlichen Authentifizierungsebene zu authentifizieren. Diese Komponente deckt gängige Authentifizierungsanforderungen ab, exklusiv für die Finanzdienstleistungsbranche. Diese Komponente verwendet die vordefinierten Komponenten Ablaufdatum der Kreditkarte, Geburtsdatum und Telefonnummer, um Nutzerdetails zu erfassen und zu validieren.

Authentifizierungsebenen

Es gibt mehrere Authentifizierungsebenen, die von verschiedenen vordefinierten -Komponenten, wobei auf höheren Ebenen mehr Nutzerinformationen zur Authentifizierung erforderlich sind. Nutzenden. Die Authentication-Komponente ermöglicht es Nutzern, sich bei Level 0 (ANI-Übereinstimmung) zu authentifizieren. Stufe 1 (einfach) oder Stufe 2 (Multi-Faktor-Authentifizierung), wie in der Tabelle der Authentifizierungsebene beschrieben.

Authentifizierungsebene	Voraussetzungen
Stufe 0: ANI-Abgleich	Der Nutzer wird authentifiziert, indem er von einer Telefonnummer aus anruft oder eine Telefonnummer angibt, die einem registrierten Konto entspricht. Ein Nutzer kann mit der vordefinierten Komponente „Gruß“ auf Stufe 0 authentifiziert werden.
Level 1: Einfach	Der Nutzer wird durch Bestätigung eines Einmalpasswort-Codes authentifiziert, der an seine E-Mail-Adresse oder Telefonnummer gesendet wurde. Wenn die OTP-Bestätigung fehlschlägt, kann der Nutzer drei von vier Sicherheitsfragen beantworten, um sich erfolgreich zu authentifizieren: Geburtsdatum, die letzten vier Ziffern des Ablaufdatums der Debit- oder Kreditkarte des Nutzers (je nachdem, ob es sich um einen Konto- oder Karteninhaber handelt), den letzten Transaktionsbetrag und die letzte Zahlungsmethode für die Kreditkartenabrechnung.
Stufe 2: Multi-Faktor	Der Nutzer wird zusätzlich durch die Bestätigung eines Sicherheitsschlüssels authentifiziert, der von einer externen Authentifizierungs-App oder Push-Benachrichtigung generiert wurde.

Unterstützte Nutzertypen

Die Authentifizierungskomponente bietet Unterstützung für Nutzer, die als Bank registriert sind Kunden, die Kontoinhaber, Karteninhaber oder beides sind. Die Komponente unterstützt auch die Authentifizierung von Nutzern, die keine Bankkunden sind, aber eine Vollmacht für bei der Bank registrierte Konten haben. Nutzer haben möglicherweise ein oder mehrere Konten oder Karten, die bei der Bank registriert sind.

Authentifizierungstypen

Mit dieser Komponente können Sie konfigurieren, ob ein Nutzer als einen Kontoinhaber, einen Karteninhaber oder beides. Diese Optionen werden von $session.params.account_auth_enabled und $session.params.card_auth_enabled festlegen Eingabeparameter. In dieser Tabelle wird das Komponentenverhalten für verschiedene Kombinationen von Werten für die Flags für die Konto- und Kartenauthentifizierung beschrieben.

account_auth_enabled	card_auth_enabled	Authentifizierungstyp
true	false	Der Nutzer wird als Kontoinhaber authentifiziert, indem er bestätigt, dass er ein oder mehrere Konten bei der Bank hat, und Sicherheitsfragen beantwortet, einschließlich der letzten vier Ziffern der registrierten Debitkarte.
false	true	Der Nutzer wird als Karteninhaber authentifiziert. Dabei wird überprüft, ob der Nutzer eine oder mehrere Kreditkarten bei der Bank besitzt, und Sicherheitsfragen werden bestätigt, einschließlich des Ablaufdatums der Kreditkarte für eine registrierte Kreditkarte.
true	true	Die Komponente prüft zunächst, ob der Nutzer ein registrierter Kontoinhaber ist. Wenn der Nutzer ein oder mehrere Konten bei der Bank hat, authentifiziert die Komponente den Nutzer anhand der Kontoinformationen. Wenn der Nutzer kein Konto bei der Bank hat, versucht die Komponente, den Nutzer anhand der Karteninhaberdaten zu authentifizieren.
false	false	Die Komponente prüft zunächst, ob der Nutzer ein registrierter Kontoinhaber ist. Wenn der Nutzer ein oder mehrere Konten bei der Bank hat, authentifiziert die Komponente den Nutzer auf Ebene-0-Authentifizierung. Wenn der Nutzer keine Konten bei der Bank besitzt, prüft die Komponente, ob der Nutzer ein Karteninhaber ist. Wenn der Nutzer eine oder mehrere Kreditkarten bei der Bank hat, authentifiziert die Komponente den Nutzer mit der Authentifizierung der Stufe 0.

Beschränkungen

Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten, für diese vordefinierte Komponente gelten die folgenden Einschränkungen:

• OTPs wurden bisher nur an eine Mobiltelefonnummer oder E-Mail-Adresse gesendet die für den Nutzer registriert sind. Die Komponente verwendet kein OTP, um Kunden zu authentifizieren, die von einer alternativen Telefonnummer anrufen, die nicht mit ihrem Konto registriert ist. Wenn ein Nutzer von einer alternativen Telefonnummer anruft, werden Sicherheitsfragen gestellt zur Authentifizierung des Anrufers verwendet wird.
• Diese Komponente verschlüsselt keine Daten.

Beispieldialoge

Die folgenden Beispieldialogfelder veranschaulichen häufige Szenarien, die von diesem vordefinierte Komponente. Die Beispieldialogfelder zeigen das Verhalten, wenn die Komponente wird per Telefonie aufgerufen, wodurch der Standard-Begrüßungs-Intent und der erste Antwort des Kundenservicemitarbeiters zu Beginn der Unterhaltung.

Erfolgreiche Authentifizierung der Stufe 1: OTP

Der Nutzer wurde zuvor für Ebene 0 authentifiziert. Komponente sendet und bittet den Nutzer, ein OTP zu bestätigen, das an den Kanal seiner Wahl gesendet wurde. Der Nutzer kann ein gültiges OTP angeben und wurde für Level 1 authentifiziert.

Nutzereingabe	Antwort des Kundenservicemitarbeiters
	Aus Sicherheitsgründen müssen wir Ihre Identität bestätigen. Dazu senden wir Ihnen einen Code. Möchten Sie den Code lieber per Telefon oder per E-Mail erhalten?
Telefon
	Wir haben einen Code an Ihre registrierte Telefonnummer mit der Endung 0000 gesendet. Das kann einige Sekunden dauern. Können Sie den Code bitte bestätigen?
Der Code lautet 123457.
	Vielen Dank. Sie wurden erfolgreich authentifiziert.

Authentifizierung der Stufe 1 erfolgreich: Sicherheitsfragen

Die Komponente bestätigt die Ebene-0-Authentifizierung des Nutzers, indem sie den angegebene Telefonnummer. Die Komponente fragt nach den richtigen Antworten des Nutzers auf drei Sicherheitsfragen und validiert sie: Geburtsdatum, die letzten vier Ziffern der Debitkartennummer des Nutzers und der Betrag der letzten Transaktion. Der Nutzer ist erfolgreich für Level 1 authentifiziert.

Nutzereingabe	Antwort des Kundenservicemitarbeiters
	Sind Sie Kunde unserer Bank oder haben Sie eine Vollmacht? Bitte bestätige dies mit Ja oder Nein.
Ja
	Okay, wir benötigen Ihre Telefonnummer, um Ihre Kontodetails abzurufen.
	Agent erfasst die Telefonnummer des Nutzers über die vordefinierte Komponente Erhebung von Telefonnummern
	Alles klar. Die von Ihnen genannte Nummer lautet plus 1 6502530000, ist das richtig?
Ja
	Alles klar, wir haben die Telefonnummer erfasst. Okay, aus Sicherheitsgründen benötigen wir noch einige weitere Informationen, um Ihre Identität zu bestätigen.
	Der Kundenservicemitarbeiter erhebt das Geburtsdatum des Nutzers mithilfe der vorgefertigten Komponente Date of birth collection (Erhebung des Geburtsdatums).
	Okay, Ihr Geburtsdatum ist der 3. Februar 1995. Ist das richtig?
Ja
	Sehr gut, wir haben dein Geburtsdatum erfasst. Bitte nenne uns die letzten vier Ziffern deiner Debitkartennummer.
Es ist 1234.
	Bitte geben Sie den Betrag Ihrer letzten Transaktion in US-Dollar an. Wenn der Betrag Ihrer letzten Transaktion beispielsweise 100,30 € betrug, sagen Sie „100“.
Es waren 500 $
	Vielen Dank. Sie wurden erfolgreich authentifiziert.

Erfolgreiche Authentifizierung der Stufe 2: 2-Faktor-Authentifizierung

Der Nutzer wurde zuvor für Ebene 1 authentifiziert. Die fordert den Nutzer auf, einen Sicherheitsschlüssel mit seiner Bank oder Authentifizierungs-App an. Der Nutzer bestätigt den generierten Sicherheitsschlüssel und ist auf Level 2 authentifiziert.

Nutzereingabe	Antwort des Kundenservicemitarbeiters
	Bitte teilen Sie mir Ihren Sicherheitsschlüssel mit. Erstellen Sie den sechsstelligen Sicherheitsschlüssel in Ihrer Banking-App oder Authenticator App. Sagen oder geben Sie dann die Ziffern ein.
232425
	Vielen Dank, Sie wurden erfolgreich authentifiziert.

Leugnung von Informationen

Der Nutzer lehnt die Bereitstellung von Informationen ab, die zur Authentifizierung erforderlich sind. Die Komponente wird mit einer Fehlermeldung beendet.

Nutzereingabe	Antwort des Kundenservicemitarbeiters
	Aus Sicherheitsgründen müssen wir deine Identität überprüfen und schicken dir deshalb einen Code. Möchten Sie den Code lieber per Telefon oder per E-Mail erhalten?
Nein, ich möchte das nicht teilen
	Ok, aus Sicherheitsgründen benötigen wir weitere Informationen, um deine Identität zu bestätigen.
	Der Kundenservicemitarbeiter erhebt das Geburtsdatum des Nutzers mithilfe der vorgefertigten Komponente Date of birth collection (Erhebung des Geburtsdatums).
	Okay, Ihr Geburtsdatum ist der 3. Februar 1995. Ist das richtig?
Ja
	Sehr gut, wir haben dein Geburtsdatum erfasst. Bitte nenne uns die letzten vier Ziffern deiner Debitkartennummer.
Es ist 1234.
	Bitte teilen Sie uns den Dollarbetrag Ihrer letzten Transaktion mit. Wenn der Betrag Ihrer letzten Transaktion beispielsweise 100,30 € betrug, sagen Sie „100“.
Ich möchte keine Details teilen
	Wir konnten Sie nicht authentifizieren. Daher können wir diese Aktion nicht ausführen. Für eventuell entstehende Unannehmlichkeiten bitten wir Sie um Entschuldigung.

Namenskonventionen

Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:

Funktion	Format	Beispiel
Ablauf	[Component Name]	Authentifizierung
Komponentenspezifischer Intent	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_authentication_power_of_attorney
Entitätstyp	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_authentication_payment_mode
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_authentication:telephony_verification

Eingabeparameter

Eingabeparameter sind Parameter, mit denen bestimmte Verhaltensweisen eines Komponente. Die Parameter werden von mindestens einer Bedingung im um zu bestimmen, wie sich die Komponente verhalten soll. Parameter auf Flussebene müssen auf der Startseite der Komponente wie unten beschrieben festgelegt werden. Auf Sitzungsebene Parameter können entweder von einem aufrufenden Ablauf oder beim Start Seite dieser Komponente.

Diese vordefinierte Komponente akzeptiert die folgenden Eingabeparameter:

Parametername	Beschreibung	Eingabeformat
$session.params.auth_level	(Optional) Gibt die aktuelle Authentifizierungsebene des Endnutzers an.	integer
$session.params.auth_level_req	Definiert die Authentifizierungsebene, für die der Endnutzer authentifiziert wird. Gültige Werte sind 0, 1 und 2.	integer
$session.params.account_auth_enabled	Gibt an, ob der Nutzer als Kontoinhaber authentifiziert werden soll. Das Verhalten der Komponente hängt von diesem Wert und dem Wert von $session.params.card_auth_enabled ab, wie unter Authentifizierungsstufen beschrieben.	boolean
$session.params.card_auth_enabled	Gibt an, ob der Nutzer als Karteninhaber authentifiziert werden soll. Das Verhalten der Komponente hängt von diesem Wert und dem Wert von $session.params.account_auth_enabled ab, wie unter Authentifizierungsebenen beschrieben.	boolean
$session.params.phone_number	Optional: Telefonnummer des Endnutzers. Wenn dieser Parameter nicht angegeben wird, erfasst die Komponente die Telefonnummer vom Endnutzer.	String
$flow.max_retry_telephone_counter	Gibt die Anzahl der zulässigen Wiederholungsversuche bei der Erfassung der Telefonnummer des Nutzers an. Der Standardwert ist 1.	integer
$flow.max_retry_security_ans_count	Gibt die Anzahl der zulässigen Wiederholungsversuche beim Erfassen von Sicherheitsantworten an. Der Standardwert ist 3.	integer
$flow.max_retry_security_key	Gibt die Anzahl der zulässigen Wiederholungsversuche beim Abrufen des Sicherheitsschlüssels an. Der Standardwert ist 3.	integer
$flow.max_retry_otp_not_received	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn das Einmalpasswort nicht empfangen wird. Der Standardwert ist 1.	integer
$flow.max_retry_otp_count	Gibt die Anzahl der zulässigen Wiederholungsversuche beim Erfassen des Einmalpassworts (OTP) an. Der Standardwert ist 3.	integer
$flow.security_ans_denial_count	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn ein Nutzer die Angabe der angeforderten Informationen ablehnt. Der Standardwert ist 1.	integer
$flow.security_ans_mid_count	Gibt an, wie viele falsche Sicherheitsantworten ein Nutzer geben kann. Der Standardwert ist 2. Das bedeutet, dass die Komponente mit einem Fehler beendet wird, wenn der Aufrufer auf zwei verschiedene Fragen falsche Antworten gibt.	integer
$flow.max_retry_card_counter	Gibt die Anzahl der zulässigen Wiederholungsversuche an, wenn die letzten vier Ziffern der Debitkarte des Endnutzers erfasst werden. Der Standardwert ist 2.	integer
$flow.security_key_length	Gibt die gültige Länge des Sicherheitsschlüssels an, der von der Authenticator App für die Authentifizierung der Stufe 2 bereitgestellt wird. Der Standardwert ist 6.	integer
$flow.otp_length	Gibt die gültige Länge des Einmalpassworts (One Time Password, OTP) für die Authentifizierung der Stufe 1 an. Der Standardwert ist 6.	integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.

1. Öffnen Sie die Dialogflow CX Console.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Build aus.
5. Klicken Sie im Abschnitt Abläufe auf die importierte Komponente.
6. Klicken Sie im Bereich Seiten auf die Startseite.
7. Klicken Sie auf der Startseite auf die Route true.
8. Bearbeiten Sie im Fenster „Route“ die Werte für die Parametervorgaben nach Bedarf.
9. Klicken Sie auf Speichern.

Ausgabeparameter

Ausgabeparameter sind Sitzungsparameter, die nach dem Verlassen der Komponente aktiv bleiben. Diese Parameter enthalten wichtige Informationen, die von der Komponente erfasst werden. Diese vordefinierte Komponente liefert Werte für die folgenden Ausgabeparameter:

Parametername	Beschreibung	Ausgabeformat
auth_level	Gibt die aktuelle Authentifizierungsstufe des Endnutzers an.	integer
phone_number	Die Ortstelefonnummer des Nutzers ohne Landesvorwahl, die zur Identifizierung des Nutzers verwendet wird.	String
transfer_reason	Dieser Parameter gibt den Grund an, warum der Ablauf beendet wurde, falls er nicht erfolgreich war. Der zurückgegebene Wert kann einer der folgenden sein: agent: Der Endnutzer hat während der Unterhaltung einen menschlichen Kundenservicemitarbeiter angefordert. denial_of_information: Der Endnutzer hat die von der Komponente angeforderten Informationen abgelehnt. max_no_input: Bei der Unterhaltung wurde die maximale Anzahl von Wiederholungen für No-Input-Ereignisse erreicht. Siehe Integrierte Ereignisse ohne Eingabe. max_no_match: Die Unterhaltung hat die maximale Anzahl von Wiederholungsversuchen für No-Match-Ereignisse erreicht. Weitere Informationen finden Sie unter Integrierte Ereignisse ohne Übereinstimmung. webhook_error: Es ist ein Webhook-Fehler aufgetreten. Siehe webhook.error built-in event. webhook_not_found: Eine Webhook-URL war nicht erreichbar. Siehe webhook.error.not-found built-in event.	String

Grundlegende Einstellungen

So richten Sie diese vorkonfigurierte Komponente ein:

1. Importieren Sie die vordefinierte Komponente.
2. Konfigurieren Sie die flexible Webhooks mit Konfiguration, die Ihre externen Dienste beschreibt, siehe Webhook Einrichtung unten.

Webhook-Einrichtung

Zur Verwendung dieser Komponente müssen Sie die in flexiblen Webhooks zum Abrufen Informationen von Ihren externen Diensten benötigt.

Telefoniebestätigung

Über den prebuilt_components_authentication:telephony_verification-Webhook werden von der Komponente Nutzerkontodetails anhand der angegebenen Telefonnummer abgerufen.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird	String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.

Parametername	Beschreibung	Ausgabeformat
account_count	Die Anzahl der Konten, die mit der registrierten Telefonnummer verknüpft sind. Dazu gehören eigene Konten und Konten, für die der Nutzer eine Vollmacht hat.	integer
last_four_digit_of_account_number	Wenn ein Nutzer nur ein Konto hat, werden die letzten vier Ziffern der Kontonummer zurückgegeben. Wenn ein Nutzer mehrere Konten hat, hat dieser Parameter den Wert null.	String
E-Mail	Die mit dem Konto registrierte E-Mail-Adresse. Ist keine E-Mail-Adresse mit dem Konto registriert, hat dieser Parameter den Wert null.	String

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks für die Telefoniebestätigung für diese Komponente aufzurufen.

1. Öffnen Sie die Dialogflow CX Console.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Verwalten.
5. Klicken Sie auf Webhooks.
6. Wählen Sie den Webhook „prebuilt_components_authentication:telephony_verification“ aus.
7. Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (Dialogflow CX) durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die gewünschte Methode aus.
8. Prüfen und aktualisieren Sie den Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente diese für den Zugriff benötigt. den zurückgegebenen Feldwerten.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

Kreditkartendetails abrufen

Der Webhook prebuilt_components_account_services:get_credit_card_details wird verwendet von der Komponente, um Informationen zu den für einen Nutzer registrierten Kreditkarten zu erhalten.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird	String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.

Parametername	Beschreibung	Ausgabeformat
credit_card_count	Die Anzahl der Kreditkarten, die mit der registrierten Telefonnummer verknüpft sind.	integer
last_four_digit_of_credit_card_number	Wenn ein Nutzer nur eine Kreditkarte hat, werden die letzten vier Ziffern der Kartennummer zurückgegeben. Wenn ein Nutzer mehr als eine Karte hat, ist der Wert dieses Parameters null.	String
E-Mail	Die mit dem Konto registrierte E-Mail-Adresse. Ist keine E-Mail-Adresse mit dem Konto registriert, hat dieser Parameter den Wert null.	String

Wenn Sie den Webhook „Kreditkartendetails abrufen“ für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um die Anleitung aufzurufen.

1. Öffnen Sie die Dialogflow CX-Konsole.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Verwalten.
5. Klicken Sie auf Webhooks.
6. Wählen Sie den Webhook „prebuilt_components_account_services:get_credit_card_details“ aus.
7. Ersetzen Sie die URL im Feld Webhook-URL für Conversational Agents (Dialogflow CX) durch den Endpunkt des Dienstes. die Sie integrieren möchten. Wählen Sie im Drop-down-Menü die gewünschte Methode aus.
8. Prüfen und aktualisieren Sie den Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente diese für den Zugriff benötigt. den zurückgegebenen Feldwerten.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

OTP senden

Der Webhook prebuilt_components_authentication:send_otp wird verwendet von der Komponente verwendet wird, um ein Einmalpasswort (OTP) an einen registrierten Kanal zu senden die vom Endnutzer ausgewählt wurden.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird	String
$flow.channel	Der Kanal, über den der Nutzer das OTP erhalten möchte. Gültige Werte werden durch das benutzerdefinierte Element prebuilt_components_authentication_channel definiert. Standardmäßig werden email und mobile unterstützt.	String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.

Parametername	Beschreibung	Ausgabeformat
generated_otp	Der Wert des OTP, der generiert und über den ausgewählten Kanal an den Nutzer gesendet wird.	String

Wenn Sie den OTP-Webhook für diese Komponente konfigurieren möchten, maximieren Sie den Bereich, um die Anleitung aufzurufen.

1. Öffnen Sie die Dialogflow CX-Konsole.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Verwalten.
5. Klicken Sie auf Webhooks.
6. Wählen Sie den Webhook „prebuilt_components_authentication:send_otp“ aus.
7. Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (Dialogflow CX) durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die gewünschte Methode aus.
8. Prüfen und aktualisieren Sie den Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente diese für den Zugriff benötigt. den zurückgegebenen Feldwerten.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

Sicherheitsantworten

Über den prebuilt_components_authentication:security_answers-Webhook ruft die Komponente die Sicherheitsantworten des Endnutzers aus seinem registrierten Konto ab.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird	String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.

Parametername	Beschreibung	Ausgabeformat
security_last_trans_amount	Gibt den vollständigen Betrag der letzten Transaktion des Nutzers ohne Währungssymbol an. Wenn der letzte Transaktionsbetrag des Nutzers beispielsweise 100, 30 € beträgt, wird der erwartete Wert dieses Feldes "100.30".	String
last_payment_mode	Die für die letzte Transaktion des Nutzers verwendete Zahlungsmethode mit gültigen, von der benutzerdefinierten Entität prebuilt_components_authentication_payment_mode definierten Werten. Standardmäßig sind dies mobile, upi, online, debit, credit und account.	String
security_card_number	Die letzten vier Ziffern der Debitkartennummer des Nutzers.	String
user_dob	Das Geburtsdatum des Nutzers im Format JJJJ-MM-TT.	String
cards_exp_date_all	Die Ablaufdaten aller beim Nutzer registrierten Kreditkarten im Format MMJJJJ.	Liste (String)

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks für Sicherheitsantworten für diese Komponente aufzurufen.

1. Öffnen Sie die Dialogflow CX Console.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Verwalten.
5. Klicken Sie auf Webhooks.
6. Wählen Sie den Webhook „prebuilt_components_authentication:security_answers“ aus.
7. Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (Dialogflow CX) durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die gewünschte Methode aus.
8. Prüfen und aktualisieren Sie den Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente diese für den Zugriff benötigt. den zurückgegebenen Feldwerten.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

2-Faktor-Authentifizierung

Der Webhook prebuilt_components_authentication:2fa_validation wird vom Komponente zur Validierung des vom Endnutzer bereitgestellten Sicherheitsschlüssels für die 2-Faktor-Authentifizierung Authentifizierung.

API-Anfrageparameter

Die folgenden Parameter werden von der Komponente als Eingaben für die API-Anfrage bereitgestellt.

Parametername	Beschreibung	Eingabeformat
$session.params.phone_number	Lokale Telefonnummer des Nutzers ohne Ländercode, anhand derer der Nutzer identifiziert wird	String
$flow.security_key	Der vom Endnutzer bereitgestellte Sicherheitsschlüssel, der mit einer Bank- oder Authentifizierungs-App generiert wurde.	String

API-Antwortparameter

Die folgenden Parameter werden aus der API-Antwort abgerufen und von der Komponente verwendet.

Parametername	Beschreibung	Ausgabeformat
security_key_verified	Gibt an, ob der vom Endnutzer bereitgestellte Sicherheitsschlüssel gültig ist. true gibt an, dass der angegebene Sicherheitsschlüssel gültig ist. false gibt an, dass der angegebene Sicherheitsschlüssel ungültig ist.	boolean

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren des Webhooks für die Bestätigung in zwei Schritten für diese Komponente aufzurufen.

1. Öffnen Sie die Dialogflow CX-Konsole.
2. Wählen Sie Ihr Google Cloud-Projekt aus.
3. Wählen Sie den Agent aus.
4. Wählen Sie den Tab Verwalten.
5. Klicken Sie auf Webhooks.
6. Wählen Sie den Webhook „prebuilt_components_authentication:2fa_validation“ aus.
7. Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (Dialogflow CX) durch den Endpunkt des Dienstes, den Sie einbinden möchten. Wählen Sie im Drop-down-Menü die gewünschte Methode aus.
8. Prüfen und aktualisieren Sie den Request body, um das richtige Anfrageformat für Ihren Webhook zu erstellen.
9. Prüfen und aktualisieren Sie die Antwortkonfiguration, um bestimmte Felder aus der Antwort Ihres Webhooks zu extrahieren. Ändern Sie die Parameternamen nicht, da die Komponente diese für den Zugriff benötigt. den zurückgegebenen Feldwerten.
10. Prüfen und aktualisieren Sie die Authentifizierungseinstellungen nach Bedarf.
11. Klicken Sie auf Speichern.

Abgeschlossen

Der Agent und seine Webhooks sollten jetzt eingerichtet und zum Testen bereit sein.