Webhooks 이벤트
이 가이드는 다양한 Logto Webhook 이벤트를 나열하고 각 이벤트가 발생하는 시점을 설명합니다.
사용자 상호작용 훅 이벤트
| 이벤트 유형 | 설명 |
|---|---|
| PostRegister | 사용자가 UI 인터페이스를 통해 새 계정을 성공적으로 생성합니다. |
| PostSignIn | 사용자가 UI 인터페이스를 통해 성공적으로 로그인합니다. |
| PostResetPassword | 사용자의 비밀번호가 "비밀번호 찾기" 흐름을 통해 성공적으로 재설정됩니다. |
데이터 변형 훅 이벤트
사용자
| 이벤트 유형 | 설명 |
|---|---|
| User.Created | 새 사용자 계정이 생성됩니다. |
| User.Deleted | 사용자 계정이 삭제됩니다. |
| User.Data.Updated | 사용자 프로필 데이터가 업데이트됩니다. 예: 이메일, 아바타, custom.data, 소셜 식별자 등. |
| User.SuspensionStatus.Updated | 사용자 정지 상태가 변경됩니다 (정지 또는 재활성화). |
역할
| 이벤트 유형 | 설명 |
|---|---|
| Role.Created | 새 역할이 생성됩니다. |
| Role.Deleted | 역할이 삭제됩니다. |
| Role.Data.Updated | 역할의 데이터가 업데이트됩니다. 예: 역할 이름, 설명, 기본 역할 상태. |
| Role.Scopes.Updated | 역할에 할당된 권한이 추가되거나 제거됩니다. |
권한 (스코프)
| 이벤트 유형 | 설명 |
|---|---|
| Scope.Created | 새 API 권한이 생성됩니다. |
| Scope.Deleted | API 권한이 삭제됩니다. |
| Scope.Data.Updated | API 권한의 데이터가 업데이트됩니다. 예: 권한 설명. |
조직
| 이벤트 유형 | 설명 |
|---|---|
| Organization.Created | 새 조직이 생성됩니다. |
| Organization.Deleted | 조직이 삭제됩니다. |
| Organization.Data.Updated | 조직의 데이터가 업데이트됩니다. 예: 조직 이름, 설명, custom.data 등. |
| Organization.Membership.Updated | 조직에 멤버가 추가되거나 제거됩니다. |
조직 역할
| 이벤트 유형 | 설명 |
|---|---|
| OrganizationRole.Created | 새 조직 역할이 생성됩니다. |
| OrganizationRole.Deleted | 조직 역할이 삭제됩니다. |
| OrganizationRole.Data.Updated | 조직 역할의 데이터가 업데이트됩니다. 예: 조직 역할 이름 및 설명. |
| OrganizationRole.Scopes.Updated | 조직 역할에 할당된 권한이 추가되거나 제거됩니다. |
조직 권한 (스코프)
| 이벤트 유형 | 설명 |
|---|---|
| OrganizationScope.Created | 새 조직 권한이 생성됩니다. |
| OrganizationScope.Deleted | 조직 권한이 삭제됩니다. |
| OrganizationScope.Data.Updated | 조직 권한의 데이터가 업데이트됩니다. 예: 조직 권한 설명. |
Management API 트리거 이벤트
| API 엔드포인트 | 이벤트 |
|---|---|
| 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 트리거 이벤트
| 사용자 상호작용 액션 | 이벤트 |
|---|---|
| 사용자 이메일 / 전화 연결 | User.Data.Updated |
| 사용자 MFA 연결 | User.Data.Updated |
| 사용자 소셜 / SSO 연결 | User.Data.Updated |
| 사용자 비밀번호 재설정 | User.Data.Updated |
| 사용자 등록 | User.Created |
자주 묻는 질문
PostRegister와 User.Created의 차이점은 무엇인가요?
PostRegister와 User.Created의 차이점은 무엇인가요?PostRegister는 사용자가 사용자 가입 흐름을 통해 새 계정을 성공적으로 생성할 때 트리거됩니다. User.Created는 Management API를 통해 새 사용자 계정이 생성될 때 트리거됩니다.