Webhooks-Ereignisse

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

Benutzerinteraktions-Hook-Ereignisse

Ereignistyp	Beschreibung
PostRegister	Ein Benutzer erstellt erfolgreich ein neues Konto über die Benutzeroberfläche.
PostSignIn	Ein Benutzer meldet sich erfolgreich über die Benutzeroberfläche an.
PostResetPassword	Das Passwort eines Benutzers wird erfolgreich über den "Passwort vergessen"-Fluss zurückgesetzt.

Datenänderungs-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, soziale Kennung, etc.
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 Standardrollenstatus.
Role.Scopes.Updated	Berechtigungen, die einer Rolle zugewiesen sind, werden hinzugefügt oder entfernt.

Berechtigung (Scope)

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. Berechtigungsbeschreibung.

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. Organisationsname, Beschreibung, custom.data, etc.
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. Organisationsrollenname und Beschreibung.
OrganizationRole.Scopes.Updated	Berechtigungen, die einer Organisationsrolle zugewiesen sind, werden hinzugefügt oder entfernt.

Organisationsberechtigung (Scope)

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. Organisationsberechtigungsbeschreibung.

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-MFAs-Verknüpfung	User.Data.Updated
Benutzer-Soziale/SSO-Verknüpfung	User.Data.Updated
Benutzer-Passwortzurücksetzung	User.Data.Updated
Benutzerregistrierung	User.Created

FAQs

Was ist der Unterschied zwischen PostRegister und User.Created?

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