01 · Dolandırıcılık önleme için cihaz zekâsı Etiketlediğiniz akışlar
Seçtiğiniz her ekran için bir etiket
Sitenizdeki tek bir script, masaüstünde yaklaşık saniyenin onda birinde tarayıcıyı ve cihazı okur. Backend'inizden, sizin adlandırdığınız bir etiketle yapılan tek bir imzalı çağrı yanıtı hemen getirir: bir güven skoru, kanıt kapsamı ve bot ile otomasyondan tarayıcı sahteciliği ve emülatörlere, VPN, proxy ve Tor'a kadar 13 gösterge; her önerinin gerekçesiyle birlikte. Hesap ele geçirme, sahte kayıt ve ödeme dolandırıcılığını tahminle değil, kanıtla yakalayın. Biz öneririz. Siz karar verir ve uygularsınız.
Etiketlediğiniz her ekranda senkron yanıt · Herhangi bir kararı etkilemeden önce gölge mod · Kurallarınız, listeleriniz, kararınız
Bu yanıt nasıl okunur · v1.1/login_completed örneği
Bu öneri neden
ALLOW
Politikanın ağırlık verdiği hiçbir gösterge tespit edilmiş olarak dönmedi. Sözleşme örneği: FingerTrackID'nin yönetilen politikası her skorda MONITOR önerir; ALLOW, şirketinizin kendi risk kurallarında belirlediği bir skor aralığından gelir. policy-login-v1 altında karara bağlandı.
Skor nedir, ne değildir
trust_score 100
Bu politika sürümü altında bu erişime duyulan güven; bir dolandırıcılık olasılığı değil. COMPLETED dışında null olur, asla varsayılan bir değer değildir.
Ne kadarı görülebildi
evidence_coverage 100
Beklenen kontrollerden çalışabilenlerin oranı. Eksik kanıt burada adıyla belirtilirdi: kapsamı düşürür, asla bir risk gerekçesi olmaz.
Sonrası sizde
customer_action
Backend'iniz karar verir ve uygular, ardından ne yaptığını ve gerçek sonucu bildirir. Biz asla engellemeyiz, parayı asla tutmayız.
POST /v1/assessments → 201
event-assessment.v1.1 · sözleşme örneği
{ "schema_version": "event-assessment.v1.1", "tag": "login", "assessment_status": "COMPLETED", "trust_score": 100, "device_match_confidence": 0.98, "evidence_coverage": 100, "signals": [ … 13 objects ], "limitation_codes": [], "reason_codes": ["NO_ADVERSE_INDICATOR_MATCH"], "recommended_action": "ALLOW", "recommendation_basis": "EVALUATION", "policy_version": "policy-login-v1" // … 21 more fields in the full response: ids, snapshot, versions, timestamps}
1{2 "schema_version": "event-assessment.v1.1",3 "assessment_id": "01996f2a-0000-7000-8000-000000000101",4 "assessment_version": 1,5 "supersedes_assessment_id": null,6 "business_event_id": "01996f2a-0000-7000-8000-000000000102",7 "external_event_id": "login_20260904_000001",8 "tag": "login",9 "assessment_status": "COMPLETED",10 "retryable": false,11 "trust_score": 100,12 "device_intelligence_snapshot_id": "01996f2a-0000-7000-8000-000000000103",13 "device_intelligence_snapshot_version": 1,14 "device_id": "dev_0123456789abcdefghij",15 "device_match_confidence": 0.98,16 "evidence_coverage": 100,17 "data_freshness": {18 "evidence_cutoff_at": "2026-09-04T12:00:00Z",19 "oldest_required_observed_at": "2026-09-04T11:59:59Z",20 "maximum_required_age_ms": 300000,21 "all_required_fresh": true22 },23 "signals": [24 { "signal_code": "ANTI_FINGERPRINTING", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },25 { "signal_code": "BOT_AUTOMATION", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },26 { "signal_code": "BROWSER_SPOOFING", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },27 { "signal_code": "EMULATED_ENVIRONMENT", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },28 { "signal_code": "PRIVATE_BROWSING", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },29 { "signal_code": "BROWSER_PRIVACY_BRAVE", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },30 { "signal_code": "BROWSER_PRIVACY_SAFARI", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },31 { "signal_code": "BROWSER_PRIVACY_SAMSUNG_INTERNET", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },32 { "signal_code": "NETWORK_PROXY", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },33 { "signal_code": "NETWORK_VPN", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },34 { "signal_code": "NETWORK_HOSTING", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },35 { "signal_code": "NETWORK_TOR", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … },36 { "signal_code": "DEVICE_MULTI_USER", "signal_state": "NOT_DETECTED", "source": "DERIVED", "detector_version": "detector-web-v1", … }37 ],38 "limitation_codes": [],39 "reason_codes": ["NO_ADVERSE_INDICATOR_MATCH"],40 "recommended_action": "ALLOW",41 "recommendation_basis": "EVALUATION",42 "policy_version": "policy-login-v1",43 "fallback_policy_version": "production-observation-fallback-v2",44 "ruleset_version": "ruleset-web-v1",45 "signal_catalog_version": "signals-web-v1",46 "feature_schema_version": "features-v1",47 "resolver_version": "resolver-v1",48 "sdk_version": "web-sdk-1.0.0",49 "provider_versions": ["network-provider-2026-09-04"],50 "evidence_cutoff_at": "2026-09-04T12:00:00Z",51 "evaluated_at": "2026-09-04T12:00:01Z",52 "expires_at": "2026-09-04T12:05:00Z",53 "correlation_id": "corr-assessment-login-0001"54}
Onu şekillendiren sürümler · policy-login-v1 · production-observation-fallback-v2 · ruleset-web-v1 · signals-web-v1 · features-v1 · resolver-v1 · web-sdk-1.0.0 · network-provider-2026-09-04
Tam yanıtta 13 sinyal · gösterge matrisi ↓
Rakamlarla ürün
Yanıt
13
Her yanıtta web göstergesi
3
Gösterge başına durum: tespit edildi, tespit edilmedi, değerlendirilmedi
14
"Değerlendirilmedi" için adlandırılmış gerekçe, asla sessiz bir false değil
5
Olası öneri
3
Ayrı ölçüler: güven, cihaz eşleşmesi, kanıt kapsamı
1
Değerlendirilen her olay için imzalı çağrı
Toplama
17
Toplama başına tarayıcı ve cihaz kanıtı bölümü
48
Tarayıcının beyan ettiği sürüme karşı kontrol edilen tarayıcı API'si
125
Milisaniye veya daha az: Chrome, Firefox ve Safari'de masaüstü toplamanın medyanı
0
Kullanıcınıza gösterilen izin isteği
Kurallarınız ve incelemeniz
54
Her değerlendirmenin içinde hesaplanan bağlam içgörüsü
67
Şirketinizin kendi skorunda ağırlıklandırabileceği kural: 13 gösterge ve 54 içgörü
6
Ağ göstergelerinin dayandığı yayımlanmış referans listesi
6
Konsol dili: İngilizce, Portekizce (Brezilya ve Portekiz), İspanyolca, Fransızca, Almanca
Asla — ve bu plana göre değişmez
— Her değer, sürümlenmiş bir sözleşmenin, katalogun ya da listenin bir sayımıdır; test makinelerimizde soğuk önbellekle ölçülen toplama süresi hariç. Hiçbiri plana veya hacme göre değişmez.
03 · Kullanım alanları
Cihaz zekâsı, backend'iniz işleme izin vermeden önce tek bir soruyu yanıtlar: bu ekranın öbür tarafında gerçekte ne var? Aynı çağrı her akışa hizmet eder; gönderdiğiniz etiket yalnızca onu sınıflandırır.
login · password_recovery · profile_change
Bilinen bir hesabın hiç kullanmadığı bir cihazda olması, kendisi hakkında yalan söyleyen bir tarayıcı, bir anti-detect tarayıcı, zamanında yapılması imkânsız bir seyahat. Her biri kanıt olarak döner; böylece ikinci faktörü yalnızca gerçekten gerektiğinde istersiniz.
signup · login · checkout
Headless tarayıcılar, otomasyon framework'leri, imzasıyla tanınan yapay zekâ ajanları ve veri merkezlerinden gelen trafik. BOT_AUTOMATION ve NETWORK_HOSTING neyin görüldüğünü söyler; kapsam ne kadarının görülebildiğini söyler.
signup · deposit · promotions
Cihaz ve IP başına hesaplar ve kişiler, cihaz profilinin tabanınızda ne kadar nadir olduğu, başka bir cihazda tekrarlanan tek bir toplama. Kurallarınızın ağırlık verebileceği bağlam, asla otomatik bir hüküm değil: bir kişinin birden fazla meşru hesabı olabilir.
withdrawal · pix_transfer · trade
Yeni bir cihazdan sonraki ilk saatte para çekme, hesaplar arasında paylaşılan alıcılar, onaylanmış dolandırıcılık olarak işaretlediğiniz komşu hesaplar. Parayı backend'iniz bekletir ya da incelemeye alır; biz asla.
her akış
Android emülatörleri ve sanallaştırma, beyan edilen sistem için imkânsız bir GPU, kendi API'lerinin çeliştiği bir tarayıcı sürümü. Cihaz parmak izi (device fingerprinting) sinyalleri ham piksel olarak değil, hash ve aile olarak okunur.
her akış
Bilinen VPN sağlayıcıları, açık proxy'ler, Tor çıkış düğümleri, hosting aralıkları ve Apple iCloud Private Relay; bizim tarafımızda güncellenen yayımlanmış listelerden. Anonimleştirme suç değil, bağlamdır: ne kadar ağırlık taşıyacağına politikanız karar verir.
04 · Ölçüler
Güveni, kapsamı ve cihaz eşleşmesini tek bir sayıda birleştirmek, analistin tam olarak görmesi gereken şeyi gizler: sorun erişimde mi, yoksa kanıtta mı.
trust_score
72
Bu politika sürümü altında bu erişimin ne kadar güvenilir olduğunu yanıtlar; gönderdiğiniz etiket bunu değiştirmez. 0 ile 100 arasında bir tam sayı. Yalnızca assessment_status = COMPLETED olduğunda vardır; diğer tüm durumlarda null olur, asla varsayılan bir değer değildir.
Bir dolandırıcılık olasılığı, kişinin itibarı ya da eksik veri için bir varsayılan değildir. 72/100 gösteririz, asla "%72 güvenilir" değil.
device_match_confidence
0.94
Bu erişimin daha önce görülmüş aynı cihazdan geldiğine dair kanıtın gücü, 0 ile 1 arasında. Olasılıksal kümenin opak, herkese açık bir tanımlayıcısı olan device_id ile birlikte gelir.
Kişinin kimliği değildir, donanımın kanıtı da değildir. Party ve Account farklı şeylerdir.
evidence_coverage
100
Beklenen kontrol setinin ne kadarının çalıştırılabildiği, 0 ile 100 arasında. NOT_EVALUATED olarak kalan her uygulanabilir gösterge kapsamı düşürür ve limitation_codes içinde görünür.
Skorun bir parçası değildir. Düşük kapsam skoru ne aşağı çeker ne yukarı iter: değerlendirmeyi sonuçsuz bırakır.
Neden toplamıyoruz
Tek bir "şüphe" skoru üç farklı soruyu karıştırır: bu erişim güveni hak ediyor mu? Kanıt yeterli miydi? Aynı cihaz mı? Yanıt ayrı geldiğinde analistiniz ikinci faktör mü isteyeceğini, toplamayı mı bekleyeceğini yoksa geçmişe mi bakacağını bilir. Birleşik geldiğinde tek bildiği "42 aldığı"dır.
05 · 13 gösterge
Her web değerlendirmesi her zaman 13 kodu döndürür. Değişen, listedeki kodlar değil, her birinin durumudur. Her göstergenin kendi sürümlenmiş dedektörü vardır ve yanıt onu değerlendiren sürümü adıyla belirtir. Eksik, süresi dolmuş ya da hata veren bir dedektör asla false olmaz.
signal_catalog web · 13 kod · withdrawal_completed örneği
Ortam bütünlüğü
Tarayıcı gizliliği · nötr bağlam
Ağ · nötr bağlam
Cihaz
Yönetilen politikalarımızda Tor tek başına asla BLOCK_RECOMMENDED gerekçesi olmaz; şirketinizin yapılandırdığı kurallar, onun seçtiği ağırlıkları ve eşiği izler. Bu v1 sözleşme örneğinde policy-withdrawal-v1 engelleme değil, para çekme işleminin incelenmesini istedi ve tek gerekçe kodu tam olarak bunu söylüyor. Bugün üretimdeki yönetilen politika her skorda MONITOR önerir.
Aynı gösterge, üç durum
Eksik, süresi dolmuş ya da hata veren bir dedektör asla false olmaz. NOT_APPLICABLE yalnızca katalogun kanal, motor ve platforma göre değişmez matrisinden gelir; etiketiniz bunu asla değiştirmez, kapatılmış bir politika, zaman aşımı ya da kesinti de asla bu kestirmeyi kullanmaz.
Varsayılan olarak nötr bağlam
Gözlemleyebildiklerimizi sınırlayabilirler. Kapsam yalnızca kanıtın değerlendirilmediği yerde düşer. Dolandırıcılık değildirler. Ortamı tanımlarlar; kişiyi suçlamazlar. Yönetilen politikalarımızda tek başlarına asla BLOCK_RECOMMENDED gerekçesi olmazlar; şirketinizin yapılandırdığı kurallar, onun seçtiği ağırlıkları ve eşiği izler. Apple'ın iCloud Private Relay'inin arkasında olduğu gibi ağ türü ayırt edilemediğinde hosting, VPN ve proxy üçü de NETWORK_TYPE_AMBIGUOUS ile NOT_EVALUATED kalır: tek bir boolean'dan asla üç tespit işaretlemeyiz.
Ağ kanıtı, kendi altyapımızda güncellediğimiz yayımlanmış referans listelerinden gelir: Tor çıkış adresleri, bulut sağlayıcı aralıkları, hosting ağı listeleri, VPN sağlayıcı aralıkları ve bir açık proxy veritabanı. Kullanıcılarınızın adresleri liste yayıncılarına asla gönderilmez. Azami yaşını aşmış bir liste, göstergesini asla NOT_DETECTED değil, NOT_EVALUATED bırakır.
06 · Bağlam içgörüleri
Her değerlendirmenin içinde, yanıttan önce, toplanan verilerden ve şirketinizin kendi geçmişinden 54 bağlam içgörüsü hesaplarız: cihazı başka kim kullanıyor, hesap ne kadar hızlı hareket ediyor, hangi ağdan, hangi hesapların yanında. FingerTrackID'nin yönetilen politikası bunları skorun dışında tutar. Kendi risk kurallarınızda her biri kapalı, hayalet ya da aktif olabilir; olağandışı ve çok olağandışı için puanlarla: tetiklenen aktif bir içgörü güven skorundan puan düşer ve reason_codes içinde adıyla görünür.
context-insight.v1 · altı temada 54 içgörü · konsolda ve kurallarınızda gruplandığı şekliyle
Hesap ve cihaz · 10
Hesap için yeni cihaz ve yeni işletim sistemi · 30 gün içinde cihazdaki farklı hesaplar ve kişiler · aynı kişinin cihazdaki hesapları · 24 saat içinde hesap başına ve kişi başına cihazlar · yüksek aktiviteli cihaz · cihaz profilinin şirketinizde ne kadar yaygın, seyrek ya da nadir olduğu · kaybolan cihaz çerezi
Para çekme ve siparişler · 7
Yeni bir cihazdan sonraki ilk saatte para çekme · 30 gün içinde cihaz başına alıcılar ve alıcı başına hesaplar · hesap başına para çekme sayısı ve tutarı · hesap başına sipariş sayısı ve siparişler arasındaki medyan aralık
Ağ ve konum · 12
Hesap için yeni ülke ve yeni internet sağlayıcısı (ASN) · hesap başına farklı ülkeler, sağlayıcılar ve IP'ler · IP başına hesaplar ve kişiler · imkânsız seyahat · IP'nin ülkesiyle uyuşmayan tarayıcı saat dilimi · VPN çıkış ülkesi · açık bir kötüye kullanım listesindeki sağlayıcı · Apple iCloud Private Relay
Tarayıcı ve SDK bütünlüğü · 16
Açık geliştirici araçları · otomasyon izleri · anti-detect tarayıcı işareti · beyan edilen tarayıcıyla uyuşmayan TLS imzası ve 30 gün içindeki kararlılığı · yazılım renderer ve GPU ailesi · iki okuma arasında değişen canvas ya da ses · uygulama içi tarayıcı · olası misafir modu · imzasıyla tanınan yapay zekâ ajanı · bot kategorisi · onaylı paketten farklı SDK · birden fazla cihazda tek bir SDK oturumu · başka bir cihazda tekrarlanan aynı toplama · birbirinden çok uzak yerlerde kullanılan cihaz çerezi
Hız · 5
5 dakika, 1 saat ve 24 saat içinde cihaz başına ve hesap başına erişimler; 5 dakika ve 1 saat içinde IP başına · 1 dakika, 5 dakika ve 1 saat içinde hesap başına ve cihaz başına aynı etiketli değerlendirmeler
Hesaplar arası bağlantılar, tek adım · 4
Aynı cihazları kullanan diğer hesaplar · otomasyon ya da tarayıcı sahteciliği tespit edilen komşu hesaplar · onaylanmış dolandırıcılık olarak işaretlediğiniz komşu hesaplar · diğer hesaplarla paylaşılan para çekme alıcıları
Üç durum · bir gerekçe, asla sıfır değil
Bazı içgörüler gönderdiklerinize bağlıdır. Hesap ya da kişi referansları olmadan, etiket olmadan ya da sonuçlar olmadan öğe bunu söyler: hesap gönderilmedi, etiketsiz değerlendirme, sonuç gönderilmedi. Etiketli bir istek tutar ya da alıcı taşımaz; bu yüzden para çekme tutarı ve alıcı öğeleri de bunu söyler. İlk erişim, anonimleştirilmiş bir ağ ya da bir kontrolün bir saatlik penceresinin dışındaki bir IP de birer gerekçedir.
Ne değildirler
reason_codes alanına yalnızca şirketinizin aktif hale getirdiği bir kural aracılığıyla ulaşırlar.Analist bunları nerede okur
Erişim detayı. "Erişim bağlamı" kartı içgörüleri temaya göre gruplar; zaman pencereleri, dikkate aldıkları geçmişin kesim noktası, her birinin cetvelinize göre ne kadar olağandışı olduğu ve değersiz kalan her öğenin gerekçesiyle birlikte. Değerlendirmenin zaman bütçesine sığmayan bir içgörü arka planda tamamlanır ve bunu belirtir; yanıtı asla geciktirmez ya da başarısız kılmaz.
Gösterge kataloğu. Tek bir sayfa, 13 göstergenin her birinin neye baktığını, onu neyin değerlendirilmemiş bıraktığını ve skoru etkileyip etkileyemeyeceğini açıklar; bağlam içgörülerini de değersiz kalabilecekleri gerekçelerle listeler.
Canvas, WebGL, ses ve fontlar her şirketin yönetilen toplama politikası altında, yalnızca türetilmiş değerler olarak okunur ve GPU ailesi, yazılım renderer ya da iki okuma arasında değişen bir render gibi bu içgörülerin birkaçını besler. Tarayıcının bir kontrole izin vermediği yerde öğe, gerekçesiyle birlikte değerlendirilmemiş kalır.
07 · Sonuçsuz da bir sonuçtur
Eksik kanıt 100 güven üretmez ve bir dolandırıcılık sinyaline de dönüşmez. Skor olmadığında öneri, politika sürümünün içinde dondurulmuş ve onun hash'iyle kapsanan yedek kuraldan (fallback) gelir; etiket ne olursa olsun skorsuz her durum için tek bir yanıttır: MONITOR. Asla ALLOW değil.
Sözleşme örneklerinden skorsuz durumlar
Etiket yedek kuralı asla seçmez. Yönetilen politikada, hangi etiket olursa olsun, skoru olmayan her durum MONITOR önerir: devam edin ve kaydedin. Aşağıdaki üç sözleşme örneği de öyle.
INCONCLUSIVEetiket login · SDK yüklenmedi
Toplama yok: trust_score: null, evidence_coverage: 0, COLLECTOR_NOT_LOADED, dayanak INSUFFICIENT_EVIDENCE. Hiçbir şey asla ALLOW olarak serbest bırakılmaz.
INCONCLUSIVEağ kanıtı kullanılamıyor
Dört ağ göstergesi NOT_EVALUATED, evidence_coverage: 69, PROVIDER_UNAVAILABLE. İşlem ne olursa olsun sizin sisteminizde, sizin kararınız altında kalır; biz parayı asla tutmayız.
FAILEDetiket pix_transfer · politika kullanılamıyor
Teknik hata: POLICY_UNAVAILABLE, policy_version: null, dayanak TECHNICAL_FAILURE. Asla "risk yok" olarak okunmaz.
Skor olmadan asla ALLOW önermeyiz · örneklerde fallback_policy_version production-observation-fallback-v2 · yedek kural, politika her okunduğunda politikayla birlikte doğrulanır
Dört değerlendirme durumu
Katalogun 14 sınırlama kodu · neyin eksik olduğu, asla neden riskli olduğu değil
Sınırlama kodu toplamayı ve kaliteyi açıklar; gerekçe kodu politikayı açıklar. NOT_EVALUATED olan her gösterge kendi kodunu gösterir; değerlendirme hepsini limitation_codes içinde toplar. Bir toplama sınırlaması asla bir risk gerekçesi değildir.
08 · Karar sizin
recommended_action politikanın ne önerdiğini söyler. customer_action sizin ne yaptığınızı söyler. İki alan, çünkü iki ayrı olgu.
Kim önerir, kim karar verir, kim uygular
FingerTrackID önerir
Asla yalnızca gizlilikten değil · Tor, VPN, proxy, gizli mod, paylaşılan cihaz
Akışınız karar verir
Backend'iniz karar verir ve uygular. Biz bir öneri döndürürüz; bugün yönetilen politika yalnızca gözlem amaçlı MONITOR yanıtını verir. Erişime ne olacağına sizin tarafınızda karar verilir ve uygulanır. Hesabı, limiti, geçmişi ve sürtünmenin maliyetini siz bilirsiniz. Biz bilmeyiz.
Siz uygular ve geri bildirirsiniz
customer_action · geri gönderdiğiniz alan
Her önerinin ne anlama gelmediği
Politika bu erişimde sürtünme için bir gerekçe bulmadı. Kişinin meşru olduğu ya da erişimin onaylandığı anlamına gelmez. Yalnızca bir skorla ve gerekli kanıt değerlendirilmişken verilir.
Devam edin ama kaydedin. Her etikette skorsuz yedek yanıttır ve bugün yönetilen politikanın her skordaki yanıtı da budur. Doğrulanmış şüphe anlamına gelmez ve kullanıcıdan hiçbir işlem gerektirmez.
İkinci bir faktör ya da onay isteyin. Bizim birini doğrulamaya zorladığımız anlamına gelmez: doğrulamayı gösteren sizsiniz.
İnsan incelemesine gönderin. Parayı bizim tuttuğumuz anlamına gelmez: işlem sizin sisteminizde, sizin kararınız altında kalır.
Politika reddetmeyi önerir. Uygulanmış bir engelleme, doğrulanmış dolandırıcılık ya da bir yasaklama anlamına gelmez. Siz engellediğinizde bu, sizin bir olayınız olan customer_action: BLOCKED olur ve doğruluk ölçümünü besler.
09 · Entegrasyon
Sitenizde bir script, backend'inizde bir sunucudan sunucuya endpoint ve işlemi ve sonucu geri göndermek için iki çağrı. İstemcide karar yok.
Sitenizde SDK
Size ait bir alt alan adından sunulur. Değerlendirilmesini istediğiniz isteği göndermeden önce, ekran ne olursa olsun, tarayıcı ve ortam sinyallerini toplar ve 202 PROCESSING alır: bu bir sonucu değil, alındığını onaylar. Ağ sinyallerini script değil, toplama alan adınızdaki edge ekler. Tarayıcıya hiçbir skor, sinyal ya da karar geri dönmez.
import { initializeSdk } from '@ftid/sdk-web'
// publicKey is a public locator, not a secret.
// collectionOrigin is YOUR collection domain (https).
const sdk = initializeSdk({
publicKey: 'pub_app_0123456789abcdef',
collectionOrigin: 'https://collect.yourcompany.com',
})
// ACCEPTED (202 PROCESSING on the wire): confirms receipt, not a result.
const collection = await sdk.collect()
if (collection.status !== 'ACCEPTED') {
// Without collection the journey continues; the backend will get
// INCONCLUSIVE / COLLECTOR_NOT_LOADED: no fake score.
return continueWithoutToken()
}
// Create the event before sending the request to be assessed.
const event = sdk.createEvent(collection.observation)
// Only a COMPLETED collection yields a token. The token goes in the POST
// that YOUR backend makes; the decision never comes back here.
const ctx = await sdk.getEventContext(event)
const token =
ctx.status === 'COMPLETED'
? ctx.eventContextToken
: nullBackend'iniz çağırır
On kanonik satır üzerinde HMAC-SHA-256 — işaretçi, key_id, metot, yol, zaman damgası, olay ve istek kimlikleri, içerik meta verisi ve son satırda tam gövde baytlarının SHA-256'sı. Hash'lemeden önce JSON'u asla yeniden serileştirmeyin; sözleşme normatif vektörü taşır. key_id tek herkese açık konum belirleyicidir. Sır asla taşınmaz. v1.1 sözleşmesinden requests.both_refs_deadline_750 kanonik vektörü: v1 ile aynı rota ve aynı imza; journey, action ve journey_context yerine bir tag ile.
POST /v1/assessments HTTP/1.1
Host: api.fingertrackid.com
Content-Type: application/json
X-FTID-Signature: v1=<key_id>:<mac-hex>
X-FTID-Timestamp: 1791720000
X-FTID-Request-Id: <uuidv7 of the attempt>
X-FTID-External-Event-Id: evt:tag-0003
{
"schema_version": "event-assessment-request.v1.1",
"external_event_id": "evt:tag-0003",
"idempotency_key": "idem-tag-0003",
"occurred_at": "2026-10-11T12:00:00.000Z",
"subject_ref": "subject:synthetic",
"account_ref": "account:synthetic",
"event_context_token": "ctx.synthetic-token_0003",
"tag": "pix_transfer_a1b2c3d4e5f6g7h8i9j0abcdeabcdeabcdeabcdeabcdeabcdez",
"deadline_ms": 750
}tag en fazla 64 karakterlik küçük harfli bir slug'dır (harfler, rakamlar ve alt çizgi, en fazla on rakam), asla kişisel veri değildir; bu vektör tam o sınırdadır · subject_ref ve account_ref null olabilir ve bir account_ref bir subject_ref gerektirir · ref'ler size ait opak kodlardır, asla kimlik numarası, e-posta ya da sıralı ID değildir · deadline_ms 250 ile 5000 arasında bir tam sayıdır ya da 5000 için null; aşılırsa kısmi bir skor değil, yeniden denenebilir bir 503 Problem döner
Senkron yanıt
Ardından iki geri bildirim çağrısı: yaptığınız işlemle customer_action ve öğrendiğinizde gerçek sonuçla truth_status (sonuç: meşru, doğrulanmış dolandırıcılık ya da yetersiz kanıt). Sözleşme ikisini de değerlendirme çağrısıyla aynı disipline tabi tutar: kalıcı bir commit'ten önce hiçbir şey kabul edilmiş sayılmaz ve aynı bir yeniden deneme ikinci bir etki eklemez. Bir sonuç daha sonra düzeltilebilir — düzeltme bir ardıl kayıt olarak eklenir ve önceki kayıt okunabilir kalır.
POST /v1/assessments/POST /v1/assessments/
Web, her modern tarayıcıda · kurulacak uygulama yok · SDK, değerlendirme ve geri bildirim aynı sürümlenmiş sözleşmede
npm install @fingertrackid/server çağrıyı sizin için imzalar ve @fingertrackid/mcp, Claude Code, Cursor ya da MCP destekli herhangi bir kodlama ajanının entegrasyonu yayımlanmış sözleşmeden kurmasını sağlar. Adım adım: hızlı başlangıç, Web SDK kılavuzu ve API referansı.
10 · Tarayıcıya sıfır güven
Tarayıcıdan gelen hiçbir şey yetki olarak kabul edilmez. Değerlendirme sunucudan sunucuya ve imzalıdır; her deneme bir kez sayılır: tekrarlamak yeni bir etki yaratmaz.
Kim kiminle konuşur
Tarayıcı yalnızca opak oturum ve olay kimlikleri alır. Skor, sinyaller ve öneri sunucuda doğar ve orada kalır. Birinci taraf çerez imzalıdır, HttpOnly, Secure ve tenant'ınız ile uygulamanızla sınırlıdır.
Çağrının anatomisi
ftidHmacV1key_id UUIDv7 tek konum belirleyicidir; tenant, uygulama, ortam ve yetkiler ancak sabit zamanlı karşılaştırmada geçerli bir MAC'ten sonra yetkiye dönüşür. X-Client-Id, eski nonce ve çoklu imzalar reddedilir.request_id imzalar; geçersiz bir MAC ayırma oluşturmaz.assessment-unavailable (503, retryable: true).key_id veya yanlış bir imza aynı authentication-failed yanıtını üretir.key_id değerinin var olup olmadığını açığa çıkarmadan yanıtı tek tip yapar. Yeni bir request_id imzalayın.11 · Sürümlenmiş politika
Tek bir göstergenin hassasiyetini değiştirmek; yazarı, geçerlilik dönemi, simülasyonu ve geri alma imkânıyla yeni bir sürüm oluşturur. Geçmiş değişmez. Gerçek bir sürümün olmaması kullanımı engeller.
Karar veren sürüm · withdrawal_completed örneği
policy-withdrawal-v1
correlation_id, kişisel bir tanımlayıcıyı açığa çıkarmadan destek içindir. Açığa çıkan sürümler opak, herkese açık etiketlerdir; iç veritabanı kimlikleri asla API'de, webhook'ta ya da konsolda görünmez.
Bir politika sürümü neleri dondurur
Yeniden üretilebilir, asla yeniden yazılmaz
login_completed örneği
assessment_version1
supersedes_assessment_idnull
login_completed_revision_2 örneği
assessment_version2
supersedes_assessment_id…0000000101
Operasyonel bir revizyon, olayın received_at anında geçerli olan politikayı ve diğer tüm sürümleri korur. Eski bir olay üzerine yeni bir politika ayrı bir simülasyondur; tarihsel karara hangi önerinin yön verdiğini asla yeniden yazmaz.
12 · Gölge mod
Gölge mod, FingerTrackID'yi bugün kullandığınız çözümle yan yana, yanıt hiçbir karara dokunmadan çalıştırmaktır. Karşılaştırırsınız, gerçek sonuçları geri gönderirsiniz ve öneriyi ancak ondan sonra kullanmaya başlarsınız. Başlamanızı önerdiğimiz yol budur.
Tam döngü
SDK toplar
202 PROCESSING · event_context_token
Backend'iniz değerlendirme ister
POST /v1/assessments · senkron
Akışınızla siz karar verirsiniz
gölgede, yanıtı kullanmadan
İşlemi bildirirsiniz
customer_action · POST …/customer-actions
Sonucu bildirirsiniz
truth_status · POST …/outcomes
recommendation_alignment · sunucuda öneri × işlem çiftinden türetilir; istemci tarafından asla beyan edilmez. Örtüşme ne nedenselliği, ne doğruluğu, ne de dolandırıcılığı kanıtlar.
Alan alan karşılaştırma
| recommended_action | customer_action | recommendation_alignment |
|---|---|---|
REVIEW | REVIEWED veya HELD | ALIGNED |
STEP_UP | ALLOWED | NOT_ALIGNED |
ALLOW veya MONITOR | ALLOWED | ALIGNED |
BLOCK_RECOMMENDED | BLOCKED | ALIGNED |
| herhangi biri | CANCELLED | NOT_COMPARABLE |
Engellemek dolandırıcılığı kanıtlamaz. Dolandırıcılığı doğrulamak bağımsız kanıt gerektirir: truth_status, PENDING değerinden LEGITIMATE, FRAUD_CONFIRMED ya da INSUFFICIENT_EVIDENCE değerine geçer; olgunluk PROVISIONAL ya da MATURE olur. Yalnızca olgun bir etiket kalite metriğine dönüşür.
Döngü neyi besler
customer_action ve truth_status ayrı olgulardır ve her düzeltme bir ardıl oluşturur.13 · Sözleşmeyle gizlilik
Açık metin kişisel veri (PII) bir ürün gereksinimi değildir. Siz opak kişi ve hesap referansları gönderirsiniz; bir erişimi değerlendirmek için kimlik numarası, e-posta ya da telefon numarası istemeyiz.
packages/contracts/src/sdk-handshake-v1.ts · toplama politikası
canvas: z.boolean(),
audio: z.boolean(),
fonts: z.boolean(),
behavioral: z.literal(false),packages/contracts/src/sdk-signals/rendering-v1.ts · alıntı
const Hash128 = z.string().regex(/^[0-9a-f]{32}$/)
canvas_hash: Hash128.optional(),
webgl_gpu_family: z.enum(SDK_RENDERING_GPU_FAMILY_V1).optional(),
audio_hash: Hash128.optional(),
fonts_count: z.number().int().min(0).max(SDK_RENDERING_FONT_COUNT_V1).optional(),Davranışsal toplama, yani işaretçi hareketi ve tuş vuruşları, yalnızca kapalı değerini kabul eder: açmak bir ayarı değil, sözleşmeyi değiştirmeyi gerektirir. Canvas, WebGL, çevrimdışı ses ve font varlığı, her şirket için bunları açan yönetilen toplama politikası altında okunur ve tarayıcıdan yalnızca türetilmiş değerler olarak çıkar: sabit uzunlukta hash'ler, kapalı bir GPU ailesi, bir sayım ve sabit bir font listesi üzerinde bir varlık maskesi. Sözleşmede pikseller, ses örnekleri, GPU üretici ya da renderer adları veya font adları için alan yoktur. Bu türetilmiş değerler birlikte aynı tarayıcıyı yeniden tanıyabilir; bu yüzden anonim veri olarak değil, cihaz verisi olarak ele alınır. Mutlak bir kural olarak asla toplanmaz: parola, yazılan metin, sohbet ya da belge içeriği, pano, ekran görüntüsü, mikrofon, kamera. Her kanıtın bir gizlilik sınıfı vardır ve sınıf risk ağırlığı değildir.
İyi niyete bağlı olmayan garantiler
tenant_id taşır. Müşteriler arasında paylaşılan bir itibar ya da etiket yoktur.HttpOnly, Secure, tenant'ınız ve uygulamanızla sınırlı. Değer asla bir veritabanına, kuyruğa ya da loga gitmez; eksikse ya da reddedilirse süreklilik bir sınırlama olarak azalır ve değerlendirme durmaz.Party, Account değildir
Bağlantı backend'inizden gelir · asla parmak izinden çıkarılmaz
Bir kişi, birden fazla meşru hesap. Bir hesap asla sessizce kişi değiştirmez; oturum yalnızca anonimden kişiye, ardından aynı kişinin bir hesabına ilerler. Bir çelişki bir çatışmadır; yeni bir ilişki ya da doğaçlama negatif kanıt değildir.
Verilerin bulunduğu yer
14 · Konsol
Konsol önce "kaliteli şekilde alıyor, değerlendiriyor ve açıklıyor muyuz?" sorusunu yanıtlar ve ancak ondan sonra meşruiyetten söz edilmesine izin verir. Her yüzde paydasını adıyla belirtir.
Şematik, ekran görüntüsü değil · çerçevenin içinde konsol tonları
Erişim detayı. Üç ayrı bileşen olarak üç ölçü; recommendation_basis ile birlikte öneri, geçerli politika ve ekibinizin ne yaptığını bildirdiği; kanıt tazeliği; durum, uygulanabilirlik, kaynak, dedektör güveni, tazelik ve değerlendirilmeyen her biri için gerekçeyle 13 gösterge; sınırlamalar ve gerekçe kodları; oturum, cihaz ve ilişkileri; cihazdaki çokluk; ağdan yaklaşık bir konum; erişim bağlamı; ve SDK'nın ve edge'in topladığı her şeyi içeren bir teknik veri sekmesi; buna tarayıcının sunduğu API'lerden okunan gerçek sürüm de, beyan ettiği sürümün yanında dahildir.
İnceleme filtreleri. Erişim listesi; internet sağlayıcısına (ASN), ağ ülkesine, cihaz kurulumuna, bir göstergenin değerlendirilmeme gerekçesine ve aynı anda seçilen durumlardaki en fazla iki göstergeye göre daraltılır; bir erişimi kendi hesap ya da kişi referansınızla bulur. IP adresine göre filtre yoktur: kişisel veridir. Her erişim detayı ayrıca bağlam içgörülerini ↑ taşır.
Derinlemesine inceleyin. Herhangi bir erişimden bir bağlantı grafiği, kendi geçmişinizin 92 güne kadarı üzerinde, çevresindeki cihazları ve hesapları adım adım açar. Her genişletme kayda geçen bir okumadır; IP adresleri asla düğüme dönüşmez.
Engelleme ve izin listeleri. Ekibiniz, erişim detayından bir cihazı, bir hesap referansını ya da tek bir IP'yi şirketinizin engelleme listesine (engelle ya da incele) veya izin listesine, bir not ve ekleyenin adıyla koyar. Skorlu bir üretim erişiminde, bir kayıt öneriyi geçersiz kılar ve reason_codes içinde adıyla görünür. Hiçbir şey silinmez: bir kaydı kaldırmak, kimin ne zaman kaldırdığını kaydeder.
Yapay zekâ asistanı. Bir yan panel her ekranı açıklar ve şirketiniz ve rolünüz kapsamında kendi entegrasyonunuz ve erişimleriniz hakkındaki soruları yanıtlar.
Risk yapılandırması. Şirketinizin kendi risk kuralları, uygulama başına: 13 göstergenin her biri kapalı, hayalet ya da aktiftir, 1 ile 100 puan arasında bir ağırlıkla; skor aralıklarını ve her birinin işlemini siz belirlersiniz. Hayalet bir kural hesaplanır ve kaydedilir ama yanıtı asla değiştirmez. Yayımlamadan önce etki kartı taslağınızı son 1, 7 ya da 30 günün değerlendirmeleri üzerinde yeniden oynatır. 54 bağlam içgörüsünün ↑ her biri kendi puanıyla bunlara katılabilir. Yöneticiniz ya da risk sorumlunuz doğrudan yayımlar; her yayın denetlenen yeni bir sürümdür ve her şeyi hayalete al tüm kurallarınızı tek seferde durdurur. FingerTrackID sizin yerinize asla bir kuralı aktifleştirmez: desteği yalnızca bir uygulamanın tüm kurallarını, konsolunuzun gösterdiği bir gerekçeyle hayalete alabilir. Hiçbir kural aktif değilken, FingerTrackID ekibi tarafından kayıtlı onayla yayımlanan yönetilen politika yanıt verir.
Dört grupta on altı ekran · ana, tespit, operasyon, yönetim
İnceleme kuyruğu, para çekme inceleme modülüdür: aynı çekirdek üzerine kurulu, REVIEW için önerilen her v1 para çekme işlemini kanıtlarıyla birlikte bir kişiye getiren operasyonel bir kuyruk. Etiketli değerlendirmeler asla buna girmez ve politika, bugün yönetilen politikanın yaptığı gibi MONITOR önerdiği sürece kuyruk boş kalır.
İngilizce, Portekizce (Brezilya ve Portekiz), İspanyolca, Fransızca ve Almanca. Passkey ya da ikinci faktörle giriş; role göre yetkiler; hassas verileri kimin gördüğünün ve neyi kimin değiştirdiğinin denetim kaydı. Ham veri serbestçe görünmez: ona yapılan her erişim kaydedilir.
15 · Nasıl ücretlendiriyoruz
Fiyat, tamamlanan toplama hacmine göre tekliftedir. Gölge mod aynı birimleri tüketir ve konsolda tahmini kullanım olarak görünür; o dönem için faturaya neyin gireceği teklifte belirlenir.
Birim
Ölçüm birimi ve aday faturalandırma birimidir. Her device_intelligence_snapshot_id, o toplamayı kaç değerlendirme, etiket, sağlayıcı ya da yeniden işleme kullanırsa kullansın en fazla bir birim üretir.
Olay · birim oluşturur mu?
idempotency_key ile yeniden denemehayırcustomer_action ve sonuçhayır4xxhayır5xx, bizim tarafımızda zaman aşımı, INCONCLUSIVE ya da FAILED toplamahayırHacme göre teklif; gölge mod kullanımı masada.
Teklif isteyin16 · SSS
customer_action ve sonucu geri gönderirsiniz; konsolda erişim erişim öneriyi ekibinizin yaptığını bildirdiği işlemle karşılaştırır ve kanıt kapsamını takip edersiniz. Rakamlar tuttuğunda, önerinin bir kararı etkilemeye başlayıp başlamayacağına ve nerede başlayacağına ekibiniz karar verir; uygulama her zaman backend'inizdedir.tag gönderir; login, withdrawal ya da pix_transfer gibi küçük harfli bir slug: kayıt yok, kapalı liste yok, sınır yok. Konsol etikete göre filtreler, gruplar ve dışa aktarır; şablonlar (kayıt, giriş, parola kurtarma, ikinci faktör, profil değişikliği, para yatırma, para çekme, Pix transferi, alım satım, ödeme) bir entegrasyon kılavuzudur. Etiket asla politikayı, dedektörleri, yedek kuralı ya da süre sınırını seçmez: her etiketli değerlendirme aynı politika ve aynı 13 gösterge altında çalışır. Asla kişisel veri taşımamalıdır. İstek tutar, para birimi ya da alıcı taşımaz.BLOCK_RECOMMENDED var olan en güçlü öneridir ve yine de bir öneridir. Engellediğinizde customer_action: BLOCKED kaydedersiniz ve bu, önerinin doğru olup olmadığını ölçmek için veriye dönüşür.BLOCK_RECOMMENDED üretmez; şirketinizin yapılandırdığı kurallar, onun seçtiği ağırlıkları ve eşiği izler. Gizli mod ve tarayıcı korumaları nötr bağlamdır: kapsamı düşürebilir ve detayda görünebilirler, olumsuz bir gerekçe kodu olmadan. Tor, proxy, VPN ve hosting anonimleştirme bağlamıdır: bir politika bunları görülen diğer şeylerle birlikte ağırlıklandırabilir, asla etikete göre değil. Bugün yönetilen politikada skoru yalnızca otomasyon ve tarayıcı sahteciliği etkiler ve öneri MONITOR olur. Bu sayfadaki v1 para çekme sözleşme örneğinde tespit edilen Tor REVIEW sonucuna yol açtı ve gerekçe kodu bunu söylüyor. Kendi başına asla dolandırıcılık değildir.event_context_token olmadan çağırır ve INCONCLUSIVE, trust_score: null, evidence_coverage: 0, limitation_codes: ["COLLECTOR_NOT_LOADED"] ile yedek öneri olan MONITOR yanıtını alır. Asla uydurulmuş bir skor değil. Kanıt eksikliği nedeniyle asla ALLOW değil.deadline_ms bunu 250 ile 5000 arasında herhangi bir değere ayarlar (varsayılan için HTTP zaman aşımınızı yaklaşık 6 sn'nin üzerinde tutun); aşılırsa kısmi bir yanıt değil, bir Problem assessment-unavailable (503, retryable: true, Retry-After ile) alırsınız. Aynı mantıksal işlemi yeni bir request_id ile tekrarlayın. Gecikme ve SLA, herhangi bir karar yanıta bağlı olmadan önce gölge modunuzda ölçülerek teklife girer.key_id UUIDv7 tek herkese açık konum belirleyicidir; request_id tekrar oynatmaya (replay) karşı ayrılır; bir kimlik doğrulama hatası, anahtarın var olup olmadığını açığa çıkarmadan tek tip bir 401 döndürür. Sır asla taşınmaz. Protokolün normatif test vektörü sözleşmenin bir parçasıdır; onunla imzayı bayt bayt yeniden üretirsiniz.@fingertrackid/server çağrıyı imzalar; MCP sunucusu @fingertrackid/mcp, Claude Code, Cursor ya da MCP destekli herhangi bir ajana sözleşmeleri, imza vektörlerini, etiket başına hazır bir sunucu modülünü ve toplama alan adınızın kontrolünü verir, hepsi salt okunur; dokümantasyon da llms.txt ve AGENTS.md için hazır bir kural bloğu yayımlar. Sır sizin ortamınızda kalır; ajanın onu görmesine asla gerek yoktur.17 · İletişim
Gölge modda başlayın: yanıt hiçbir karara dokunmadan gerçek akışınızın yanında çalışır, karşılaştırırsınız, sonuçları geri gönderirsiniz ve öneriyi ancak ondan sonra kullanmaya başlarsınız. Kararın önemli olduğu ekranlarınız varsa ve yanıta güvenmeden önce açıklanmış halini görmek istiyorsanız, bizimle konuşun.
Demo talep edin
Nasıl başlar
Neler dahil
event-assessment.v1 sözleşmesi