> ## Documentation Index > Fetch the complete documentation index at: https://docs.didit.me/llms.txt > Use this file to discover all available pages before exploring further. # Geräte-Fingerprinting & IP-Risiko-API für KYC > Didit erkennt doppelte Geräte, Betrugsringe, VPNs, Proxys, Tor und verdächtige Geräte-Fingerprints bei der KYC-Verifizierung. Die Geräte- und IP-Analyse von Didit kombiniert Geräte-Fingerprinting, die Wiedererkennung duplizierter Geräte, IP-Informationen und Geolokalisierungsprüfungen im Verifizierungsablauf. Sie hilft zu erkennen, wenn dasselbe physische Gerät versucht, auf mehrere Konten zuzugreifen – selbst wenn der Benutzer Sitzungen wechselt, den Browserspeicher leert, ein Inkognito-Fenster öffnet oder Netzwerkinformationen rotiert. Integrations-Prompt für Geräte- und IP-Analyse Prompt in die Zwischenablage kopieren \

\````# Goal
Integrate Didit Device & IP Analysis (device fingerprinting + IP intelligence + geolocation) into your app.

\# Delivery mode
IP Analysis is **session-only**. The Web/Mobile SDK collects the device fingerprint and IP during the hosted flow — there is no standalone /v3/ip-analysis/ endpoint. It runs automatically on every session and does not require a workflow feature toggle for the basic signal set.

\# Steps
1\. (Optional) In the Business Console enable strict-mode rules for IP / device — e.g. "decline on VPN", "review on duplicate device", "decline on country mismatch with document".
2\. Create a session — POST /v3/session/ with { workflow_id, vendor_data, callback }. See /sessions-api/create-session.
3\. Open session.url for the user — the SDK collects fingerprint + IP in-band.
4\. Fetch the decision — GET /v3/session/{sessionId}/decision/ or subscribe to session.status.updated.

