Webhooks-Ereignisse

Dieser Leitfaden listet die verschiedenen Logto Webhook-Ereignisse auf und erklärt, wann jedes Ereignis auftritt.

Benutzerinteraktions-Hook-Ereignisse

Ereignistyp	Beschreibung
PostRegister	Ein Benutzer erstellt erfolgreich ein neues Konto über die UI-Oberfläche.
PostSignIn	Ein Benutzer meldet sich erfolgreich über die UI-Oberfläche an.
PostResetPassword	Das Passwort eines Benutzers wird erfolgreich über den „Passwort vergessen“-Ablauf zurückgesetzt.

Datenmutations-Hook-Ereignisse

Benutzer

Ereignistyp	Beschreibung
User.Created	Ein neues Benutzerkonto wird erstellt.
User.Deleted	Ein Benutzerkonto wird gelöscht.
User.Data.Updated	Benutzerdaten werden aktualisiert, z. B. E-Mail, Avatar, custom.data, Social-Identifier usw.
User.SuspensionStatus.Updated	Der Sperrstatus eines Benutzers wird geändert (gesperrt oder reaktiviert).

Rolle

Ereignistyp	Beschreibung
Role.Created	Eine neue Rolle wird erstellt.
Role.Deleted	Eine Rolle wird gelöscht.
Role.Data.Updated	Die Daten einer Rolle werden aktualisiert, z. B. Rollenname, Beschreibung und Standardstatus.
Role.Scopes.Updated	Berechtigungen, die einer Rolle zugewiesen sind, werden hinzugefügt oder entfernt.

Berechtigung (Berechtigung)

Ereignistyp	Beschreibung
Scope.Created	Eine neue API-Berechtigung wird erstellt.
Scope.Deleted	Eine API-Berechtigung wird gelöscht.
Scope.Data.Updated	Die Daten einer API-Berechtigung werden aktualisiert, z. B. Beschreibung.

Organisation

Ereignistyp	Beschreibung
Organization.Created	Eine neue Organisation wird erstellt.
Organization.Deleted	Eine Organisation wird gelöscht.
Organization.Data.Updated	Die Daten einer Organisation werden aktualisiert, z. B. Name, Beschreibung, custom.data usw.
Organization.Membership.Updated	Mitglieder werden zu einer Organisation hinzugefügt oder entfernt.

Organisationsrolle

Ereignistyp	Beschreibung
OrganizationRole.Created	Eine neue Organisationsrolle wird erstellt.
OrganizationRole.Deleted	Eine Organisationsrolle wird gelöscht.
OrganizationRole.Data.Updated	Die Daten einer Organisationsrolle werden aktualisiert, z. B. Name und Beschreibung.
OrganizationRole.Scopes.Updated	Berechtigungen, die einer Organisationsrolle zugewiesen sind, werden hinzugefügt oder entfernt.

Organisationsberechtigung (Berechtigung)

Ereignistyp	Beschreibung
OrganizationScope.Created	Eine neue Organisationsberechtigung wird erstellt.
OrganizationScope.Deleted	Eine Organisationsberechtigung wird gelöscht.
OrganizationScope.Data.Updated	Die Daten einer Organisationsberechtigung werden aktualisiert, z. B. Beschreibung der Organisationsberechtigung.

Management API ausgelöste Ereignisse

API-Endpunkt	Ereignis
POST /users	User.Created
DELETE /users/:userId	User.Deleted
PATCH /users/:userId	User.Data.Updated
PATCH /users/:userId/custom-data	User.Data.Updated
PATCH /users/:userId/profile	User.Data.Updated
PATCH /users/:userId/password	User.Data.Updated
PATCH /users/:userId/is-suspended	User.SuspensionStatus.Updated
POST /roles	Role.Created, (Role.Scopes.Update)
DELETE /roles/:id	Role.Deleted
PATCH /roles/:id	Role.Data.Updated
POST /roles/:id/scopes	Role.Scopes.Updated
DELETE /roles/:id/scopes/:scopeId	Role.Scopes.Updated
POST /resources/:resourceId/scopes	Scope.Created
DELETE /resources/:resourceId/scopes/:scopeId	Scope.Deleted
PATCH /resources/:resourceId/scopes/:scopeId	Scope.Data.Updated
POST /organizations	Organization.Created
DELETE /organizations/:id	Organization.Deleted
PATCH /organizations/:id	Organization.Data.Updated
PUT /organizations/:id/users	Organization.Membership.Updated
POST /organizations/:id/users	Organization.Membership.Updated
DELETE /organizations/:id/users/:userId	Organization.Membership.Updated
POST /organization-roles	OrganizationRole.Created, (OrganizationRole.Scopes.Updated)
DELETE /organization-roles/:id	OrganizationRole.Deleted
PATCH /organization-roles/:id	OrganizationRole.Data.Updated
POST /organization-scopes	OrganizationScope.Created
DELETE /organization-scopes/:id	OrganizationScope.Deleted
PATCH /organization-scopes/:id	OrganizationScope.Data.Updated
PUT /organization-roles/:id/scopes	OrganizationRole.Scopes.Updated
POST /organization-roles/:id/scopes	OrganizationRole.Scopes.Updated
DELETE /organization-roles/:id/scopes/:organizationScopeId	OrganizationRole.Scopes.Updated

Interaction API ausgelöste Ereignisse

Benutzerinteraktionsaktion	Ereignis
Benutzer E-Mail/Telefon-Verknüpfung	User.Data.Updated
Benutzer MFA-Verknüpfung	User.Data.Updated
Benutzer Social/SSO-Verknüpfung	User.Data.Updated
Benutzer Passwort zurücksetzen	User.Data.Updated
Benutzerregistrierung	User.Created

Ausnahme-Hook-Ereignisse

Sicherheit

Ereignistyp	Beschreibung
Identifier.Lockout	Ein Benutzerkonto wird aufgrund mehrerer fehlgeschlagener Anmeldeversuche gesperrt.

FAQs

Was ist der Unterschied zwischen PostRegister und User.Created?

PostRegister wird ausgelöst, wenn ein Benutzer erfolgreich ein neues Konto über den Benutzerregistrierungsablauf erstellt; User.Created wird ausgelöst, wenn ein neues Benutzerkonto über die Management API erstellt wird.