웹훅 개요
웹훅은 Challenge 상태 변경 및 확인 결과와 같은 k-ID의 중요한 이벤트에 대해 서버에 알립니다. 각 제품에 대해 Compliance Studio의 개발자 설정에서 웹훅 URL 및 비밀을 구성하세요.
페이로드에는 eventType과 data 객체가 포함됩니다. 페이로드 스키마는 이벤트 유형을 참조하세요.
이벤트 유형
| 이벤트 유형 | 설명 |
|---|---|
Challenge.StateChange | 부모 동의 Challenge가 상태를 변경할 때 발생 |
Verification.Result | 확인 시도 결과와 함께 발생 |
Account.Delete | 계정이 삭제될 때 발생 |
AgeAssurance.Result | 연령 보증 평가 결과와 함께 발생(더 이상 사용되지 않음, Verification.Result로 대체됨) |
ParentalConsent.Granted | 부모 동의가 부여될 때 발생 |
Session.ChangePermissions | 부모가 세션 권한을 수정할 때 발생 |
Session.Delete | 세션이 삭제될 때 발생 |
Test | 웹훅이 올바르게 작동하는지 확인하는 데 사용 |
서명 검증
구성된 웹훅 비밀을 사용하여 웹훅 요청을 검증하세요.
헤더
각 요청과 함께 전송되는 헤더:
X-Signature-Timestamp: UNIX epoch 초X-Signature-Hmac-Sha256: (타임스탬프 + 원시 본문)의 HMAC SHA-256, 웹훅 비밀을 키로 사용, 16진수 인코딩(소문자)
예상 동작
- 유효한 서명에 대해
200반환 - 잘못된 서명에 대해
401반환
구현 세부 사항은 웹훅 요청 검증을 참조하세요.