01 · Device Intelligence für Betrugsprävention Die Journeys, die Sie taggen
Ein Tag pro Bildschirm Ihrer Wahl
Ein Script auf Ihrer Website liest Browser und Gerät in etwa einer Zehntelsekunde auf dem Desktop. Ein signierter Aufruf aus Ihrem Backend, mit einem Tag Ihrer Wahl, liefert sofort die Antwort: einen Vertrauensscore, die Nachweisabdeckung und 13 Indikatoren, von Bots und Automatisierung, gefälschten Browsern und Emulatoren bis zu VPN, Proxy und Tor, mit dem Grund hinter jeder Empfehlung. Erkennen Sie Kontoübernahme (Account Takeover), Fake-Registrierungen und Auszahlungsbetrug mit Nachweisen statt Bauchgefühl. Wir empfehlen. Sie entscheiden und handeln.
Synchrone Antwort auf jedem Bildschirm, den Sie taggen · Schattenmodus, bevor sie eine Entscheidung beeinflusst · Ihre Regeln, Ihre Listen, Ihre Entscheidung
So lesen Sie diese Antwort · Beispiel v1.1/login_completed
Warum diese Empfehlung
ALLOW
Kein Indikator, den die Richtlinie gewichtet, wurde als erkannt gemeldet. Vertragsbeispiel: Die verwaltete Richtlinie von FingerTrackID empfiehlt bei jedem Score MONITOR; ALLOW stammt aus einem Score-Bereich, den Ihr Unternehmen in seinen eigenen Risikoregeln festgelegt hat. Entschieden unter policy-login-v1.
Was der Score ist und was nicht
trust_score 100
Vertrauen in diesen Zugriff unter dieser Richtlinienversion, keine Betrugswahrscheinlichkeit. Außerhalb von COMPLETED ist er null, nie ein Standardwert.
Wie viel sichtbar war
evidence_coverage 100
Der Anteil der erwarteten Prüfungen, die ausgeführt wurden. Fehlende Nachweise würden hier benannt: Sie senken die Abdeckung und sind nie ein Risikogrund.
Dann liegt es bei Ihnen
customer_action
Ihr Backend entscheidet und handelt und meldet dann, was es getan hat und wie das tatsächliche Ergebnis war. Wir sperren nie und halten nie Geld zurück.
POST /v1/assessments → 201
event-assessment.v1.1 · Vertragsbeispiel
{ "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}
Versionen, die sie bestimmt haben · 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
13 Signale in der vollständigen Antwort · Indikatormatrix ↓
Das Produkt in Zahlen
Die Antwort
13
Web-Indikatoren in jeder Antwort
3
Zustände pro Indikator: erkannt, nicht erkannt, nicht bewertet
14
Benannte Gründe für „nicht bewertet“, nie ein stilles false
5
Mögliche Empfehlungen
3
Getrennte Messgrößen: Vertrauen, Geräteübereinstimmung, Nachweisabdeckung
1
Signierter Aufruf pro bewertetem Ereignis
Die Erfassung
17
Abschnitte mit Browser- und Gerätenachweisen pro Erfassung
48
Browser-APIs, geprüft gegen die Version, die der Browser angibt
125
Millisekunden oder weniger: Median der Desktop-Erfassung in Chrome, Firefox und Safari
0
Berechtigungsabfragen, die Ihren Nutzern angezeigt werden
Ihre Regeln und Ihre Untersuchung
54
Kontextelemente, in jeder Bewertung berechnet
67
Regeln, die Ihr Unternehmen in seinem eigenen Score gewichten kann: 13 Indikatoren und 54 Kontextelemente
6
Veröffentlichte Referenzlisten hinter den Netzwerkindikatoren
6
Konsolensprachen: Englisch, Portugiesisch (Brasilien und Portugal), Spanisch, Französisch, Deutsch
Niemals – und das ändert sich mit keinem Tarif
— Jeder Wert ist eine Anzahl aus einem versionierten Vertrag, Katalog oder einer Liste, mit Ausnahme der Erfassungszeit, gemessen auf unseren Testrechnern mit kaltem Cache. Keiner davon ändert sich mit Tarif oder Volumen.
03 · Anwendungsfälle
Device Intelligence beantwortet eine Frage, bevor Ihr Backend die Aktion durchlässt: Was steckt wirklich auf der anderen Seite dieses Bildschirms? Derselbe Aufruf dient jeder Journey; das Tag, das Sie senden, ordnet ihn nur ein.
login · password_recovery · profile_change
Ein bekanntes Konto auf einem Gerät, das es nie benutzt hat, ein Browser, der über sich selbst lügt, ein Anti-Detect-Browser, eine Reise, die in der Zeit nicht zu schaffen ist. Jedes davon kommt als Nachweis zurück, damit Sie einen zweiten Faktor nur dann verlangen, wenn es darauf ankommt.
signup · login · checkout
Headless-Browser, Automatisierungs-Frameworks, KI-Agenten, per Signatur identifiziert, und Datenverkehr aus Rechenzentren. BOT_AUTOMATION und NETWORK_HOSTING sagen, was gesehen wurde; die Abdeckung sagt, wie viel gesehen werden konnte.
signup · deposit · promotions
Konten und Personen pro Gerät und pro IP, wie selten das Geräteprofil in Ihrem Bestand ist, eine Erfassung, die auf einem anderen Gerät wiederholt wird. Kontext, den Ihre Regeln gewichten können, nie ein automatisches Urteil: Eine Person kann mehrere legitime Konten haben.
withdrawal · pix_transfer · trade
Eine Auszahlung in der ersten Stunde nach einem neuen Gerät, Begünstigte, die sich mehrere Konten teilen, Nachbarn, die Sie als bestätigten Betrug markiert haben. Ihr Backend hält das Geld zurück oder prüft es; wir tun das nie.
jede Journey
Android-Emulatoren und Virtualisierung, eine GPU, die für das angegebene System unmöglich ist, eine Browserversion, der die eigenen APIs widersprechen. Device-Fingerprinting-Signale, gelesen als Hashes und Familien, nie als Rohpixel.
jede Journey
Bekannte VPN-Anbieter, öffentliche Proxys, Tor-Exits, Hosting-Bereiche und Apple iCloud Private Relay, aus veröffentlichten Listen, die wir selbst aktualisieren. Anonymisierung ist Kontext, keine Schuld: Ihre Richtlinie entscheidet, wie viel sie wiegt.
04 · Die Messgrößen
Vertrauen, Abdeckung und Geräteübereinstimmung zu einer einzigen Zahl zu verschmelzen, verbirgt genau das, was der Analyst sehen muss: ob das Problem der Zugriff ist oder die Nachweise.
trust_score
72
Beantwortet, wie vertrauenswürdig dieser Zugriff unter dieser Richtlinienversion ist; das Tag, das Sie senden, ändert daran nichts. Ganzzahl von 0 bis 100. Existiert nur bei assessment_status = COMPLETED; in jedem anderen Zustand ist er null, nie ein Standardwert.
Keine Betrugswahrscheinlichkeit, nicht der Ruf der Person und kein Standardwert für fehlende Daten. Wir zeigen 72/100, nie „72 % vertrauenswürdig“.
device_match_confidence
0.94
Stärke des Nachweises, dass dieser Zugriff vom selben, bereits gesehenen Gerät kommt, von 0 bis 1. Kommt mit device_id, einer opaken öffentlichen Kennung des probabilistischen Clusters.
Nicht die Identität der Person und kein Beweis für die Hardware. Party und Account sind verschiedene Dinge.
evidence_coverage
100
Wie viel der erwarteten Prüfungen ausgeführt werden konnte, von 0 bis 100. Jeder anwendbare Indikator, der NOT_EVALUATED bleibt, senkt die Abdeckung und erscheint in limitation_codes.
Nicht Teil des Scores. Geringe Abdeckung drückt den Score weder nach unten noch nach oben: Sie lässt die Bewertung ergebnislos.
Warum wir sie nicht addieren
Ein einziger „Verdachts“-Score vermischt drei verschiedene Fragen: Verdient dieser Zugriff Vertrauen? Reichten die Nachweise aus? Ist es dasselbe Gerät? Kommt die Antwort getrennt, weiß Ihr Analyst, ob er einen zweiten Faktor verlangen, auf die Erfassung warten oder den Verlauf ansehen soll. Kommt sie verschmolzen, weiß er nur, dass „es 42 ergab“.
05 · 13 Indikatoren
Jede Web-Bewertung liefert die 13 Codes, immer. Was sich ändert, ist der Zustand jedes einzelnen, nie die Liste. Jeder Indikator hat seinen eigenen versionierten Detektor, und die Antwort nennt die Version, die ihn bewertet hat. Ein Detektor, der fehlt, abgelaufen ist oder fehlschlägt, wird nie zu false.
signal_catalog web · 13 Codes · Beispiel withdrawal_completed
Integrität der Umgebung
Browser-Privatsphäre · neutraler Kontext
Netzwerk · neutraler Kontext
Gerät
In unseren verwalteten Richtlinien rechtfertigt Tor allein nie BLOCK_RECOMMENDED; Regeln, die Ihr Unternehmen konfiguriert, folgen den Gewichten und dem Schwellenwert, die es gewählt hat. In diesem v1-Vertragsbeispiel hat policy-withdrawal-v1 eine Prüfung der Auszahlung verlangt, keine Sperre, und der einzige Reason Code sagt genau das. Die verwaltete Richtlinie in Produktion empfiehlt heute bei jedem Score MONITOR.
Derselbe Indikator, drei Zustände
Ein Detektor, der fehlt, abgelaufen ist oder fehlschlägt, wird nie zu false. NOT_APPLICABLE kommt nur aus der unveränderlichen Matrix des Katalogs nach Kanal, Engine und Plattform; Ihr Tag ändert daran nie etwas, und eine ausgeschaltete Richtlinie, ein Timeout oder ein Ausfall nehmen nie diese Abkürzung.
Standardmäßig neutraler Kontext
Sie können einschränken, was wir beobachten. Die Abdeckung sinkt nur dort, wo Nachweise nicht bewertet werden. Sie sind kein Betrug. Sie beschreiben die Umgebung; sie beschuldigen nicht die Person. In unseren verwalteten Richtlinien rechtfertigen sie für sich allein nie BLOCK_RECOMMENDED; Regeln, die Ihr Unternehmen konfiguriert, folgen den Gewichten und dem Schwellenwert, die es gewählt hat. Wenn sich die Netzwerkart nicht unterscheiden lässt, wie hinter Apple iCloud Private Relay, bleiben Hosting, VPN und Proxy alle NOT_EVALUATED mit NETWORK_TYPE_AMBIGUOUS: Wir markieren nie drei Erkennungen aus einem einzigen Boolean.
Netzwerknachweise stammen aus veröffentlichten Referenzlisten, die wir auf unserer eigenen Infrastruktur aktualisieren: Tor-Exit-Adressen, IP-Bereiche von Cloud-Anbietern, Hosting-Netzwerklisten, IP-Bereiche von VPN-Anbietern und eine Datenbank öffentlicher Proxys. Die Adressen Ihrer Nutzer werden nie an die Herausgeber der Listen gesendet. Eine Liste über ihrem Höchstalter lässt ihren Indikator NOT_EVALUATED, nie NOT_DETECTED.
06 · Kontextelemente
In jeder Bewertung berechnen wir vor der Antwort 54 Kontextelemente aus dem Erfassten und aus der eigenen Historie Ihres Unternehmens: Wer das Gerät sonst nutzt, wie schnell sich das Konto bewegt, aus welchem Netzwerk, neben welchen Konten. Die verwaltete Richtlinie von FingerTrackID hält sie aus dem Score heraus. In Ihren eigenen Risikoregeln kann jedes davon aus, im Schattenmodus oder aktiv sein, mit Punkten für ungewöhnlich und sehr ungewöhnlich: Ein aktives Kontextelement, das auslöst, zieht Punkte vom Vertrauensscore ab und nennt sich selbst in reason_codes.
context-insight.v1 · 54 Kontextelemente in sechs Themen · gruppiert wie in der Konsole und in Ihren Regeln
Konto und Gerät · 10
Neues Gerät und neues Betriebssystem für das Konto · verschiedene Konten und Personen auf dem Gerät über 30 Tage · Konten derselben Person darauf · Geräte pro Konto und pro Person über 24 Stunden · Gerät mit hoher Aktivität · wie verbreitet, unüblich oder selten das Geräteprofil in Ihrem Unternehmen ist · Geräte-Cookie verloren
Auszahlungen und Bestellungen · 7
Auszahlungen in der ersten Stunde nach einem neuen Gerät · Begünstigte pro Gerät und Konten pro Begünstigtem über 30 Tage · Anzahl und Betrag der Auszahlungen pro Konto · Anzahl der Bestellungen pro Konto und medianer Abstand zwischen Bestellungen
Netzwerk und Standort · 12
Neues Land und neuer Internetanbieter (ASN) für das Konto · verschiedene Länder, Anbieter und IPs pro Konto · Konten und Personen pro IP · unmögliche Reise · Browser-Zeitzone, die nicht zum Land der IP passt · VPN-Ausgangsland · Anbieter auf einer öffentlichen Missbrauchsliste · Apple iCloud Private Relay
Browser- und SDK-Integrität · 16
Entwicklertools geöffnet · Automatisierungsspuren · Marker eines Anti-Detect-Browsers · TLS-Signatur, die nicht zum angegebenen Browser passt, und ihre Stabilität über 30 Tage · Software-Renderer und GPU-Familie · Canvas oder Audio, die sich zwischen zwei Lesungen ändern · In-App-Browser · möglicher Gastmodus · per Signatur identifizierter KI-Agent · Bot-Kategorie · SDK, das vom freigegebenen Paket abweicht · eine SDK-Sitzung auf mehreren Geräten · identische Erfassung auf einem anderen Gerät wiederholt · Geräte-Cookie an zu weit voneinander entfernten Orten verwendet
Velocity · 5
Zugriffe pro Gerät und pro Konto über 5 Minuten, 1 Stunde und 24 Stunden; pro IP über 5 Minuten und 1 Stunde · Bewertungen mit demselben Tag pro Konto und pro Gerät über 1 Minute, 5 Minuten und 1 Stunde
Verbindungen zwischen Konten, ein Schritt · 4
Andere Konten, die dieselben Geräte genutzt haben · benachbarte Konten, bei denen Automatisierung oder Browser-Spoofing erkannt wurde · benachbarte Konten, die Sie als bestätigten Betrug markiert haben · Auszahlungsbegünstigte, die mit anderen Konten geteilt werden
Drei Zustände · ein Grund, nie eine Null
Manche Kontextelemente hängen davon ab, was Sie senden. Ohne Konto- oder Personenreferenzen, ohne Tag oder ohne Ergebnisse sagt das Element das: Konto nicht gesendet, Bewertung ohne Tag, keine Ergebnisse gesendet. Eine Anfrage mit Tag enthält weder Betrag noch Begünstigten, also sagen das auch die Elemente zu Auszahlungsbetrag und Begünstigtem. Ein erster Zugriff, ein anonymisiertes Netzwerk oder eine IP außerhalb des Einstundenfensters einer Prüfung sind ebenfalls Gründe.
Was sie nicht sind
reason_codes.Wo der Analyst sie liest
Zugriffsdetail. Eine Karte „Zugriffskontext“ gruppiert die Kontextelemente nach Thema, mit ihren Zeitfenstern, dem Stichtag der berücksichtigten Historie, wie ungewöhnlich jedes auf Ihrer Skala ist, und dem Grund für jedes Element ohne Wert. Ein Kontextelement, das nicht ins Zeitbudget der Bewertung passt, wird im Hintergrund fertiggestellt und sagt das; es verzögert die Antwort nie und lässt sie nie fehlschlagen.
Indikatorkatalog. Eine Seite erklärt, wonach jeder der 13 Indikatoren sucht, was ihn unbewertet lässt und ob er den Score bewegen kann, und listet die Kontextelemente mit den Gründen auf, aus denen sie ohne Wert bleiben können.
Canvas, WebGL, Audio und Schriften werden unter der verwalteten Erfassungsrichtlinie jedes Unternehmens gelesen, nur als abgeleitete Werte, und speisen einige dieser Kontextelemente, etwa die GPU-Familie, einen Software-Renderer oder ein Rendering, das sich zwischen zwei Lesungen ändert. Wo der Browser eine Prüfung nicht zulässt, bleibt das Element nicht bewertet, mit seinem Grund.
07 · Ergebnislos ist ein Ergebnis
Fehlende Nachweise erzeugen kein Vertrauen von 100, und sie werden nicht zum Betrugssignal. Ohne Score kommt die Empfehlung aus dem Fallback, der in der Richtlinienversion eingefroren und von ihrem Hash abgedeckt ist, und sie ist eine einzige Antwort für jeden Zustand ohne Score, unabhängig vom Tag: MONITOR. Nie ALLOW.
Fälle ohne Score aus den Vertragsbeispielen
Das Tag wählt nie den Fallback. In der verwalteten Richtlinie empfiehlt jeder Zustand ohne Score, bei jedem Tag, MONITOR: weitermachen und protokollieren. Das tun auch die drei Vertragsbeispiele unten.
INCONCLUSIVETag login · SDK nicht geladen
Keine Erfassung: trust_score: null, evidence_coverage: 0, COLLECTOR_NOT_LOADED, Basis INSUFFICIENT_EVIDENCE. Nichts wird je als ALLOW freigegeben.
INCONCLUSIVENetzwerknachweise nicht verfügbar
Vier Netzwerkindikatoren NOT_EVALUATED, evidence_coverage: 69, PROVIDER_UNAVAILABLE. Was auch immer die Operation ist, sie bleibt in Ihrem System, unter Ihrer Entscheidung; wir halten nie Geld zurück.
FAILEDTag pix_transfer · Richtlinie nicht verfügbar
Technischer Fehler: POLICY_UNAVAILABLE, policy_version: null, Basis TECHNICAL_FAILURE. Nie als „kein Risiko“ zu lesen.
Ohne Score empfehlen wir nie ALLOW · fallback_policy_version production-observation-fallback-v2 in den Beispielen · der Fallback wird bei jedem Lesen der Richtlinie mit ihr zusammen validiert
Vier Bewertungszustände
Die 14 Limitation Codes des Katalogs · was gefehlt hat, nie warum es riskant ist
Ein Limitation Code erklärt Erfassung und Qualität; ein Reason Code erklärt die Richtlinie. Jeder Indikator NOT_EVALUATED verweist auf seinen eigenen; die Bewertung fasst sie alle in limitation_codes zusammen. Eine Einschränkung der Erfassung ist nie ein Risikogrund.
08 · Sie entscheiden
recommended_action sagt, was die Richtlinie vorschlägt. customer_action sagt, was Sie getan haben. Zwei Felder, weil es zwei Fakten sind.
Wer empfiehlt, wer entscheidet, wer handelt
FingerTrackID empfiehlt
Nie allein wegen Privatsphäre · Tor, VPN, Proxy, Inkognito, geteiltes Gerät
Ihr Ablauf entscheidet
Ihr Backend entscheidet und handelt. Wir liefern eine Empfehlung; heute antwortet die verwaltete Richtlinie mit MONITOR, nur zur Beobachtung. Was mit dem Zugriff geschieht, wird auf Ihrer Seite entschieden und ausgeführt. Sie kennen das Konto, das Limit, die Historie und die Kosten von Reibung. Wir nicht.
Sie handeln und melden zurück
customer_action · das Feld, das Sie zurücksenden
Was jede Empfehlung nicht bedeutet
Die Richtlinie hat keinen Grund für Reibung bei diesem Zugriff gefunden. Bedeutet nicht, dass die Person legitim ist oder dass der Zugriff zertifiziert ist. Wird nur mit einem Score und den erforderlichen bewerteten Nachweisen ausgegeben.
Weitermachen, aber protokollieren. Es ist der Fallback ohne Score bei jedem Tag und heute auch die Antwort der verwalteten Richtlinie bei jedem Score. Bedeutet keinen bestätigten Verdacht, und es verlangt keine Aktion vom Nutzer.
Einen zweiten Faktor oder eine Bestätigung verlangen. Bedeutet nicht, dass wir jemanden herausfordern: Sie sind es, der die Abfrage anzeigt.
Zur manuellen Prüfung geben. Bedeutet nicht, dass wir Geld zurückhalten: Die Operation bleibt in Ihrem System, unter Ihrer Entscheidung.
Die Richtlinie schlägt Ablehnen vor. Bedeutet keine ausgeführte Sperre, keinen bestätigten Betrug und keinen Bann. Wenn Sie sperren, wird das zu customer_action: BLOCKED, einem Ereignis von Ihnen, und es fließt in die Messung der Treffsicherheit ein.
09 · Integration
Ein Script auf Ihrer Website, ein Server-to-Server-Endpunkt in Ihrem Backend und zwei Aufrufe, um Aktion und Ergebnis zurückzumelden. Keine Entscheidung auf dem Client.
SDK auf Ihrer Website
Ausgeliefert von einer Ihrer Subdomains. Bevor Sie die Anfrage senden, die bewertet werden soll, egal auf welchem Bildschirm, erfasst es Browser- und Umgebungssignale und erhält 202 PROCESSING: Es bestätigt den Empfang, kein Ergebnis. Netzwerksignale fügt der Edge auf Ihrer Erfassungsdomain hinzu, nie das Script. Kein Score, kein Signal und keine Entscheidung geht an den Browser zurück.
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
: nullIhr Backend ruft auf
HMAC-SHA-256 über zehn kanonische Zeilen — Marker, key_id, Methode, Pfad, Zeitstempel, Ereignis- und Anfrage-IDs, Inhaltsmetadaten und in der letzten Zeile der SHA-256 der exakten Body-Bytes. Serialisieren Sie das JSON vor dem Hashen nie neu; der Vertrag enthält den normativen Vektor. key_id ist der einzige öffentliche Locator. Das Secret wird nie übertragen. Kanonischer Vektor requests.both_refs_deadline_750 aus dem v1.1-Vertrag: dieselbe Route und dieselbe Signatur wie v1, mit einem tag statt journey, action und journey_context.
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 ist ein Slug in Kleinbuchstaben mit bis zu 64 Zeichen (Buchstaben, Ziffern und Unterstrich, höchstens zehn Ziffern), nie personenbezogene Daten; dieser Vektor liegt genau an dieser Grenze · subject_ref und account_ref dürfen null sein, und ein account_ref erfordert einen subject_ref · Refs sind opake Codes von Ihnen, nie eine Ausweisnummer, E-Mail oder fortlaufende ID · deadline_ms ist eine Ganzzahl von 250 bis 5000 oder null für 5000; wird sie überschritten, kommt ein wiederholbares 503-Problem zurück, kein Teil-Score
Synchrone Antwort
Dann zwei Feedback-Aufrufe: customer_action mit dem, was Sie getan haben, und, sobald Sie es wissen, truth_status mit dem tatsächlichen Ergebnis (dem Outcome: legitim, Betrug bestätigt oder unzureichende Nachweise). Der Vertrag hält beide an dieselbe Disziplin wie den Bewertungsaufruf: Nichts gilt vor einem dauerhaften Commit als angenommen, und eine identische Wiederholung erzeugt keinen zweiten Effekt. Ein Outcome kann später korrigiert werden — die Korrektur wird als Nachfolger angehängt, und der frühere Eintrag bleibt lesbar.
POST /v1/assessments/POST /v1/assessments/
Web, in jedem modernen Browser · keine App zu installieren · SDK, Bewertung und Feedback im selben versionierten Vertrag
npm install @fingertrackid/server signiert den Aufruf für Sie, und @fingertrackid/mcp lässt Claude Code, Cursor oder jeden MCP-fähigen Coding-Agenten die Integration aus dem veröffentlichten Vertrag verdrahten. Schritt für Schritt im Quickstart, im Web-SDK-Leitfaden und in der API-Referenz.
10 · Zero Trust im Browser
Nichts, was aus dem Browser kommt, gilt als Autorität. Die Bewertung läuft Server-to-Server, signiert, und jeder Versuch zählt einmal: Eine Wiederholung erzeugt keinen neuen Effekt.
Wer mit wem spricht
Der Browser erhält nur opake Sitzungs- und Ereignis-IDs. Score, Signale und Empfehlung entstehen auf dem Server und bleiben dort. Das First-Party-Cookie ist signiert, HttpOnly, Secure und auf Ihren Tenant und Ihre Anwendung beschränkt.
Anatomie des Aufrufs
ftidHmacV1 aus dem Vertragkey_id UUIDv7 ist der einzige Locator; Tenant, Anwendung, Umgebung und Capabilities werden erst nach einem gültigen MAC im zeitkonstanten Vergleich zur Autorität. X-Client-Id, Legacy-Nonce und Mehrfachsignaturen werden abgelehnt.request_id; ein ungültiger MAC erzeugt keine Reservierung.assessment-unavailable (503, retryable: true), kein Teil-Score.key_id, der nicht existiert, widerrufen wurde, oder eine falsche Signatur erzeugen alle dasselbe authentication-failed.key_id existiert. Signieren Sie eine neue request_id.11 · Versionierte Richtlinie
Die Empfindlichkeit eines Indikators zu ändern, erzeugt eine neue Version, mit Autor, Gültigkeitszeitraum, Simulation und Rollback. Die Historie ändert sich nicht. Fehlt eine echte Version, ist die Nutzung blockiert.
Entscheidende Version · Beispiel withdrawal_completed
policy-withdrawal-v1
correlation_id dient dem Support, ohne eine personenbezogene Kennung offenzulegen. Die offengelegten Versionen sind opake öffentliche Tags; interne Datenbank-IDs erscheinen nie in der API, im Webhook oder in der Konsole.
Was eine Richtlinienversion einfriert
Reproduzierbar, nie umgeschrieben
Beispiel login_completed
assessment_version1
supersedes_assessment_idnull
Beispiel login_completed_revision_2
assessment_version2
supersedes_assessment_id…0000000101
Eine operative Revision bewahrt die Richtlinie und jede andere Version, die zum received_at des Ereignisses galt. Eine neue Richtlinie über einem alten Ereignis ist eine separate Simulation; sie schreibt nie um, welche Empfehlung die historische Entscheidung geleitet hat.
12 · Schattenmodus
Im Schattenmodus läuft FingerTrackID neben dem, was Sie heute verwenden, ohne dass die Antwort eine Entscheidung berührt. Sie vergleichen, melden die tatsächlichen Ergebnisse zurück und beginnen erst dann, die Empfehlung zu nutzen. So empfehlen wir den Einstieg.
Der vollständige Zyklus
Das SDK erfasst
202 PROCESSING · event_context_token
Ihr Backend fordert die Bewertung an
POST /v1/assessments · synchron
Sie entscheiden in Ihrem Ablauf
im Schattenmodus, ohne die Antwort zu nutzen
Sie melden die Aktion
customer_action · POST …/customer-actions
Sie melden das Ergebnis
truth_status · POST …/outcomes
recommendation_alignment · auf dem Server aus dem Paar Empfehlung × Aktion abgeleitet; nie vom Client angegeben. Übereinstimmung beweist weder Kausalität noch Treffsicherheit noch Betrug.
Vergleich, Feld für Feld
| recommended_action | customer_action | recommendation_alignment |
|---|---|---|
REVIEW | REVIEWED oder HELD | ALIGNED |
STEP_UP | ALLOWED | NOT_ALIGNED |
ALLOW oder MONITOR | ALLOWED | ALIGNED |
BLOCK_RECOMMENDED | BLOCKED | ALIGNED |
| beliebig | CANCELLED | NOT_COMPARABLE |
Sperren beweist keinen Betrug. Die Bestätigung von Betrug erfordert unabhängige Nachweise: truth_status geht von PENDING zu LEGITIMATE, FRAUD_CONFIRMED oder INSUFFICIENT_EVIDENCE, mit Reife PROVISIONAL oder MATURE. Nur ein gereiftes Label wird zur Qualitätsmetrik.
Was der Zyklus speist
customer_action und truth_status sind getrennte Fakten, und jede Korrektur erzeugt einen Nachfolger.13 · Datenschutz per Vertrag
Personenbezogene Daten im Klartext sind keine Produktanforderung. Sie senden opake Personen- und Kontoreferenzen; wir verlangen weder Ausweisnummer noch E-Mail noch Telefonnummer, um einen Zugriff zu bewerten.
packages/contracts/src/sdk-handshake-v1.ts · Erfassungsrichtlinie
canvas: z.boolean(),
audio: z.boolean(),
fonts: z.boolean(),
behavioral: z.literal(false),packages/contracts/src/sdk-signals/rendering-v1.ts · Auszug
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(),Verhaltenserfassung, also Mausbewegungen und Tastenanschläge, akzeptiert nur den Wert off: Sie einzuschalten erfordert eine Vertragsänderung, keine Einstellung. Canvas, WebGL, Offline-Audio und Schriftpräsenz werden unter der verwalteten Erfassungsrichtlinie gelesen, die sie für jedes Unternehmen einschaltet, und sie verlassen den Browser nur als abgeleitete Werte: Hashes fester Länge, eine geschlossene GPU-Familie, eine Anzahl und eine Präsenzmaske über eine feste Schriftliste. Der Vertrag hat kein Feld für Pixel, Audio-Samples, GPU-Hersteller- oder Renderer-Namen oder Schriftnamen. Zusammen können diese abgeleiteten Werte denselben Browser wiedererkennen, deshalb werden sie als Gerätedaten behandelt, nicht als anonyme Daten. Als absolute Regel nie erfasst: Passwort, eingegebener Text, Chat- oder Dokumentinhalt, Zwischenablage, Screenshot, Mikrofon, Kamera. Jeder Nachweis hat eine Datenschutzklasse, und die Klasse ist kein Risikogewicht.
Garantien, die nicht vom guten Willen abhängen
tenant_id, mit in der Datenbank erzwungener Isolation. Es gibt keine Reputation und kein Label, das zwischen Kunden geteilt wird.HttpOnly, Secure, beschränkt auf Ihren Tenant und Ihre Anwendung. Der Wert gelangt nie in eine Datenbank, Queue oder ein Log; fehlt er oder wird er abgelehnt, verschlechtert sich die Kontinuität als Einschränkung, und die Bewertung stoppt nicht.Party ist nicht Account
Die Verknüpfung kommt aus Ihrem Backend · nie aus dem Fingerprint abgeleitet
Eine Person, mehrere legitime Konten. Ein Konto wechselt nie stillschweigend die Person; die Sitzung schreitet nur von anonym zu einer Person und dann zu einem Konto derselben Person fort. Ein Widerspruch ist ein Konflikt, keine neue Zuordnung und kein improvisierter negativer Nachweis.
Wo die Daten liegen
14 · Konsole
Die Konsole beantwortet zuerst „Empfangen, bewerten und erklären wir mit Qualität?“ und erst dann darf jemand über Legitimität sprechen. Jeder Prozentsatz nennt seinen Nenner.
Schema, kein Screenshot · Konsolenfarben innerhalb des Rahmens
Zugriffsdetail. Die drei Messgrößen als drei getrennte Komponenten; die Empfehlung mit ihrem recommendation_basis, die gültige Richtlinie und was Ihr Team gemeldet hat; die Aktualität der Nachweise; die 13 Indikatoren mit Zustand, Anwendbarkeit, Quelle, Detektorkonfidenz, Aktualität und dem Grund für jedes „nicht bewertet“; Einschränkungen und Reason Codes; Sitzung, Gerät und ihre Zuordnungen; Mehrfachnutzung auf dem Gerät; ein ungefährer Standort aus dem Netzwerk; der Zugriffskontext; und ein Tab mit technischen Daten mit allem, was SDK und Edge erfasst haben, einschließlich der echten Browserversion, gelesen aus den APIs, die er bereitstellt, neben der Version, die er angibt.
Untersuchungsfilter. Die Zugriffsliste lässt sich nach Internetanbieter (ASN), Netzwerkland, Geräteinstallation, dem Grund, aus dem ein Indikator nicht bewertet wurde, und bis zu zwei Indikatoren in gewählten Zuständen gleichzeitig eingrenzen, und sie findet einen Zugriff über Ihre eigene Konto- oder Personenreferenz. Es gibt keinen Filter nach IP-Adresse: Sie ist ein personenbezogenes Datum. Jedes Zugriffsdetail enthält außerdem seine Kontextelemente ↑.
Gründlich untersuchen. Von jedem Zugriff aus öffnet ein Verknüpfungsgraph die Geräte und Konten in seinem Umfeld, Schritt für Schritt, über bis zu 92 Tage Ihrer eigenen Historie. Jede Erweiterung ist ein protokollierter Lesevorgang; IP-Adressen werden nie zu Knoten.
Sperr- und Zulassungslisten. Aus dem Zugriffsdetail setzt Ihr Team ein Gerät, eine Kontoreferenz oder eine einzelne IP auf die Sperrliste Ihres Unternehmens (sperren oder prüfen) oder auf die Zulassungsliste, mit einer Notiz und dem Namen der Person, die sie hinzugefügt hat. Bei einem Produktionszugriff mit Score überschreibt ein Eintrag die Empfehlung und nennt sich selbst in reason_codes. Nichts wird gelöscht: Das Entfernen eines Eintrags protokolliert, wer ihn wann entfernt hat.
KI-Assistent. Ein Seitenbereich erklärt jede Ansicht und beantwortet Fragen zu Ihrer eigenen Integration und Ihren Zugriffen, innerhalb Ihres Unternehmens und Ihrer Rolle.
Risikoeinstellungen. Die eigenen Risikoregeln Ihres Unternehmens, pro Anwendung: Jeder der 13 Indikatoren ist aus, im Schattenmodus oder aktiv, mit einem Gewicht von 1 bis 100 Punkten, und Sie legen die Score-Bereiche und die Aktion jedes Bereichs fest. Eine Schattenregel wird berechnet und protokolliert, ändert aber nie die Antwort. Vor dem Veröffentlichen spielt die Wirkungskarte Ihren Entwurf über die Bewertungen der letzten 1, 7 oder 30 Tage nach. Jedes der 54 Kontextelemente ↑ kann mit eigenen Punkten hinzukommen. Ihr Administrator oder Risikoverantwortlicher veröffentlicht direkt; jede Veröffentlichung ist eine neue auditierte Version, und alle in den Schattenmodus stoppt alle Ihre Regeln auf einmal. FingerTrackID aktiviert nie eine Regel für Sie: Sein Support kann nur alle Regeln einer Anwendung in den Schattenmodus versetzen, mit einem Grund, den Ihre Konsole anzeigt. Solange keine Regel aktiv ist, antwortet die verwaltete Richtlinie, veröffentlicht vom FingerTrackID-Team mit protokollierter Freigabe.
Sechzehn Ansichten in vier Gruppen · Allgemein, Erkennung, Betrieb, Verwaltung
Die Prüfwarteschlange ist das Modul zur Prüfung von Auszahlungen: eine operative Warteschlange auf demselben Kern, die jede v1-Auszahlung, für die REVIEW empfohlen wird, mit den Nachweisen daneben einer Person vorlegt. Bewertungen mit Tag gelangen nie hinein, und sie bleibt leer, solange die Richtlinie MONITOR empfiehlt, wie es die verwaltete Richtlinie heute tut.
Auf Englisch, Portugiesisch (Brasilien und Portugal), Spanisch, Französisch und Deutsch. Anmeldung mit Passkey oder zweitem Faktor; Berechtigungen nach Rolle; ein Audit-Trail darüber, wer sensible Daten gesehen und wer was geändert hat. Rohdaten erscheinen nicht frei: Jeder Zugriff darauf wird protokolliert.
15 · Wie wir abrechnen
Preis nach Volumen abgeschlossener Erfassungen, festgelegt im Angebot. Der Schattenmodus verbraucht dieselben Einheiten und erscheint in der Konsole als geschätzte Nutzung; was für diesen Zeitraum in Rechnung gestellt wird, regelt das Angebot.
Die Einheit
Er ist die Messeinheit und die vorgesehene Abrechnungseinheit. Jedes device_intelligence_snapshot_id erzeugt höchstens eine Einheit, egal wie viele Bewertungen, Tags, Anbieter oder Neuverarbeitungen diese Erfassung nutzen.
Ereignis · erzeugt eine Einheit?
idempotency_keyneincustomer_action und Ergebnisnein4xx wegen Authentifizierung, Autorisierung oder ungültigem Vertragnein5xx, ein Timeout auf unserer Seite, Erfassung INCONCLUSIVE oder FAILEDneinAngebot nach Volumen, mit der Nutzung im Schattenmodus auf dem Tisch.
Angebot anfordern16 · FAQ
customer_action und das Ergebnis zurück, und in der Konsole vergleichen Sie Zugriff für Zugriff die Empfehlung mit dem, was Ihr Team gemeldet hat, und verfolgen die Nachweisabdeckung. Wenn die Zahlen stimmen, entscheidet Ihr Team, ob und wo die Empfehlung beginnt, eine Entscheidung zu beeinflussen, immer ausgeführt von Ihrem Backend.tag, einen Slug in Kleinbuchstaben wie login, withdrawal oder pix_transfer: keine Registrierung, keine geschlossene Liste und kein Limit. Die Konsole filtert, gruppiert und exportiert nach Tag, und die Vorlagen (Registrierung, Login, Passwortwiederherstellung, zweiter Faktor, Profiländerung, Einzahlung, Auszahlung, Pix-Überweisung, Trade, Checkout) sind ein Integrationsleitfaden. Das Tag wählt nie die Richtlinie, die Detektoren, den Fallback oder die Frist: Jede Bewertung mit Tag läuft unter derselben Richtlinie und denselben 13 Indikatoren. Es darf nie personenbezogene Daten enthalten. Die Anfrage enthält keinen Betrag, keine Währung und keinen Begünstigten.BLOCK_RECOMMENDED ist die stärkste Empfehlung, die es gibt, und sie bleibt eine Empfehlung. Wenn Sie sperren, protokollieren Sie customer_action: BLOCKED, und das wird zu Daten, um zu messen, ob die Empfehlung richtig war.BLOCK_RECOMMENDED; Regeln, die Ihr Unternehmen konfiguriert, folgen den Gewichten und dem Schwellenwert, die es gewählt hat. Privater Modus und Browser-Schutzfunktionen sind neutraler Kontext: Sie können die Abdeckung senken und im Detail erscheinen, ohne nachteiligen Reason Code. Tor, Proxy, VPN und Hosting sind Anonymisierungskontext: Eine Richtlinie kann sie zusammen mit dem gewichten, was sonst gesehen wurde, nie nach Tag. In der verwalteten Richtlinie bewegen heute nur Automatisierung und Browser-Spoofing den Score, und die Empfehlung ist MONITOR. Im v1-Vertragsbeispiel für Auszahlungen auf dieser Seite führte erkanntes Tor zu REVIEW, und der Reason Code sagt das. Es ist nie an sich Betrug.event_context_token auf und erhält INCONCLUSIVE, trust_score: null, evidence_coverage: 0, limitation_codes: ["COLLECTOR_NOT_LOADED"] und die Fallback-Empfehlung, MONITOR. Nie einen erfundenen Score. Nie ALLOW aus Mangel an Nachweisen.deadline_ms setzt sie auf einen Wert zwischen 250 und 5000 (halten Sie Ihr HTTP-Timeout für den Standard über etwa 6 s); wird sie überschritten, erhalten Sie ein Problem assessment-unavailable (503, retryable: true, mit Retry-After), keine Teilantwort. Wiederholen Sie dieselbe logische Operation mit einer neuen request_id. Latenz und SLA kommen ins Angebot, gemessen in Ihrem Schattenmodus, bevor eine Entscheidung von der Antwort abhängt.key_id UUIDv7 ist der einzige öffentliche Locator; request_id wird gegen Replay reserviert; ein Authentifizierungsfehler liefert ein einheitliches 401, ohne zu verraten, ob der Schlüssel existiert. Das Secret wird nie übertragen. Der normative Testvektor des Protokolls ist Teil des Vertrags; damit reproduzieren Sie die Signatur Byte für Byte.@fingertrackid/server signiert den Aufruf, der MCP-Server @fingertrackid/mcp gibt Claude Code, Cursor oder jedem MCP-fähigen Agenten die Verträge, die Signaturvektoren, ein fertiges Servermodul pro Tag und eine Prüfung Ihrer Erfassungsdomain, alles nur lesend, und die Dokumentation veröffentlicht llms.txt und einen fertigen Regelblock für Ihre AGENTS.md. Das Secret bleibt in Ihrer Umgebung; der Agent muss es nie sehen.17 · Kontakt
Starten Sie im Schattenmodus: Die Antwort läuft neben Ihrem echten Ablauf, ohne eine Entscheidung zu berühren, Sie vergleichen, melden die Ergebnisse zurück und beginnen erst dann, die Empfehlung zu nutzen. Wenn Sie Bildschirme haben, auf denen die Entscheidung zählt, und die Antwort erklärt sehen wollen, bevor Sie ihr vertrauen, sprechen Sie mit uns.
Demo vereinbaren
So geht es los
Was dazugehört
event-assessment.v1-Vertrag, mit einem HMAC-Testvektor