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 del 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 a través del 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 añaden 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, 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 añaden o eliminan usuarios o aplicaciones de una organización. La carga útil 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 añaden 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, 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
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 del 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 a través de aprovisionamiento Just-in-Time (coincidencia de dominio de correo electrónico 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

Preguntas frecuentes

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

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