Eventos de Webhooks

Esta guía enumera los diferentes eventos de webhook de Logto y explica cuándo ocurre cada evento.

Eventos de hook de interacción de usuario

Tipo de evento	Descripción
PostRegister	Un usuario crea exitosamente una nueva cuenta a través de la interfaz de usuario.
PostSignIn	Un usuario inicia sesión exitosamente a través de la interfaz de usuario.
PostResetPassword	La contraseña de un usuario se restablece exitosamente mediante el flujo de "Olvidé mi contraseña".

Eventos de hook de mutación de datos

Usuario

Tipo de evento	Descripción
User.Created	Se crea una nueva cuenta de usuario.
User.Deleted	Se elimina una cuenta de usuario.
User.Data.Updated	Se actualizan los datos del perfil del usuario, por ejemplo, correo electrónico, avatar, custom.data, identificador social, etc.
User.SuspensionStatus.Updated	Se cambia el estado de suspensión del usuario (suspendido o reactivado).

Rol

Tipo de evento	Descripción
Role.Created	Se crea un nuevo rol.
Role.Deleted	Se elimina un rol.
Role.Data.Updated	Se actualizan los datos de un rol, por ejemplo, nombre del rol, descripción y estado por defecto.
Role.Scopes.Updated	Se agregan o eliminan permisos asignados a un rol.

Permiso (Alcance)

Tipo de evento	Descripción
Scope.Created	Se crea un nuevo permiso de API.
Scope.Deleted	Se elimina un permiso de API.
Scope.Data.Updated	Se actualizan los datos de un permiso de API, por ejemplo, la descripción del permiso.

Organización

Tipo de evento	Descripción
Organization.Created	Se crea una nueva organización.
Organization.Deleted	Se elimina una organización.
Organization.Data.Updated	Se actualizan los datos de una organización, por ejemplo, nombre, descripción, custom.data, etc.
Organization.Membership.Updated	Se agregan o eliminan miembros de una organización.

Rol de organización

Tipo de evento	Descripción
OrganizationRole.Created	Se crea un nuevo rol de organización.
OrganizationRole.Deleted	Se elimina un rol de organización.
OrganizationRole.Data.Updated	Se actualizan los datos de un rol de organización, por ejemplo, nombre y descripción del rol de organización.
OrganizationRole.Scopes.Updated	Se agregan o eliminan permisos asignados a un rol de organización.

Permiso de organización (alcance)

Tipo de evento	Descripción
OrganizationScope.Created	Se crea un nuevo permiso de organización.
OrganizationScope.Deleted	Se elimina un permiso de organización.
OrganizationScope.Data.Updated	Se actualizan los datos de un permiso de organización, por ejemplo, la descripción del permiso de organización.

Eventos desencadenados por Management API

Endpoint de API	Evento
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

Eventos desencadenados por Interaction API

Acción de interacción de usuario	Evento
Enlace de correo/teléfono de usuario	User.Data.Updated
Enlace de MFA de usuario	User.Data.Updated
Enlace social/SSO de usuario	User.Data.Updated
Restablecimiento de contraseña de usuario	User.Data.Updated
Registro de usuario	User.Created

Eventos de hook de excepción

Seguridad

Tipo de evento	Descripción
Identifier.Lockout	Una cuenta de usuario se bloquea debido a múltiples intentos fallidos de inicio de sesión.

Preguntas frecuentes

¿Cuál es la diferencia entre PostRegister y User.Created?

PostRegister se activa cuando un usuario crea exitosamente una nueva cuenta a través del flujo de registro de usuario; User.Created se activa cuando se crea una nueva cuenta de usuario a través de la Management API.