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

# Fireblocks

Bu kılavuzda, AML/CFT risklerine karşı giden ve gelen işlemleri taramak için [Fireblocks](https://www.fireblocks.com/) ile Phalcon Compliance'ın nasıl kullanılacağı açıklanmaktadır. İki platformu bir araya getirerek giden işlemleri gerçekleştirilmeden önce tarayabilir ve Fireblocks tarafından algılandıklarında gelen işlemleri izleyebilirsiniz.

## Ön koşullar

**Temel kurulum için gereklidir:**

* API key içeren etkin bir Phalcon Compliance hesabı ([API Keys](https://docs.compliance.phalcon.blocksec.com/tr/user-manual/account/api-keys.md) sayfasına bakın)
* Webhook veya API erişimi olan bir Fireblocks çalışma alanı

**Yalnızca gelişmiş kurulum için gereklidir:**

* Bir callback handler aracılığıyla giden işlemleri otomatik olarak taramak için **API Co-Signer** ([Fireblocks Co-Signer Overview](https://developers.fireblocks.com/docs/use-cosigners-for-signing-automation) sayfasına bakın)
* Manuel gelen işlem kararı iş akışı için **Manual Screening Verdicts** (bu özelliği etkinleştirmek için Fireblocks Customer Success Manager'ınızla iletişime geçin)

## Giden İşlemleri Tarama

Kuruluşunuz Fireblocks üzerinden para gönderdiğinde, işlem imzalanıp ağa yayınlanmadan **önce** hedef adresi taramak için Phalcon Compliance'ı kullanabilirsiniz. İki yöntem vardır:

### Seçenek 1: Phalcon API aracılığıyla ön tarama

Fireblocks'a bir işlem göndermeden önce, hedef adresi taramak için Phalcon Compliance API'sini kullanın. Ekibiniz, risk değerlendirmesine göre işlemi gerçekleştirip gerçekleştirmemeye karar verir.

**Nasıl çalışır:**

1. Ekibiniz, [Tek Bir Adresi Tarama](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/address-screening/screen-a-single-address.md) API'si veya Phalcon panosu aracılığıyla hedef adresi Phalcon Compliance'a gönderir.
2. Phalcon Compliance; risk düzeyi, risk göstergeleri ve maruziyet ayrıntıları dahil olmak üzere bir risk değerlendirmesi döndürür.
3. Ekibiniz sonuçları inceler ve kurum içi uyumluluk politikalarınıza göre karar verir:
   * **Kabul edilemez risk** — İşlemi reddedin. Fireblocks'a göndermeyin.
   * **Kabul edilebilir risk** — Fireblocks'ta işlemi oluşturmaya devam edin.
4. Kabul edilirse işlemi Fireblocks API'si veya konsolu aracılığıyla Fireblocks'a gönderin.

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

**Önemli noktalar:**

* Ek altyapı gerekmez. Yalnızca Phalcon API key'iniz gerekir.
* Yüksek riskli bir adres algılandığında ilgili paydaşları uyarmak için Phalcon'un [Bildirim Kanalları](https://docs.compliance.phalcon.blocksec.com/tr/user-manual/configure/notification-channels.md) özelliğini yapılandırabilirsiniz.

### Seçenek 2: Callback Handler kullanarak otomatik tarama

Bu yöntem, Phalcon Compliance'ı doğrudan Fireblocks işlem imzalama iş akışına entegre etmek için bir [API Co-Signer Callback Handler](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler) kullanır. Giden her işlem, Co-Signer tarafından imzalanmadan önce otomatik olarak taranır.

**Nasıl çalışır:**

1. Fireblocks API'si aracılığıyla bir işlem başlatın.
2. İşlem, Fireblocks Transaction Authorization Policy (TAP) aşamasından geçer.
3. Ortamınızda çalışan API Co-Signer, işlem ayrıntılarını Co-Signer Gateway'den alır.
4. Co-Signer, işlem ayrıntılarını dağıttığınız özel bir HTTPS sunucusu olan **callback handler**'ınıza iletir.
5. Callback handler'ınız, hedef adresi taramak için [Phalcon Compliance API'sini](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/address-screening/screen-a-single-address.md) çağırır.
6. Phalcon'un risk değerlendirmesine göre callback handler'ınız bir karar döndürür:
   * **Onayla** — Co-Signer işlemi imzalar ve imzayı Co-Signer Gateway'e gönderir.
   * **Reddet** — Co-Signer işlemi iptal eder.

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

**Önemli noktalar:**

* API Co-Signer, callback handler'dan **30 saniye** içinde yanıt bekler.
* Callback handler'daki risk eşiği mantığı üzerinde tam kontrole sahipsiniz.
* Co-Signer'ı yapılandırma ayrıntıları için [Fireblocks Callback Handler Documentation](https://developers.fireblocks.com/docs/create-api-co-signer-callback-handler) sayfasına bakın.

## Gelen İşlemleri Tarama

Fireblocks çalışma alanınız para aldığında, gönderen adresi taramak ve riskini değerlendirmek için Phalcon Compliance'ı kullanabilirsiniz. İki yöntem vardır:

### Seçenek 1: Webhook aracılığıyla otomatik tarama

Gelen işlem olaylarını otomatik olarak taramak için bir Fireblocks webhook'unu Phalcon Compliance'a bağlayın. Phalcon tarafından sağlanan webhook uç noktasını kullanabilir veya [Phalcon Compliance API'sini](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/address-screening/screen-a-single-address.md) çağıran kendi webhook sunucunuzu dağıtabilirsiniz.

**Nasıl çalışır:**

1. Fireblocks işlem olaylarını almak için bir webhook uç noktası kurun. Phalcon Compliance tarafından sağlanan webhook URL'sini kullanabilir veya [Phalcon Compliance API'sini](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/address-screening/screen-a-single-address.md) çağıran kendi sunucunuzu dağıtabilirsiniz.
2. Webhook URL'sini Fireblocks çalışma alanınıza kaydedin ([Fireblocks Webhooks Documentation](https://developers.fireblocks.com/reference/webhooks-overview) sayfasına bakın).
3. Gelen bir işlem algılandığında Fireblocks, olayı webhook uç noktasına gönderir.
4. Olay ayrıştırılır ve ilgili gönderen adresi Phalcon Compliance tarafından taranır.
5. Risk değerlendirmesine göre:
   * **Risk algılandı** — Ekibinizin incelemesi için Phalcon Compliance'da bir uyarı oluşturulur.
   * **Risk algılanmadı** — Tarama sonucu kaydedilir. Başka bir işlem gerekmez.

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

**Önemli noktalar:**

* Tarama, Phalcon Compliance'da yapılandırılmış risk motoru ve eşiklere göre yapılır.
* Risk algılandığında uyumluluk ekibinizi uyarmak için [Bildirim Kanalları](https://docs.compliance.phalcon.blocksec.com/tr/user-manual/configure/notification-channels.md) özelliğini yapılandırın.
* Webhook entegrasyonunu kurma konusunda yardıma ihtiyacınız varsa ***<phalcon_support@blocksec.com>*** adresinden bizimle iletişime geçin.

### Gelişmiş: Manuel Tarama Kararları

> Her gelen işlemin manuel olarak incelenmesini ve açıkça onaylanmasını gerektiren uyumluluk ekipleri içindir.

{% hint style="warning" %}
Bu özellik Fireblocks'ta sınırlı olarak sunulmaktadır. Çalışma alanınızda Manual Screening Verdicts özelliğini etkinleştirmek için Fireblocks Customer Success Manager'ınızla iletişime geçin.
{% endhint %}

Manual Screening Verdicts etkinleştirildiğinde, uyumluluk ekibiniz bir karar gönderene kadar gelen işlemler `PENDING_SCREENING` durumunda kalır. Ekibiniz riski değerlendirmek için Phalcon Compliance'ı kullanır ve ardından Fireblocks'a bir karar gönderir.

**Nasıl çalışır:**

1. Fireblocks çalışma alanınıza gelen bir işlem ulaşır ve `PENDING_SCREENING` durumuna alınır.
2. Uyumluluk ekibinize bekleyen işlem hakkında bildirim gönderilir.
3. Ekibiniz gönderen adresi Phalcon Compliance'da tarar ve risk değerlendirmesini inceler.
4. İncelemeye göre ekibiniz Fireblocks API'sine bir karar gönderir (`POST /aml/verdict/manual`):
   * **Kabul et** — İşlem işlenmek üzere serbest bırakılır.
   * **Reddet** — İşlem işaretlenir ve Fireblocks'ta dondurulur.
5. **Bir saat** içinde karar gönderilmezse Fireblocks işlemi otomatik olarak reddeder ve dondurur.

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

**Önemli noktalar:**

* Manual Screening Verdicts yalnızca gelen işlemler için geçerlidir. Giden işlemler etkilenmez.
* Webhook yöntemi (Seçenek 1) ile Manual Screening Verdicts **aynı anda kullanılamaz** — gelen işlemleri taramak için bir yöntem seçmeniz gerekir.
* Bir saatlik zaman aşımı ek bir güvenlik önlemi sağlar; ancak ekibiniz incelemeyi ve yanıt vermeyi mümkün olduğunca hızlı gerçekleştirmelidir.

## Sonraki Adımlar

* [Risk Motoru](https://docs.compliance.phalcon.blocksec.com/tr/user-manual/configure/risk-engines.md): Uyumluluk politikalarınıza göre risk eşiklerini ve göstergelerini özelleştirin.
* [Bildirim Kanalları](https://docs.compliance.phalcon.blocksec.com/tr/user-manual/configure/notification-channels.md): Yüksek riskli etkinlik algılandığında uyarılar ayarlayın.
* [API Keys](https://docs.compliance.phalcon.blocksec.com/tr/user-manual/account/api-keys.md): Phalcon Compliance API'si için kimlik bilgileri oluşturun.
* [API Dokümantasyonu](https://docs.compliance.phalcon.blocksec.com/tr/api-documentation/introduction.md): Uç nokta ayrıntıları ve istek/yanıt örnekleri.