curl (create session):
\```bash
curl -X POST 'https://verification.didit.me/v3/session/' \
-H 'x-api-key: YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"workflow_id": "YOUR_WORKFLOW_ID",
"vendor_data": "user-123",
"callback": "https://yourapp.com/post-kyc"
}'
\```

\# Decision surface
The result lands under `ip_analyses[]` on the decision payload (one entry per IP/device collection point in the workflow). Each entry carries the resolved geo, ASN, VPN / proxy / Tor flags, device fingerprint id, duplicate-device matches, and the warnings array.

\# Status enum (per ip_analyses[].status)
"Not Started" | "In Progress" | "Approved" | "In Review" | "Declined" | "Abandoned" | "Kyc Expired"

\# Warnings (LogWarningChoices.LOCATION)
Heads-up: IP Analysis emits warnings under the **LOCATION** bucket (not "IP_ANALYSIS"). Risk codes include:
VPN_DETECTED, PROXY_DETECTED, TOR_DETECTED, DATACENTER_IP, HIGH_RISK_COUNTRY, LOCATION_MISMATCH_WITH_DOCUMENT, DUPLICATED_DEVICE, POSSIBLE_DUPLICATED_DEVICE, IMPOSSIBLE_TRAVEL, DEVICE_FINGERPRINT_BLOCKLISTED, DEVICE_LINKED_TO_LIVENESS_ATTACK, DEVICE_MODEL_INCONSISTENT.
Full catalogue: /core-technology/ip-analysis/warnings-ip-analysis.

\# Failure modes to handle
\- ip_analyses[] empty — the user blocked the SDK fingerprinting script (privacy extensions, content blockers). Decide whether to fail-closed or fall back to soft signals.
\- VPN_DETECTED / PROXY_DETECTED / TOR_DETECTED — treat per your fraud policy (decline, manual review, additional liveness step).
\- DUPLICATED_DEVICE — same device previously enrolled under a different vendor_data; merge accounts or block per policy.
\- LOCATION_MISMATCH_WITH_DOCUMENT — the IP country does not match the document's issuing country; route to review.

\# See also
\- Canonical schema: /reference/data-models#ip-analysis
\- Per-feature report: /core-technology/ip-analysis/report-ip-analysis
\- Risk catalogue: /core-technology/ip-analysis/warnings-ip-analysis
\- Full integration playbook: /integration/integration-prompt````

\
Einfügen in Die Funktion ist für Betrugspräventionsentscheidungen konzipiert, bei denen falsch positive Ergebnisse kostspielig sind. Exakte Übereinstimmungen duplizierter Geräte nutzen stabile persistente Identifikatoren. Wiedererkannte Geräteübereinstimmungen verwenden den v2-Fingerprint-Signalvektor und Prüfungen mit hohem Konfidenzwert, sodass Didit verdächtige Wiederverwendungen aufdecken kann, ohne nicht zusammenhängende Benutzer zu aggressiv zusammenzuführen.In der Academy-Lektion zum Lesen eines Verifizierungsergebnisses führt das Kapitel bei 9:49 durch die Signale der Geräte- und IP-Analyse.[Geräte- und IP-Analyse — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=589\&rel=0\&playsinline=1)![Übersicht über die Geräte- und IP-Analyse von Didit mit Geolokalisierung, Geräte-Fingerprinting, Geräteinformationen und VPN-Erkennung](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/ip-analysis.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=a2fbbbdd3d6fed3d759e54f362bf4762)![Architekturdiagramm der Geräte- und IP-Analyse von Didit mit Gegenprüfung von IP, Geräte-Fingerprint und angegebenem Standort](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/ip-analysis-how-it-works.jpg?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=3519ad9ad50091a00db5e09d5197fdfe)## FunktionsweiseDie Geräte- und IP-Analyse läuft während der Verifizierungssitzung automatisch ab und verknüpft Geräte-, Netzwerk- und Identitätskontext zu einer einheitlichen Risikobewertung.**1. Erfassung des Geräte-Fingerprints**Der Verifizierungs-Client sendet eine datenschutzfreundliche v2-Fingerprint-Payload mit Web- oder Mobilgerätesignalen:| Datenpunkt | Beschreibung | | - | - | | **Persistente Geräte-ID** | Erstanbieter-Identifikator für die exakte Erkennung desselben Geräts, solange der Speicher erhalten bleibt. | | **Zusammengesetzter Hash** | Stabiler gruppierter Signal-Hash für deterministische Duplikatprüfungen mit Kollisionsschutz. | | **Signalvektor** | Vektorisierte Geräte- und Browser-/App-Attribute für eine Wiedererkennung mit hohem Konfidenzwert. | | **Plattformkontext** | Browser-, Betriebssystem-, App-, Hardware-, WebGL-/Canvas-, Medien-, Gebietsschema-, Zeitzonen- und mobile Integritätssignale, sofern verfügbar. |**2. IP- und Verbindungsanalyse**Didit reichert die beobachteten Verbindungsdaten mit Netzwerk-Risikoinformationen an:- IP-Geolokalisierung nach Land, Region, Stadt und Koordinaten - Erkennung von VPN, Proxy, Tor, Rechenzentrum und privaten Netzwerken - Prüfungen auf erwartete IPs, wenn Sie eine zulässige Adresse für die Sitzung bereitstellen - In Ihrer Anwendung konfigurierte IP-Sperrlisten-Prüfungen**3. Duplikat- und Wiedererkennungsabgleich**Didit prüft, ob die aktuelle Sitzung mit vorherigen Sitzungen mit einem anderen `vendor_data`-Wert übereinstimmt:| Prüfung | Zweck | | - | - | | **Duplizierte IP** | Erkennt dieselbe Adresse über verschiedene Benutzer hinweg. | | **Duplizierter Geräte-Fingerprint** | Erkennt die exakte Wiederverwendung derselben persistenten Geräteidentität. | | **Wiedererkanntes Gerät** | Erkennt eine v2-Fingerprint-Wiederherstellung mit hohem Konfidenzwert, wenn sich die persistente ID geändert hat. | | **Kollisionsschutz** | Unterdrückt gepoolte Hashes geringer Qualität, anstatt nicht zusammenhängende Geräte zusammenzuführen. |**4. Standort-Gegenprüfungen**Die Geräte- und IP-Analyse vergleicht den Standortkontext mit vertrauenswürdigen Referenzpunkten:- Land des Dokuments und Adresskoordinaten - Erwartete Adresse der Sitzung - IP-Land und -Stadt - Entfernung und Richtung zwischen Adresse und IP-Standort**5. Aktion und Berichterstattung**Sie können jede Risikokategorie unabhängig konfigurieren und das Ergebnis in jeder Didit-Ausgabe nutzen:| Kanal | Beschreibung | | - | - | | **Workflow-Aktionen** | Genehmigung, Prüfung oder Ablehnung bei VPN/Proxy, Standortabweichung, duplizierter IP, exakt dupliziertem Gerät und wiedererkanntem Gerät. | | **Dashboard** | Prüfen Sie Warnungen, übereinstimmende Sitzungen, Geräteinformationen und Netzwerkdetails in der Didit-Konsole. | | **Webhooks und APIs** | Erhalten Sie strukturierte Warnungen und Treffer in Entscheidungs-Payloads. | | **Berichte** | Exportieren Sie Details der Geräte- und IP-Analyse in Verifizierungs-PDFs. |## AbgleichsmodellDie Geräte- und IP-Analyse trennt exakte Übereinstimmungen von wiedererkannten Übereinstimmungen, sodass Sie Reaktionen auf Betrugsfälle sicher anpassen können:| Schicht | Was erkannt wird | Umgang mit falsch positiven Ergebnissen | | - | - | - | | **Exakte persistente ID** | Dieselbe Erstanbieter-Geräteidentität erscheint in der Sitzung eines anderen Benutzers. | Stärkstes Signal. Wird für `DUPLICATED_DEVICE_FINGERPRINT` verwendet. | | **Zusammengesetzter Hash** | Derselbe deterministische Geräte-Hash erscheint in der Sitzung eines anderen Benutzers. | Durch Kollisionserkennung geschützt, sodass gängige WebView-/Browser-Pools unterdrückt werden. | | **Wiedererkanntes v2-Gerät** | Die persistente ID hat sich geändert, aber umfangreiche Gerätesignale stimmen mit hoher Konfidenz mit einem früheren Gerät überein. | Konservativ. Wird für `DEVICE_RECOVERED_HIGH_CONFIDENCE` erst nach Bestehen strikter Prüfungen verwendet. | | **IP-Wiederverwendung** | Dieselbe Adresse tritt bei mehreren Benutzern auf. | Kontextabhängig. Nützlich bei Betrugsringen, doch geteilte Büros, Haushalte und Mobilfunkanbieter können legitim sein. |Der Abgleich wiedererkannter Geräte nutzt einen dedizierten Vektor-Wiedererkennungsindex. Ist dieser Index nicht verfügbar, setzt Didit die exakten Duplikatprüfungen fort und gibt keine unscharfen Wiedererkennungskandidaten aus.In **Networks** hebt Didit zudem die Wiederverwendung von Residential-Proxys hervor, wenn dieselben Nicht-Rechenzentrums-IP-Informationen über mehrere unterschiedliche Benutzer oder Unternehmen hinweg auftreten. Der Graph zeigt das aggregierte Risikosignal, die Anzahl der betroffenen Entitäten, den Verbindungstyp sowie den ISP- und ASN-Kontext an; er gibt weder die rohe Adresse noch die Profildaten einer anderen Organisation preis.## Erkannte BetrugsmusterDie Geräte- und IP-Analyse hilft dabei, Folgendes zu erkennen und zu reduzieren:- Multi-Accounting und die Erstellung von Zweitkonten - Versuche zur KYC-Umgehung unter Verwendung desselben Geräts über verschiedene Identitäten hinweg - Betrugsringe, die viele Konten über geteilte Geräte oder eine gemeinsame Infrastruktur koordinieren - Bonus-Missbrauch, Empfehlungs-Missbrauch, Promo-Missbrauch und Testphasen-Missbrauch - Onboarding synthetischer Identitäten von wiederholt genutzten Geräten - Onboarding-Muster von Money Mules - Risiken von Kontoübernahmen durch unbekannte oder risikoreiche Geräte - Credential Stuffing und automatisierte Registrierungsversuche - Kartentests, Chargeback-Missbrauch und Rückerstattungsmissbrauch, gestützt durch wiederkehrende Geräte- und Netzwerkmuster - Verschleierung über VPN, Proxy, Tor, Rechenzentren und Residential-Proxys - Gerätemanipulation, Emulator-Nutzung, Jailbreak-/Root-Risiken und App-Cloning, sofern mobile Signale verfügbar sind - Standort-Spoofing und Abweichungen zwischen Dokument, IP, Zeitzone, Mobilfunkanbieter und Gerätekontext - Bot-gesteuerte Verifizierungsversuche mittels Headless-Browsern oder skriptgesteuerten Clients## Wichtigste Funktionen#### Geräte-Fingerprinting und Wiederherstellung- **Exakte Erkennung doppelter Geräte**: Erkennen Sie dieselbe Geräteidentität sitzungsübergreifend anhand unterschiedlicher `vendor_data`-Werte. - **Hochgradig verlässliche Wiederherstellung**: Stellen Sie wahrscheinliche Beziehungen desselben Geräts wieder her, wenn Speicheränderungen oder privates Surfen/Inkognito-Modi die persistente ID verändern. - **Kollisionsschutz**: Verhindern Sie das Zusammenführen nicht zusammenhängender Benutzer, wenn ein Geräte-Hash über viele verschiedene persistente IDs hinweg zu häufig vorkommt. - **Mobile- und Web-Abdeckung**: Nutzen Sie Webbrowser-Signale und native mobile Signale, einschließlich integritätsbezogener Felder, sofern verfügbar.#### IP- und Netzwerk-Intelligence- **VPN- und Proxy-Erkennung**: Identifizieren Sie verschleierte oder anonymisierte Verbindungen. - **Tor- und Rechenzentrumserkennung**: Markieren Sie risikoreiche Infrastruktur. - **Wiederverwendung von Residential-Proxys**: Erkennen Sie die wiederholte Nutzung desselben Residential-Netzwerks über verschiedene Subjekte hinweg, ohne den rohen IP-Wert im Networks-Graphen offenzulegen. - **IP-Sperrlisten**: Lehnen Sie Sitzungen automatisch ab, wenn die IP in der Sperrliste Ihrer Anwendung aufgeführt ist. - **Durchsetzung der erwarteten IP**: Vergleichen Sie die beobachtete IP mit einer erwarteten IP, die bei der Erstellung der Sitzung angegeben wurde.#### Geolokalisierung und Dokumentenabgleich- **Erkennung von Länderabweichungen**: Vergleichen Sie das Land des Dokuments mit dem Land der IP. - **Geofencing**: Akzeptieren Sie basierend auf der IP-Geolokalisierung nur Sitzungen aus zulässigen Ländern – mit Überschreibungen pro Bundesstaat/Region für Länder wie die Vereinigten Staaten. - **Prüfung der Adressdistanz**: Vergleichen Sie die Adresskoordinaten des Dokuments mit der IP-Geolokalisierung. - **Kontext übereinstimmender Sitzungen**: Geben Sie übereinstimmende Sitzungen mit Geräte- und Standortdetails für die manuelle Prüfung durch Prüfer zurück.## Aktionen konfigurierenVerwenden Sie die Workflow-Einstellungen, um die Aktion für jedes Risiko auszuwählen. Vorsichtige Kunden setzen `recovered_device_action` häufig zunächst auf `REVIEW`, beobachten Warnungen zu wiedererkannten Geräten einige Wochen lang und wechseln erst zu `DECLINE`, nachdem sie ihr lokales Falsch-Positiv-Profil bestätigt haben.| Einstellung | Empfohlene anfängliche Aktion | Grund | | - | - | - | | `vpn_detection_action` | `REVIEW` oder `DECLINE` | Hängt davon ab, ob die VPN-Nutzung in Ihrem Produkt zulässig ist. | | `ip_mismatch_action` | `REVIEW` | Eine Standortabweichung liefert starken Kontext, kann jedoch legitim sein. | | `duplicated_ip_action` | `REVIEW` | Geteilte Netzwerke können zu falsch positiven Ergebnissen führen. | | `duplicated_device_action` | `REVIEW` oder `DECLINE` | Die Wiederverwendung desselben Geräts über verschiedene Benutzer hinweg ist ein starkes Betrugssignal. | | `recovered_device_action` | `REVIEW` | Die hochgradig verlässliche Wiederherstellung ist bewusst konservativ ausgelegt, sollte jedoch vor einer automatischen Ablehnung überwacht werden. | | `ip_geofencing_action` | `DECLINE` | Geofencing drückt in der Regel eine strikte rechtliche Vorgabe aus; nutzen Sie `REVIEW`, wenn Sie eingeschränkte Standorte lieber manuell prüfen möchten. |Siehe [Warnungen der Geräte- und IP-Analyse](https://docs.didit.me/de/core-technology/ip-analysis/warnings-ip-analysis.md) für alle Risiko-Tags und [Workflow-Funktionskonfigurationen](https://docs.didit.me/de/management-api/workflows/feature-configs.md#geräte--und-ip-analyse) für API-Felder. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.