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

# Fireblocks

このガイドでは、Phalcon Complianceを[Fireblocks](https://www.fireblocks.com/)と連携して使用し、送受信トランザクションをAML/CFTリスクについてスクリーニングする方法を説明します。2つのプラットフォームを組み合わせることで、送信トランザクションを実行前にスクリーニングし、Fireblocksで検知された受信トランザクションをモニタリングできます。

## 前提条件

**基本設定に必要なもの:**

* APIキーを持つ有効なPhalcon Complianceアカウント（[APIキー](https://docs.compliance.phalcon.blocksec.com/ja/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のカスタマーサクセスマネージャーにお問い合わせください）

## 送信トランザクションのスクリーニング

組織がFireblocksを通じて資金を送金する場合、トランザクションへの署名とブロードキャストの**前に**、Phalcon Complianceを使用して宛先アドレスをスクリーニングできます。方法は2つあります。

### 方法1: Phalcon APIによる事前スクリーニング

Fireblocksにトランザクションを送信する前に、Phalcon Compliance APIを使用して宛先アドレスをスクリーニングします。リスク評価に基づき、続行するかどうかをチームが判断します。

**仕組み:**

1. チームが[単一アドレスをスクリーニング](https://docs.compliance.phalcon.blocksec.com/ja/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://546960952-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiXFespN0LhxR1F1qvQ2F%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/ja/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 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/ja/api-documentation/address-screening/screen-a-single-address.md)を呼び出して、宛先アドレスをスクリーニングします。
6. Phalconのリスク評価に基づき、コールバックハンドラーが判定を返します。
   * **承認** — Co-Signerがトランザクションに署名し、署名をCo-Signer Gatewayに送信します。
   * **拒否** — Co-Signerがトランザクションをキャンセルします。

<figure><img src="https://546960952-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiXFespN0LhxR1F1qvQ2F%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を使用して送信元アドレスをスクリーニングし、そのリスクを評価できます。方法は2つあります。

### 方法1: Webhookによる自動スクリーニング

FireblocksのWebhookをPhalcon Complianceに接続して、受信トランザクションイベントを自動的にスクリーニングします。Phalconが提供するWebhookエンドポイントを使用するか、[Phalcon Compliance API](https://docs.compliance.phalcon.blocksec.com/ja/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/ja/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://546960952-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiXFespN0LhxR1F1qvQ2F%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/ja/user-manual/configure/notification-channels.md)を設定してください。
* Webhook連携の設定についてサポートが必要な場合は、***<phalcon_support@blocksec.com>*** までお問い合わせください。

### 高度な設定: 手動スクリーニング判定

> 受信するすべてのトランザクションについて、手動での確認と明示的な承認を必要とするコンプライアンスチーム向けです。

{% hint style="warning" %}
この機能はFireblocksで利用が制限されています。ワークスペースでManual Screening Verdictsを有効にするには、Fireblocksのカスタマーサクセスマネージャーにお問い合わせください。
{% 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://546960952-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FiXFespN0LhxR1F1qvQ2F%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つ選択する必要があります。
* 1時間のタイムアウトは安全策となりますが、チームは速やかに確認して対応するよう努めてください。

## 次のステップ

* [リスクエンジン](https://docs.compliance.phalcon.blocksec.com/ja/user-manual/configure/risk-engines.md): コンプライアンスポリシーに合わせてリスクのしきい値とインジケーターをカスタマイズします。
* [通知チャネル](https://docs.compliance.phalcon.blocksec.com/ja/user-manual/configure/notification-channels.md): 高リスクのアクティビティが検知された際のアラートを設定します。
* [APIキー](https://docs.compliance.phalcon.blocksec.com/ja/user-manual/account/api-keys.md): Phalcon Compliance APIの認証情報を生成します。
* [APIドキュメント](https://docs.compliance.phalcon.blocksec.com/ja/api-documentation/introduction.md): エンドポイントの詳細とリクエスト／レスポンスの例を確認します。
