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

# Fireblocks

In dieser Anleitung wird erklärt, wie Sie Phalcon Compliance mit [Fireblocks](https://www.fireblocks.com/) verwenden, um ausgehende und eingehende Transaktionen auf AML/CFT-Risiken zu prüfen. Durch die Kombination beider Plattformen können Sie ausgehende Transaktionen vor ihrer Ausführung prüfen und eingehende Transaktionen überwachen, sobald sie von Fireblocks erkannt werden.

## Voraussetzungen

**Für die grundlegende Einrichtung erforderlich:**

* Ein aktives Phalcon Compliance-Konto mit einem API-Schlüssel (siehe [API-Schlüssel](https://docs.compliance.phalcon.blocksec.com/de/user-manual/account/api-keys.md))
* Ein Fireblocks-Arbeitsbereich mit Webhook- oder API-Zugriff

**Nur für die erweiterte Einrichtung erforderlich:**

* **API Co-Signer** zum automatischen Prüfen ausgehender Transaktionen über einen callback handler (siehe [Fireblocks Co-Signer Overview](https://developers.fireblocks.com/docs/use-cosigners-for-signing-automation))
* **Manual Screening Verdicts** für den manuellen Workflow zur Bewertung eingehender Transaktionen (wenden Sie sich an Ihren Fireblocks Customer Success Manager, um diese Funktion zu aktivieren)

## Ausgehende Transaktionen prüfen

Wenn Ihre Organisation über Fireblocks Gelder versendet, können Sie Phalcon Compliance verwenden, um die Zieladresse zu prüfen, **bevor** die Transaktion signiert und übertragen wird. Es gibt zwei Methoden:

### Option 1: Prüfung vorab über die Phalcon API

Prüfen Sie die Zieladresse mit der Phalcon Compliance API, bevor Sie eine Transaktion an Fireblocks übermitteln. Auf Grundlage der Risikobewertung entscheidet Ihr Team, ob es fortfahren soll.

**So funktioniert es:**

1. Ihr Team übermittelt die Zieladresse über die API [Eine einzelne Adresse prüfen](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/address-screening/screen-a-single-address.md) oder das Phalcon-Dashboard an Phalcon Compliance.
2. Phalcon Compliance gibt eine Risikobewertung zurück, einschließlich Risikostufe, Risikoindikatoren und Informationen zur Risikoexposition.
3. Ihr Team prüft die Ergebnisse und trifft eine Entscheidung auf Grundlage Ihrer internen Compliance-Richtlinien:
   * **Unakzeptables Risiko** — Lehnen Sie die Transaktion ab. Übermitteln Sie sie nicht an Fireblocks.
   * **Akzeptables Risiko** — Fahren Sie mit der Erstellung der Transaktion in Fireblocks fort.
4. Wenn die Transaktion akzeptiert wird, übermitteln Sie sie über die Fireblocks API oder Konsole an Fireblocks.

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

**Wichtige Punkte:**

* Es ist keine zusätzliche Infrastruktur erforderlich. Sie benötigen lediglich Ihren Phalcon API-Schlüssel.
* Sie können Phalcons [Benachrichtigungskanäle](https://docs.compliance.phalcon.blocksec.com/de/user-manual/configure/notification-channels.md) konfigurieren, um Stakeholder zu benachrichtigen, wenn eine Adresse mit hohem Risiko erkannt wird.

### Option 2: Automatisierte Prüfung über einen Callback Handler

Bei dieser Methode wird ein [API Co-Signer Callback Handler](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler) verwendet, um Phalcon Compliance direkt in den Workflow zur Transaktionssignierung von Fireblocks zu integrieren. Jede ausgehende Transaktion wird automatisch geprüft, bevor der Co-Signer sie signiert.

**So funktioniert es:**

1. Initiieren Sie eine Transaktion über die Fireblocks API.
2. Die Transaktion durchläuft die Fireblocks Transaction Authorization Policy (TAP).
3. Der API Co-Signer, der in Ihrer Umgebung ausgeführt wird, empfängt die Transaktionsdetails vom Co-Signer Gateway.
4. Der Co-Signer leitet die Transaktionsdetails an Ihren **callback handler** weiter, einen benutzerdefinierten HTTPS-Server, den Sie bereitstellen.
5. Ihr callback handler ruft die [Phalcon Compliance API](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/address-screening/screen-a-single-address.md) auf, um die Zieladresse zu prüfen.
6. Auf Grundlage von Phalcons Risikobewertung gibt Ihr callback handler eine Entscheidung zurück:
   * **Genehmigen** — Der Co-Signer signiert die Transaktion und sendet die Signatur an das Co-Signer Gateway.
   * **Ablehnen** — Der Co-Signer bricht die Transaktion ab.

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

**Wichtige Punkte:**

* Der API Co-Signer erwartet innerhalb von **30 Sekunden** eine Antwort vom callback handler.
* Sie haben die volle Kontrolle über die Logik für Risikoschwellenwerte im callback handler.
* Details zur Konfiguration des Co-Signers finden Sie in der [Dokumentation zum Fireblocks Callback Handler](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler).

## Eingehende Transaktionen prüfen

Wenn Ihr Fireblocks-Arbeitsbereich Gelder empfängt, können Sie Phalcon Compliance verwenden, um die Absenderadresse zu prüfen und ihr Risiko zu bewerten. Es gibt zwei Methoden:

### Option 1: Automatisierte Prüfung über einen Webhook

Verbinden Sie einen Fireblocks-Webhook mit Phalcon Compliance, um eingehende Transaktionsereignisse automatisch zu prüfen. Sie können den von Phalcon bereitgestellten Webhook-Endpunkt verwenden oder Ihren eigenen Webhook-Server bereitstellen, der die [Phalcon Compliance API](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/address-screening/screen-a-single-address.md) aufruft.

**So funktioniert es:**

1. Richten Sie einen Webhook-Endpunkt ein, der Fireblocks-Transaktionsereignisse empfängt. Sie können die von Phalcon Compliance bereitgestellte Webhook-URL verwenden oder Ihren eigenen Server bereitstellen, der die [Phalcon Compliance API](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/address-screening/screen-a-single-address.md) aufruft.
2. Registrieren Sie die Webhook-URL in Ihrem Fireblocks-Arbeitsbereich (siehe die [Fireblocks Webhooks-Dokumentation](https://developers.fireblocks.com/reference/webhooks-overview)).
3. Wenn eine eingehende Transaktion erkannt wird, sendet Fireblocks das Ereignis an den Webhook-Endpunkt.
4. Das Ereignis wird analysiert, und die relevante Absenderadresse wird von Phalcon Compliance geprüft.
5. Auf Grundlage der Risikobewertung:
   * **Risiko erkannt** — In Phalcon Compliance wird eine Warnung erstellt, die Ihr Team überprüfen kann.
   * **Kein Risiko erkannt** — Das Prüfergebnis wird protokolliert. Es sind keine weiteren Maßnahmen erforderlich.

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

**Wichtige Punkte:**

* Die Prüfung basiert auf der in Phalcon Compliance konfigurierten Risk Engine und den Schwellenwerten.
* Konfigurieren Sie [Benachrichtigungskanäle](https://docs.compliance.phalcon.blocksec.com/de/user-manual/configure/notification-channels.md), um Ihr Compliance-Team zu benachrichtigen, wenn ein Risiko erkannt wird.
* Wenn Sie Hilfe bei der Einrichtung der Webhook-Integration benötigen, kontaktieren Sie uns unter ***<phalcon_support@blocksec.com>***.

### Erweitert: Manual Screening Verdicts

> Für Compliance-Teams, die eine manuelle Prüfung und ausdrückliche Genehmigung jeder eingehenden Transaktion benötigen.

{% hint style="warning" %}
Diese Funktion ist in Fireblocks nur eingeschränkt verfügbar. Wenden Sie sich an Ihren Fireblocks Customer Success Manager, um Manual Screening Verdicts für Ihren Arbeitsbereich zu aktivieren.
{% endhint %}

Wenn Manual Screening Verdicts aktiviert sind, bleiben eingehende Transaktionen im Status `PENDING_SCREENING`, bis Ihr Compliance-Team ein Urteil übermittelt. Ihr Team verwendet Phalcon Compliance, um das Risiko zu bewerten, und übermittelt anschließend ein Urteil an Fireblocks.

**So funktioniert es:**

1. Eine eingehende Transaktion trifft in Ihrem Fireblocks-Arbeitsbereich ein und erhält den Status `PENDING_SCREENING`.
2. Ihr Compliance-Team wird über die ausstehende Transaktion benachrichtigt.
3. Ihr Team prüft die Absenderadresse in Phalcon Compliance und überprüft die Risikobewertung.
4. Auf Grundlage der Prüfung übermittelt Ihr Team ein Urteil an die Fireblocks API (`POST /aml/verdict/manual`):
   * **Akzeptieren** — Die Transaktion wird zur Verarbeitung freigegeben.
   * **Ablehnen** — Die Transaktion wird in Fireblocks markiert und eingefroren.
5. Wenn innerhalb von **einer Stunde** kein Urteil übermittelt wird, lehnt Fireblocks die Transaktion automatisch ab und friert sie ein.

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

**Wichtige Punkte:**

* Manual Screening Verdicts gelten nur für eingehende Transaktionen. Ausgehende Transaktionen sind davon nicht betroffen.
* Die Webhook-Methode (Option 1) und Manual Screening Verdicts **können nicht gleichzeitig verwendet werden** — Sie müssen eine Methode zur Prüfung eingehender Transaktionen auswählen.
* Das einstündige Zeitlimit bietet eine Sicherheitsvorkehrung, Ihr Team sollte die Transaktionen jedoch zeitnah prüfen und beantworten.

## Nächste Schritte

* [Risk Engine](https://docs.compliance.phalcon.blocksec.com/de/user-manual/configure/risk-engines.md): Passen Sie Risikoschwellenwerte und Risikoindikatoren an Ihre Compliance-Richtlinien an.
* [Benachrichtigungskanäle](https://docs.compliance.phalcon.blocksec.com/de/user-manual/configure/notification-channels.md): Richten Sie Benachrichtigungen ein, wenn Aktivitäten mit hohem Risiko erkannt werden.
* [API-Schlüssel](https://docs.compliance.phalcon.blocksec.com/de/user-manual/account/api-keys.md): Generieren Sie Zugangsdaten für die Phalcon Compliance API.
* [API-Dokumentation](https://docs.compliance.phalcon.blocksec.com/de/api-documentation/introduction.md): Details zu Endpunkten und Beispiele für Anfragen und Antworten.
