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 de rol predeterminado.
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 de la organización, descripción, custom.data, etc.
Organization.Membership.Updated	Se agregan o eliminan usuarios o aplicaciones de una organización. El payload incluye campos delta de membresía.

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.

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
PUT /organizations/:id/applications	Organization.Membership.Updated
POST /organizations/:id/applications	Organization.Membership.Updated
DELETE /organizations/:id/applications/:applicationId	Organization.Membership.Updated
PUT /organization-invitations/:id/status (Accepted)	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 Experience API

Acción de interacción de usuario	Evento
Enlace de correo electrónico / teléfono del usuario	User.Data.Updated
Enlace de MFA del usuario	User.Data.Updated
Enlace social / SSO del usuario	User.Data.Updated
Restablecimiento de contraseña del usuario	User.Data.Updated
Registro de usuario	User.Created
Usuario aprovisionado automáticamente en una organización mediante aprovisionamiento Just-in-Time (dominio de correo coincidente o conector SSO empresarial)	Organization.Membership.Updated

Eventos de hook de excepción

Seguridad

Tipo de evento	Descripción
Identifier.Lockout	Una cuenta de usuario se bloquea debido a intentos consecutivos fallidos de verificación de identidad. Puede desencadenarse en los siguientes flujos: Fallo en la verificación de contraseña Fallo en la verificación de código Fallo en la verificación de token de un solo uso
Message.RateLimited	Un usuario final excede el límite de envío por destinatario para los códigos de verificación. Solo se activa en las rutas de envío para el usuario final (Experience API y Account API), con un payload de { action, recipient }.

Preguntas frecuentes

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

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