Événements Webhooks
Ce guide répertorie les différents événements de webhook Logto et explique quand chaque événement se produit.
Événements de hook d'interaction utilisateur
| Type d'événement | Description |
|---|---|
| PostRegister | Un utilisateur crée avec succès un nouveau compte via l'interface utilisateur. |
| PostSignIn | Un utilisateur se connecte avec succès via l'interface utilisateur. |
| PostResetPassword | Le mot de passe d'un utilisateur est réinitialisé avec succès via le flux "Mot de passe oublié". |
Événements de hook de mutation de données
Utilisateur
| Type d'événement | Description |
|---|---|
| User.Created | Un nouveau compte utilisateur est créé. |
| User.Deleted | Un compte utilisateur est supprimé. |
| User.Data.Updated | Les données du profil utilisateur sont mises à jour, par exemple, e-mail, avatar, custom.data, identifiant social, etc. |
| User.SuspensionStatus.Updated | Le statut de suspension de l'utilisateur est modifié (suspendu ou réactivé). |
Rôle
| Type d'événement | Description |
|---|---|
| Role.Created | Un nouveau rôle est créé. |
| Role.Deleted | Un rôle est supprimé. |
| Role.Data.Updated | Les données d'un rôle sont mises à jour, par exemple, nom du rôle, description et statut de rôle par défaut. |
| Role.Scopes.Updated | Les Permissions (Portées) attribuées à un rôle sont ajoutées ou supprimées. |
Permission (Portée)
| Type d'événement | Description |
|---|---|
| Scope.Created | Une nouvelle Permission (Portée) API est créée. |
| Scope.Deleted | Une Permission (Portée) API est supprimée. |
| Scope.Data.Updated | Les données d'une Permission (Portée) API sont mises à jour, par exemple, description de la permission. |
Organisation
| Type d'événement | Description |
|---|---|
| Organization.Created | Une nouvelle Organisation est créée. |
| Organization.Deleted | Une Organisation est supprimée. |
| Organization.Data.Updated | Les données d'une Organisation sont mises à jour, par exemple, nom de l'organisation, description, custom.data, etc. |
| Organization.Membership.Updated | Des membres sont ajoutés ou supprimés d'une Organisation. |
Rôle d'organisation
| Type d'événement | Description |
|---|---|
| OrganizationRole.Created | Un nouveau rôle d'organisation est créé. |
| OrganizationRole.Deleted | Un rôle d'organisation est supprimé. |
| OrganizationRole.Data.Updated | Les données d'un rôle d'organisation sont mises à jour, par exemple, nom et description du rôle d'organisation. |
| OrganizationRole.Scopes.Updated | Les Permissions (Portées) attribuées à un rôle d'organisation sont ajoutées ou supprimées. |
Permission d'organisation (Portée)
| Type d'événement | Description |
|---|---|
| OrganizationScope.Created | Une nouvelle Permission (Portée) d'organisation est créée. |
| OrganizationScope.Deleted | Une Permission (Portée) d'organisation est supprimée. |
| OrganizationScope.Data.Updated | Les données d'une Permission (Portée) d'organisation sont mises à jour, par exemple, description de la permission d'organisation. |
Événements déclenchés par Management API
| Point de terminaison API | Événement |
|---|---|
| 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 |
Événements déclenchés par Interaction API
| Action d'interaction utilisateur | Événement |
|---|---|
| Liaison d'e-mail / téléphone utilisateur | User.Data.Updated |
| Liaison des MFA utilisateur | User.Data.Updated |
| Liaison sociale / SSO utilisateur | User.Data.Updated |
| Réinitialisation du mot de passe utilisateur | User.Data.Updated |
| Inscription utilisateur | User.Created |
FAQs
Quelle est la différence entre PostRegister et User.Created ?
PostRegister est déclenché lorsqu'un utilisateur crée avec succès un nouveau compte via le flux d'inscription utilisateur ; User.Created est déclenché lorsqu'un nouveau compte utilisateur est créé via le Management API.