> 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/zh-hant/integrations/fireblocks.md).

# Fireblocks

本指南說明如何搭配 [Fireblocks](https://www.fireblocks.com/) 使用 Phalcon Compliance，篩查出站和入站交易的 AML/CFT 風險。結合這兩個平台後，您可以在執行出站交易前進行篩查，並在 Fireblocks 偵測到入站交易時進行監控。

## 先決條件

**基本設定的必要條件：**

* 擁有有效的 Phalcon Compliance 帳戶及 API 金鑰（請參閱 [API 金鑰](https://docs.compliance.phalcon.blocksec.com/zh-hant/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)）
* **手動篩查判定**，適用於手動處理入站判定的工作流程（請聯絡您的 Fireblocks 客戶成功經理以啟用此功能）

## 篩查出站交易

當您的組織透過 Fireblocks 傳送資金時，可以使用 Phalcon Compliance 在交易簽署並廣播**之前**，篩查目的地址。有兩種方法：

### 選項 1：透過 Phalcon API 預先篩查

在將交易提交至 Fireblocks 前，使用 Phalcon Compliance API 篩查目的地址。您的團隊可依據風險評估決定是否繼續。

**運作方式：**

1. 您的團隊透過 [篩查單一地址](https://docs.compliance.phalcon.blocksec.com/zh-hant/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://2458772471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLWwO7vpr6nNW5dAF9VOK%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/zh-hant/user-manual/configure/notification-channels.md)，在偵測到高風險地址時通知相關人員。

### 選項 2：使用回呼處理程式自動篩查

此方法使用 [API Co-Signer 回呼處理程式](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler)，將 Phalcon Compliance 直接整合至 Fireblocks 交易簽署工作流程。每筆出站交易都會在 Co-Signer 簽署前自動進行篩查。

**運作方式：**

1. 透過 Fireblocks API 發起交易。
2. 交易會經過 Fireblocks 交易授權政策 (TAP)。
3. 在您的環境中執行的 API Co-Signer 會從 Co-Signer Gateway 接收交易詳細資料。
4. Co-Signer 會將交易詳細資料轉送至您的**回呼處理程式**，這是您部署的自訂 HTTPS 伺服器。
5. 您的回呼處理程式會呼叫 [Phalcon Compliance API](https://docs.compliance.phalcon.blocksec.com/zh-hant/api-documentation/address-screening/screen-a-single-address.md) 來篩查目的地址。
6. 回呼處理程式會根據 Phalcon 的風險評估傳回決策：
   * **核准** — Co-Signer 會簽署交易，並將簽章傳送至 Co-Signer Gateway。
   * **拒絕** — Co-Signer 會取消交易。

<figure><img src="https://2458772471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLWwO7vpr6nNW5dAF9VOK%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 回呼處理程式說明文件](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler)。

## 篩查入站交易

當您的 Fireblocks 工作區收到資金時，可以使用 Phalcon Compliance 篩查寄件者地址並評估其風險。有兩種方法：

### 選項 1：透過 Webhook 自動篩查

將 Fireblocks Webhook 連接至 Phalcon Compliance，以自動篩查入站交易事件。您可以使用 Phalcon 提供的 Webhook 端點，或部署自己的 Webhook 伺服器來呼叫 [Phalcon Compliance API](https://docs.compliance.phalcon.blocksec.com/zh-hant/api-documentation/address-screening/screen-a-single-address.md)。

**運作方式：**

1. 設定 Webhook 端點以接收 Fireblocks 交易事件。您可以使用 Phalcon Compliance 提供的 Webhook URL，或部署自己的伺服器來呼叫 [Phalcon Compliance API](https://docs.compliance.phalcon.blocksec.com/zh-hant/api-documentation/address-screening/screen-a-single-address.md)。
2. 在 Fireblocks 工作區中註冊 Webhook URL（請參閱 [Fireblocks Webhook 說明文件](https://developers.fireblocks.com/reference/webhooks-overview)）。
3. 偵測到入站交易時，Fireblocks 會將事件傳送至 Webhook 端點。
4. 系統會解析事件，並由 Phalcon Compliance 篩查相關的寄件者地址。
5. 根據風險評估：
   * **偵測到風險** — Phalcon Compliance 會建立警示，供您的團隊檢視。
   * **未偵測到風險** — 系統會記錄篩查結果。無需採取進一步行動。

<figure><img src="https://2458772471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLWwO7vpr6nNW5dAF9VOK%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/zh-hant/user-manual/configure/notification-channels.md)，在偵測到風險時通知您的合規團隊。
* 如果您需要協助設定 Webhook 整合，請透過 ***<phalcon_support@blocksec.com>*** 聯絡我們。

### 進階：手動篩查判定

> 適用於要求手動審查並明確核准每筆入站交易的合規團隊。

{% hint style="warning" %}
此功能在 Fireblocks 中僅限部分使用者使用。請聯絡您的 Fireblocks 客戶成功經理，為您的工作區啟用手動篩查判定。
{% endhint %}

啟用手動篩查判定後，入站交易會維持在 `PENDING_SCREENING` 狀態，直到您的合規團隊提交判定為止。您的團隊會使用 Phalcon Compliance 評估風險，然後向 Fireblocks 提交判定。

**運作方式：**

1. 入站交易抵達您的 Fireblocks 工作區，並進入 `PENDING_SCREENING` 狀態。
2. 您的合規團隊會收到待處理交易通知。
3. 您的團隊會在 Phalcon Compliance 中篩查寄件者地址，並檢視風險評估。
4. 根據審查結果，您的團隊會向 Fireblocks API (`POST /aml/verdict/manual`) 提交判定：
   * **接受** — 交易會獲准進行處理。
   * **拒絕** — 交易會在 Fireblocks 中被標記並凍結。
5. 如果未在 **一小時**內提交判定，Fireblocks 會自動拒絕並凍結交易。

<figure><img src="https://2458772471-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLWwO7vpr6nNW5dAF9VOK%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>

**重點：**

* 手動篩查判定僅適用於入站交易。出站交易不受影響。
* Webhook 方法（選項 1）和手動篩查判定**不能同時使用** — 您必須選擇一種方法來篩查入站交易。
* 一小時的逾時期限可提供安全保障，但您的團隊仍應盡快完成審查並回覆。

## 後續步驟

* [風險引擎](https://docs.compliance.phalcon.blocksec.com/zh-hant/user-manual/configure/risk-engines.md)：為您的合規政策自訂風險門檻和指標。
* [通知管道](https://docs.compliance.phalcon.blocksec.com/zh-hant/user-manual/configure/notification-channels.md)：設定在偵測到高風險活動時發出的警示。
* [API 金鑰](https://docs.compliance.phalcon.blocksec.com/zh-hant/user-manual/account/api-keys.md)：產生 Phalcon Compliance API 的憑證。
* [API 說明文件](https://docs.compliance.phalcon.blocksec.com/zh-hant/api-documentation/introduction.md)：端點詳細資料及請求／回應範例。
