> ## Documentation Index
> Fetch the complete documentation index at: https://developers.argosidentity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 웹훅 이벤트

> ARGOS ID Check의 KYC 프로세스 상태 변경을 실시간으로 확인하세요. 웹훅을 통해 즉각적인 업데이트를 받아볼 수 있습니다.

## 웹훅이란?

웹훅은 특정 이벤트가 발생했을 때 실시간으로 알림을 받을 수 있는 기능입니다. KYC 데이터가 변경되거나 새로운 정보가 추가될 때마다 지정된 URL로 자동으로 알림을 보냅니다.

## 1. 웹훅 이벤트 타입을 알아보세요

ARGOS Identity 웹훅으로 다음과 같은 실시간 업데이트를 받아보세요.

* "webhook\_trigger": "created" → 서브미션이 **생성**된 경우
* "webhook\_trigger": "retry" → 진행간에 **재시도**가 발생된 경우
* "webhook\_trigger": "approved" → 서브미션이 **승인**된 경우
* "webhook\_trigger": "rejected" → 서브미션이 **거절**된 경우
* "webhook\_trigger": "submit" → 서브미션 상태가 **보류**(pending)된 경우
* "webhook\_trigger": "updated" → 서브미션이 **업데이트** 된 경우
* "webhook\_trigger": "delete" → 서브미션이 **삭제**된 경우
* "webhook\_trigger": "token\_expired" → Token ID가 **만료**된 경우
* "webhook\_trigger": "injection" → 서브미션에 **Injection** 이 진행된 경우
* "webhook\_trigger": "aml" → **aml** 프로세스가 진행된 경우
* "webhook\_trigger": "aml\_monitor" → **aml\_monitor** 프로세스가 진행된 경우

<Frame>
  <img src="https://mintcdn.com/argosidentity/gDv-DKVP2ULRdP9P/images/webhook_event_updated_0527_kr.png?fit=max&auto=format&n=gDv-DKVP2ULRdP9P&q=85&s=0c1f048b5e2023120d22128a3c50dd3b" alt="Webhook Description" className="block dark:hidden" width="2735" height="1417" data-path="images/webhook_event_updated_0527_kr.png" />

  <img src="https://mintcdn.com/argosidentity/gDv-DKVP2ULRdP9P/images/webhook_event_updated_0527_kr_dark.png?fit=max&auto=format&n=gDv-DKVP2ULRdP9P&q=85&s=300d63b0b3ec39b340db5b47e0bbd6a0" alt="Webhook Description Dark Theme" className="hidden dark:block" width="2735" height="1417" data-path="images/webhook_event_updated_0527_kr_dark.png" />
</Frame>

<CardGroup cols={4}>
  <Card title="Approved" icon="badge-check" href="/ko/idcheck/webhooks/idcheck-approved" />

  <Card title="Rejected" icon="ban" href="/ko/idcheck/webhooks/idcheck-rejected" />

  <Card title="Updated" icon="pen-to-square" href="/ko/idcheck/webhooks/idcheck-updated" />

  <Card title="Delete" icon="trash" href="/ko/idcheck/webhooks/idcheck-delete" />

  <Card title="Submit" icon="plus" href="/ko/idcheck/webhooks/idcheck-submit" />

  <Card title="Token expired" icon="clock" href="/ko/idcheck/webhooks/idcheck-token" />

  <Card title="Data injection" icon="table" href="/ko/idcheck/webhooks/idcheck-injection" />

  <Card title="AML 검색 결과" icon="radar" href="/ko/idcheck/webhooks/idcheck-aml-result" />

  <Card title="AML 온고잉 모니터링 결과" icon="magnifying-glass" iconType="regular" href="/ko/idcheck/webhooks/idcheck-aml-ongoing-result" />
</CardGroup>

웹훅을 활용하면 KYC 프로세스의 모든 단계를 실시간으로 모니터링하고, 필요한 조치를 즉시 취할 수 있어 고객 온보딩 프로세스를 더욱 효율적으로 관리할 수 있습니다.

## 2. 웹훅 이벤트를 등록하세요

<img height="200" src="https://mintcdn.com/argosidentity/gDv-DKVP2ULRdP9P/images/webhooks/webhook.png?fit=max&auto=format&n=gDv-DKVP2ULRdP9P&q=85&s=5ea2eb7ddfd99c77c77c67922da0a16e" data-path="images/webhooks/webhook.png" />

<Steps>
  <Step title="대시보드 로그인">
    ID Check [대시보드](https://idcheck.argosidentity.com/)에 로그인합니다.
  </Step>

  <Step title="설정 메뉴 접근">
    대시보드 상단 네비게이션 바에서 `설정` 메뉴를 클릭합니다.
  </Step>

  <Step title="Access Management 페이지 이동">
    좌측 사이드바의 `General` 섹션에서 `Access Management`를 선택합니다.
  </Step>

  <Step title="웹훅 URL 입력">
    `Webhook URL` 섹션을 찾아 입력 필드에 원하는 웹훅 주소를 입력합니다. 입력한 URL은 `HTTPS` 프로토콜을 사용해야 하며, 유효한 형식이어야 합니다.
  </Step>

  <Step title="설정 저장">
    페이지 하단의 `저장` 버튼을 클릭하여 변경사항을 적용합니다.
  </Step>
</Steps>

## 3. 안전한 데이터 전송을 위한 암호화 옵션을 활성화하세요

ARGOS Identity는 웹훅을 통해 전송되는 민감한 KYC 데이터를 보호하기 위해 암호화 옵션을 제공합니다. 이 기능을 활성화하면 모든 웹훅 데이터가 자동으로 암호화되어 더욱 안전한 정보 교환이 가능해집니다.

### a. 암호화된 웹훅 데이터는 어떤 모습인가요?

암호화가 적용된 웹훅 응답은 다음과 같은 형식으로 전달됩니다:

```json data-encrpyted.json theme={null}
{
  "response": {
    "body": "encrypted-string"
  }
}
```

여기서 `encrypted-string`은 원본 데이터를 암호화한 결과입니다.

### b. 암호화 옵션을 쉽게 설정하세요

<img height="200" src="https://mintcdn.com/argosidentity/gDv-DKVP2ULRdP9P/images/webhooks/secure-data-transfer.png?fit=max&auto=format&n=gDv-DKVP2ULRdP9P&q=85&s=17f85989f6708a12d1ad4dcfaff574f5" data-path="images/webhooks/secure-data-transfer.png" />

<Steps>
  <Step title="대시보드 로그인">
    ID Check [대시보드](https://idcheck.argosidentity.com/)에 로그인합니다.
  </Step>

  <Step title="설정 메뉴 접근">
    대시보드 상단 네비게이션 바에서 `설정` 메뉴를 클릭합니다.
  </Step>

  <Step title="Access Management 페이지 이동">
    좌측 사이드바의 `General` 섹션에서 `Access Management`를 선택합니다.
  </Step>

  <Step title="안전한 데이터 전송 옵션 활성화">
    안전한 데이터 전송" 옵션을 켭니다.
  </Step>

  <Step title="설정 저장">
    페이지 하단의 `저장` 버튼을 클릭하여 변경사항을 적용합니다.
  </Step>
</Steps>

이제 모든 웹훅 데이터가 암호화되어 전송되므로, KYC 프로세스의 각 단계에서 발생하는 중요한 정보를 더욱 안전하게 주고받을 수 있습니다.