> For the complete documentation index, see [llms.txt](https://docs.compliance.phalcon.blocksec.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.compliance.phalcon.blocksec.com/ko-kr/integrations/fireblocks.md).

# Fireblocks

이 가이드에서는 [Fireblocks](https://www.fireblocks.com/)와 [Phalcon Compliance](https://www.fireblocks.com/)를 함께 사용해 출금 및 입금 트랜잭션의 AML/CFT 위험을 심사하는 방법을 설명합니다. 두 플랫폼을 결합하면 트랜잭션 실행 전에 출금 트랜잭션을 심사하고, Fireblocks에서 감지된 입금 트랜잭션을 모니터링할 수 있습니다.

## 사전 요구 사항

**기본 설정에 필요:**

* API key가 있는 활성 Phalcon Compliance 계정([API 키](https://docs.compliance.phalcon.blocksec.com/ko-kr/user-manual/account/api-keys.md) 참조)
* Webhook 또는 API 액세스 권한이 있는 Fireblocks 워크스페이스

**고급 설정에만 필요:**

* 콜백 핸들러를 통해 출금 트랜잭션을 자동으로 심사하기 위한 **API Co-Signer**([Fireblocks Co-Signer 개요](https://developers.fireblocks.com/docs/use-cosigners-for-signing-automation) 참조)
* 수동 입금 판정 워크플로를 위한 **Manual Screening Verdicts**(이 기능을 활성화하려면 Fireblocks Customer Success Manager에게 문의)

## 출금 트랜잭션 심사

조직에서 Fireblocks를 통해 자금을 전송할 때 트랜잭션에 서명하고 브로드캐스트하기 **전에** Phalcon Compliance를 사용해 대상 주소를 심사할 수 있습니다. 방법은 두 가지입니다.

### 옵션 1: Phalcon API를 통한 사전 심사

Fireblocks에 트랜잭션을 제출하기 전에 Phalcon Compliance API를 사용해 대상 주소를 심사합니다. 위험 평가를 바탕으로 팀에서 진행 여부를 결정합니다.

**작동 방식:**

1. 팀에서 [단일 주소 심사](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/address-screening/screen-a-single-address.md) API 또는 Phalcon 대시보드를 통해 대상 주소를 Phalcon Compliance에 제출합니다.
2. Phalcon Compliance에서 위험 수준, 위험 지표 및 노출 세부 정보를 포함한 위험 평가를 반환합니다.
3. 팀에서 결과를 검토하고 내부 컴플라이언스 정책에 따라 결정합니다.
   * **허용할 수 없는 위험** — 트랜잭션을 거부합니다. Fireblocks에 제출하지 마세요.
   * **허용 가능한 위험** — Fireblocks에서 트랜잭션을 생성합니다.
4. 승인되면 Fireblocks API 또는 콘솔을 통해 트랜잭션을 Fireblocks에 제출합니다.

<figure><img src="https://738662694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmQV7l2sGQOENPKPFUI8o%2Fuploads%2Fgit-blob-510225c099a70cfdc6aa2f3c3295359e4fd524d6%2Ffireblocks-outgoing-option1-pre-screening.png?alt=media" alt="Outgoing transaction pre-screening flow: You screen the address through Phalcon Compliance before submitting the transaction to Fireblocks"><figcaption><p>Pre-screening flow: screen the destination address through Phalcon before submitting the transaction to Fireblocks.</p></figcaption></figure>

**주요 사항:**

* 추가 인프라가 필요하지 않습니다. Phalcon API 키만 있으면 됩니다.
* Phalcon의 [알림 채널](https://docs.compliance.phalcon.blocksec.com/ko-kr/user-manual/configure/notification-channels.md)을 구성하여 고위험 주소가 감지되면 관련 담당자에게 알릴 수 있습니다.

### 옵션 2: 콜백 핸들러를 사용한 자동 심사

이 방법은 [API Co-Signer Callback Handler](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler)를 사용해 Phalcon Compliance를 Fireblocks 트랜잭션 서명 워크플로에 직접 통합합니다. 모든 출금 트랜잭션은 Co-Signer가 서명하기 전에 자동으로 심사됩니다.

**작동 방식:**

1. Fireblocks API를 통해 트랜잭션을 시작합니다.
2. 트랜잭션이 Fireblocks Transaction Authorization Policy(TAP)를 통과합니다.
3. 사용자 환경에서 실행 중인 API Co-Signer가 Co-Signer Gateway로부터 트랜잭션 세부 정보를 받습니다.
4. Co-Signer가 트랜잭션 세부 정보를 사용자가 배포한 맞춤형 HTTPS 서버인 **콜백 핸들러**로 전달합니다.
5. 콜백 핸들러가 [Phalcon Compliance API](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/address-screening/screen-a-single-address.md)를 호출해 대상 주소를 심사합니다.
6. Phalcon의 위험 평가를 바탕으로 콜백 핸들러가 다음 판정을 반환합니다.
   * **승인** — Co-Signer가 트랜잭션에 서명하고 서명을 Co-Signer Gateway로 전송합니다.
   * **거부** — Co-Signer가 트랜잭션을 취소합니다.

<figure><img src="https://738662694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmQV7l2sGQOENPKPFUI8o%2Fuploads%2Fgit-blob-38672a87ea0db3d283458130f5e2478f84893be7%2Ffireblocks-outgoing-option2-callback-handler.png?alt=media" alt="Automated outgoing transaction screening flow: Callback Handler integrates Phalcon Compliance into the Fireblocks Co-Signer signing process"><figcaption><p>Automated screening flow: the Callback Handler screens transactions through Phalcon Compliance before the Co-Signer signs.</p></figcaption></figure>

**주요 사항:**

* API Co-Signer는 콜백 핸들러에서 **30초** 이내에 응답을 받아야 합니다.
* 콜백 핸들러의 위험 임계값 로직을 완전히 제어할 수 있습니다.
* Co-Signer 구성에 대한 자세한 내용은 [Fireblocks Callback Handler 문서](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler)를 참조하세요.

## 입금 트랜잭션 심사

Fireblocks 워크스페이스에서 자금을 받으면 Phalcon Compliance를 사용해 송신자 주소를 심사하고 위험을 평가할 수 있습니다. 방법은 두 가지입니다.

### 옵션 1: Webhook을 통한 자동 심사

Fireblocks webhook을 Phalcon Compliance에 연결하여 입금 트랜잭션 이벤트를 자동으로 심사합니다. Phalcon에서 제공하는 webhook 엔드포인트를 사용하거나, [Phalcon Compliance API](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/address-screening/screen-a-single-address.md)를 호출하는 자체 webhook 서버를 배포할 수 있습니다.

**작동 방식:**

1. Fireblocks 트랜잭션 이벤트를 수신할 webhook 엔드포인트를 설정합니다. Phalcon Compliance에서 제공하는 webhook URL을 사용하거나, [Phalcon Compliance API](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/address-screening/screen-a-single-address.md)를 호출하는 자체 서버를 배포할 수 있습니다.
2. Fireblocks 워크스페이스에 webhook URL을 등록합니다([Fireblocks Webhooks 문서](https://developers.fireblocks.com/reference/webhooks-overview) 참조).
3. 입금 트랜잭션이 감지되면 Fireblocks에서 이벤트를 webhook 엔드포인트로 전송합니다.
4. 이벤트를 파싱한 후 관련 송신자 주소를 Phalcon Compliance로 심사합니다.
5. 위험 평가를 바탕으로 다음과 같이 처리합니다.
   * **위험 감지** — 팀에서 검토할 수 있도록 Phalcon Compliance에 알림이 생성됩니다.
   * **위험 미감지** — 심사 결과가 기록됩니다. 추가 조치는 필요하지 않습니다.

<figure><img src="https://738662694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmQV7l2sGQOENPKPFUI8o%2Fuploads%2Fgit-blob-946b6cf09c4c4be65219e737bd51a2b129fbb426%2Ffireblocks-incoming-option1-webhook.png?alt=media" alt="Automated incoming transaction screening flow: Fireblocks sends events to Phalcon Compliance via webhook for screening"><figcaption><p>Automated incoming screening: Fireblocks sends transaction events to Phalcon Compliance for screening.</p></figcaption></figure>

**주요 사항:**

* 심사는 Phalcon Compliance에서 구성한 위험 엔진 및 임계값을 기준으로 합니다.
* 위험이 감지되면 컴플라이언스 팀에 알리도록 [알림 채널](https://docs.compliance.phalcon.blocksec.com/ko-kr/user-manual/configure/notification-channels.md)을 구성하세요.
* webhook 통합 설정에 도움이 필요하면 \_**<phalcon_support@blocksec.com>**\_으로 문의하세요.

### 고급: Manual Screening Verdicts

> 모든 입금 트랜잭션에 대해 수동 검토와 명시적 승인이 필요한 컴플라이언스 팀을 위한 기능입니다.

{% hint style="warning" %}
이 기능은 Fireblocks에서 제한적으로 제공됩니다. 워크스페이스에서 Manual Screening Verdicts를 활성화하려면 Fireblocks Customer Success Manager에게 문의하세요.
{% endhint %}

Manual Screening Verdicts가 활성화되면 컴플라이언스 팀에서 판정을 제출할 때까지 입금 트랜잭션은 `PENDING_SCREENING` 상태로 유지됩니다. 팀에서 Phalcon Compliance를 사용해 위험을 평가한 다음 Fireblocks에 판정을 제출합니다.

**작동 방식:**

1. 입금 트랜잭션이 Fireblocks 워크스페이스에 도착하여 `PENDING_SCREENING` 상태로 전환됩니다.
2. 컴플라이언스 팀에 보류 중인 트랜잭션이 있음을 알립니다.
3. 팀에서 Phalcon Compliance로 송신자 주소를 심사하고 위험 평가를 검토합니다.
4. 검토 결과에 따라 팀에서 Fireblocks API(`POST /aml/verdict/manual`)에 판정을 제출합니다.
   * **수락** — 트랜잭션이 처리되도록 해제됩니다.
   * **거부** — 트랜잭션에 플래그가 지정되고 Fireblocks에서 동결됩니다.
5. **1시간** 이내에 판정이 제출되지 않으면 Fireblocks가 트랜잭션을 자동으로 거부하고 동결합니다.

<figure><img src="https://738662694-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmQV7l2sGQOENPKPFUI8o%2Fuploads%2Fgit-blob-ff841d6e61f27e4c54e709879510fda256561c60%2Ffireblocks-incoming-option2-manual-verdict.png?alt=media" alt="Manual incoming transaction screening flow: Compliance team reviews in Phalcon Compliance and submits a verdict to Fireblocks"><figcaption><p>Manual screening: your compliance team reviews the risk in Phalcon Compliance and submits a verdict to Fireblocks.</p></figcaption></figure>

**주요 사항:**

* Manual Screening Verdicts는 입금 트랜잭션에만 적용됩니다. 출금 트랜잭션에는 영향을 주지 않습니다.
* webhook 방식(옵션 1)과 Manual Screening Verdicts는 **동시에 사용할 수 없습니다**. 입금 트랜잭션 심사 방법은 하나를 선택해야 합니다.
* 1시간 시간 초과는 안전장치 역할을 하지만, 팀에서는 신속하게 검토하고 응답해야 합니다.

## 다음 단계

* [위험 엔진](https://docs.compliance.phalcon.blocksec.com/ko-kr/user-manual/configure/risk-engines.md): 컴플라이언스 정책에 맞게 위험 임계값과 지표를 맞춤 설정합니다.
* [알림 채널](https://docs.compliance.phalcon.blocksec.com/ko-kr/user-manual/configure/notification-channels.md): 고위험 활동이 감지되면 알림을 받도록 설정합니다.
* [API 키](https://docs.compliance.phalcon.blocksec.com/ko-kr/user-manual/account/api-keys.md): Phalcon Compliance API에 사용할 자격 증명을 생성합니다.
* [API 문서](https://docs.compliance.phalcon.blocksec.com/ko-kr/api-documentation/introduction.md): 엔드포인트 세부 정보와 요청/응답 예시를 확인합니다.
