Webhooks 이벤트

이 가이드에서는 다양한 Logto Webhook 이벤트와 각 이벤트가 발생하는 시점을 설명합니다.

사용자 상호작용 훅 이벤트

이벤트 타입	설명
PostRegister	사용자가 UI 인터페이스를 통해 새 계정을 성공적으로 생성함.
PostSignIn	사용자가 UI 인터페이스를 통해 성공적으로 로그인함.
PostResetPassword	사용자가 "비밀번호 찾기" 플로우를 통해 비밀번호를 성공적으로 재설정함.

데이터 변경 훅 이벤트

사용자

이벤트 타입	설명
User.Created	새 사용자 계정이 생성됨.
User.Deleted	사용자 계정이 삭제됨.
User.Data.Updated	사용자 프로필 데이터가 업데이트됨 (예: 이메일, 아바타, custom.data, 소셜 식별자 등).
User.SuspensionStatus.Updated	사용자 정지 상태가 변경됨 (정지 또는 재활성화).

역할(Role)

이벤트 타입	설명
Role.Created	새 역할이 생성됨.
Role.Deleted	역할이 삭제됨.
Role.Data.Updated	역할 데이터가 업데이트됨 (예: 역할 이름, 설명, 기본 역할 상태).
Role.Scopes.Updated	역할에 할당된 권한이 추가되거나 제거됨.

권한(Permission, Scope)

이벤트 타입	설명
Scope.Created	새 API 권한이 생성됨.
Scope.Deleted	API 권한이 삭제됨.
Scope.Data.Updated	API 권한 데이터가 업데이트됨 (예: 권한 설명).

조직(Organization)

이벤트 타입	설명
Organization.Created	새 조직이 생성됨.
Organization.Deleted	조직이 삭제됨.
Organization.Data.Updated	조직 데이터가 업데이트됨 (예: 조직 이름, 설명, custom.data 등).
Organization.Membership.Updated	조직에 멤버가 추가되거나 제거됨.

조직 역할(Organization role)

이벤트 타입	설명
OrganizationRole.Created	새 조직 역할이 생성됨.
OrganizationRole.Deleted	조직 역할이 삭제됨.
OrganizationRole.Data.Updated	조직 역할 데이터가 업데이트됨 (예: 조직 역할 이름, 설명).
OrganizationRole.Scopes.Updated	조직 역할에 할당된 권한이 추가되거나 제거됨.

조직 권한(Organization permission, scope)

이벤트 타입	설명
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

예외 훅 이벤트

보안

이벤트 타입	설명
Identifier.Lockout	여러 번 로그인 실패로 인해 사용자 계정이 잠김.

자주 묻는 질문(FAQs)

PostRegister와 User.Created의 차이점은 무엇인가요?

PostRegister는 사용자가 사용자 가입 플로우를 통해 새 계정을 성공적으로 생성할 때 트리거됩니다. User.Created는 Management API를 통해 새 사용자 계정이 생성될 때 트리거됩니다.