Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Lambda-Auslöser für die Vorab-Registrierung
Möglicherweise möchten Sie den Anmeldevorgang in Benutzerpools anpassen, die über Self-Service-Anmeldeoptionen verfügen. Häufig wird der Trigger vor der Anmeldung verwendet, um benutzerdefinierte Analysen und Aufzeichnungen neuer Benutzer durchzuführen, Sicherheits- und Governance-Standards anzuwenden oder Benutzer von einem Drittanbieter-IdP mit einem konsolidierten Benutzerprofil zu verknüpfen. Möglicherweise haben Sie auch vertrauenswürdige Benutzer, die sich keiner Überprüfung und Bestätigung unterziehen müssen.
Unmittelbar bevor Amazon Cognito die Erstellung eines neuen lokalen oder Verbundbenutzers abschließt, aktiviert es die Lambda-Funktion vor der Anmeldung. Das userAttributes in der Anfrage an diese Funktion gesendete Objekt enthält Attribute, die bei der lokalen Benutzerregistrierung bereitgestellt wurden oder die erfolgreich den Anbieterattributen für einen Verbundbenutzer zugeordnet wurden. Ihr Benutzerpool ruft diesen Trigger bei der Self-Service-Registrierung SignUpoder der ersten Anmeldung bei einem vertrauenswürdigen Identitätsanbieter und bei der Benutzererstellung mit auf. AdminCreateUser Im Rahmen des Anmeldevorgangs können Sie diese Funktion verwenden, um das Anmeldeereignis mit benutzerdefinierter Logik zu analysieren und den neuen Benutzer zu ändern oder abzulehnen.
Themen
Lambda-Auslöserparameter für die Vorab-Registrierung
Die Anforderung, die Amazon Cognito an diese Lambda-Funktion übergibt, ist eine Kombination der folgenden Parameter und der allgemeinen Parameter, die Amazon Cognito allen Anfragen hinzufügt.
Anforderungsparameter für die Vorab-Registrierung
- userAttributes
-
Ein oder mehrere Name-Wert-Paare, die Benutzerattribute darstellen. Die Attributnamen sind die Schlüssel.
- validationData
-
Ein oder mehrere Schlüssel/Wert-Paare mit Benutzerattributdaten, die Ihre App in der Anfrage zur Erstellung eines neuen Benutzers an Amazon Cognito übergeben hat. Senden Sie diese Informationen im ValidationData Parameter Ihrer AdminCreateUseroder SignUpAPI-Anfrage an Ihre Lambda-Funktion.
Amazon Cognito legt Ihre ValidationData Daten nicht als Attribute des von Ihnen erstellten Benutzers fest. ValidationData sind temporäre Benutzerinformationen, die Sie für Ihren Lambda-Trigger vor der Registrierung angeben.
- clientMetadata
-
Ein oder mehrere Schlüssel-Wert-Paare, die Sie als benutzerdefinierte Eingabe für die Lambda-Funktion bereitstellen können, die Sie für den Auslöser für die Vorab-Registrierung angeben. Sie können diese Daten an Ihre Lambda-Funktion übergeben, indem Sie den ClientMetadata Parameter in den folgenden API-Aktionen verwenden: AdminCreateUser, AdminRespondToAuthChallengeForgotPassword, und SignUp.
Antwortparameter für die Vorab-Registrierung
In der Antwort können Sie autoConfirmUser auf true setzen, wenn der Benutzer automatisch bestätigt werden soll. Sie können die Einstellung autoVerifyEmail auf true setzen und somit die E-mail-Adresse des Benutzers automatisch überprüfen. Sie könne die Einstellung autoVerifyPhone auf true setzen und somit die Telefonnummer des Benutzers automatisch überprüfen.
Die Antwortparameter autoVerifyPhone, autoVerifyEmail und autoConfirmUser werden von Amazon Cognito ignoriert, wenn die Lambda-Funktion vor der Registrierung durch die AdminCreateUser-API ausgelöst wird.
- Auto ConfirmUser
-
Setzen Sie diesen Parameter auf
true, wenn der Benutzer automatisch bestätigt werden soll. Setzen Sie ihn andernfalls auffalse. - Auto VerifyEmail
-
Legen Sie diesen Parameter auf
truefest, um die Verifizierung der E-Mail-Adresse eines Benutzers, der sich gerade anmeldet, zu bestätigen. Legen Sie ihn andernfalls auffalsefest. FallsautoVerifyEmailauftruegesetzt ist, muss das Attributemaileinen gültigen Wert besitzen, bei dem es sich nicht um Null handeln darf. Andernfalls tritt ein Fehler auf und der Benutzer wird die Registrierung nicht abschließen können.Wenn das
emailAttribut als Alias ausgewählt ist, wird ein Alias für die E-Mail-Adresse des Benutzers erstellt, sobaldautoVerifyEmailes festgelegt ist. Wenn bereits ein Alias mit dieser E-Mail-Adresse existiert, wird der Alias auf den neuen Benutzer verschoben und die E-Mail-Adresse des vorherigen Benutzers wird als nicht bestätigt markiert. Weitere Informationen finden Sie unter Anpassen von Anmeldeattributen. - Auto VerifyPhone
-
Setzen Sie diesen Parameter auf
trueum die Verifizierung der Telefonnummer eines Benutzers, der sich grade anmeldet, zu bestätigen. Setzen Sie ihn andernfalls auffalse. FallsautoVerifyPhoneauftruegesetzt ist, muss das Attributphone_numbereinen gültigen Wert besitzen, bei dem es sich nicht um Null handeln darf. Andernfalls tritt ein Fehler auf und der Benutzer wird die Registrierung nicht abschließen können.Wenn das
phone_numberAttribut als Alias ausgewählt ist, wird ein Alias für die Telefonnummer des Benutzers erstellt, wennautoVerifyPhonees festgelegt ist. Wenn ein Alias mit dieser Telefonnummer bereits existiert, wird der Alias auf den neuen Benutzer verschoben und die Telefonnummer des vorherigen Benutzers wird als nicht bestätigt markiert. Weitere Informationen finden Sie unter Anpassen von Anmeldeattributen.
Beispiel vor der Registrierung: Auto-confirm Benutzer aus einer registrierten Domain
Dies ist ein Beispiel für einen Lambda-Triggercode. Der Trigger vor der Anmeldung wird unmittelbar vor der Verarbeitung der Registrierungsanfrage durch Amazon Cognito ausgelöst. Sie verwendet ein benutzerdefiniertes Attribut custom:domain, um neue Benutzer von einer bestimmten E-Mail-Domäne automatisch zu bestätigen. Alle neuen Benutzer, die sich nicht in der benutzerdefinierten Domain befinden, werden dem Benutzerpool hinzugefügt, aber nicht automatisch bestätigt.
Amazon Cognito übergibt Ereignisinformationen an Ihre Lambda-Funktion. Die Funktion gibt dann das gleiche Ereignisobjekt mit allen Änderungen in der Antwort an Amazon Cognito zurück. Sie können in der Lambda-Konsole ein Testereignis mit den für Ihren Lambda-Auslöser relevanten Daten einrichten. Das Folgende ist ein Testereignis für dieses Codebeispiel:
Beispiel vor der Anmeldung: Auto-confirm und automatische Überprüfung aller Benutzer
Dieses Beispiel bestätigt alle Benutzer und setzt die Attribute email und phone_number des Benutzers auf verifiziert, wenn das Attribut vorhanden ist. Wenn Aliasing aktiviert ist, werden Aliase außerdem für phone_number und email wenn die automatische Überprüfung aktiviert ist, erstellt.
Wenn bereits ein Alias mit derselben Telefonnummer existiert, wird der Alias auf den neuen Benutzer verschoben und der Alias des vorherigen Benutzers phone_number wird als nicht verifiziert markiert. Dies gilt auch für E-Mail-Adressen. Um dies zu verhindern, können Sie mithilfe der ListUsers Benutzerpools-API überprüfen, ob es einen bestehenden Benutzer gibt, der die Telefonnummer oder E-Mail-Adresse des neuen Benutzers bereits als Alias verwendet.
Amazon Cognito übergibt Ereignisinformationen an Ihre Lambda-Funktion. Die Funktion gibt dann das gleiche Ereignisobjekt mit allen Änderungen in der Antwort an Amazon Cognito zurück. Sie können in der Lambda-Konsole ein Testereignis mit den für Ihren Lambda-Auslöser relevanten Daten einrichten. Das Folgende ist ein Testereignis für dieses Codebeispiel:
Beispiel vor der Anmeldung: Verweigern Sie die Registrierung, wenn der Benutzername weniger als fünf Zeichen hat
In diesem Beispiel wird die Länge des Benutzernamens in einer Anmeldeanfrage überprüft. Das Beispiel gibt einen Fehler zurück, wenn der Benutzer einen Namen mit weniger als fünf Zeichen eingegeben hat.
Amazon Cognito übergibt Ereignisinformationen an Ihre Lambda-Funktion. Die Funktion gibt dann das gleiche Ereignisobjekt mit allen Änderungen in der Antwort an Amazon Cognito zurück. Sie können in der Lambda-Konsole ein Testereignis mit den für Ihren Lambda-Auslöser relevanten Daten einrichten. Das Folgende ist ein Testereignis für dieses Codebeispiel: