> ## 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.

# API Device Fingerprinting & Risiko IP untuk KYC

> Didit mendeteksi perangkat duplikat, sindikat penipuan, VPN, proksi, Tor, ketidakcocokan lokasi, dan sidik jari perangkat mencurigakan selama verifikasi KYC.

Analisis Perangkat & IP Didit menggabungkan fingerprint perangkat, pemulihan perangkat duplikat, kecerdasan IP, dan pemeriksaan geolokasi dalam alur verifikasi. Fitur ini membantu mendeteksi ketika perangkat fisik yang sama mencoba mengakses beberapa akun, bahkan ketika pengguna berganti sesi, menghapus penyimpanan browser, membuka jendela penyamaran (incognito), atau merotasi informasi jaringan.

Prompt Integrasi Analisis Perangkat & IP
        Salin prompt ke papan klip



      
      

\<pre>

\````# 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````

\</pre>



      
      

Tempel ke

Fitur ini dirancang untuk keputusan pencegahan penipuan saat positif palsu memiliki konsekuensi mahal. Pencocokan perangkat duplikat persis menggunakan pengidentifikasi persisten yang stabil. Pencocokan perangkat yang dipulihkan menggunakan vektor sinyal fingerprint v2 dan pemeriksaan berkeyakinan tinggi, sehingga Didit dapat menampilkan penggunaan ulang yang mencurigakan tanpa menggabungkan pengguna yang tidak terkait secara terlalu agresif.Dalam pelajaran Academy tentang membaca hasil verifikasi, bab 9:49 membahas sinyal analisis perangkat dan IP.[Analisis perangkat dan IP — Didit Academy](https://www.youtube.com/embed/7htTWCWsl60?start=589\&rel=0\&playsinline=1)![Gambaran umum Analisis Perangkat & IP Didit yang menampilkan geolokasi, fingerprint perangkat, kecerdasan perangkat, dan deteksi VPN](https://mintcdn.com/didit-0f962782/z6T2GHM4Zh-iSj-K/images/ip-analysis.png?fit=max\&auto=format\&n=z6T2GHM4Zh-iSj-K\&q=85\&s=a2fbbbdd3d6fed3d759e54f362bf4762)![Diagram arsitektur Analisis Perangkat & IP Didit yang memeriksa silang IP, fingerprint perangkat, dan lokasi yang dideklarasikan](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)## Cara kerjaAnalisis Perangkat & IP berjalan secara otomatis selama sesi verifikasi dan menghubungkan konteks perangkat, jaringan, serta identitas ke dalam satu permukaan risiko.**1. Pengambilan fingerprint perangkat**Klien verifikasi mengirimkan payload fingerprint v2 yang menjaga privasi dengan sinyal perangkat web atau seluler:| Poin Data | Deskripsi |
| - | - |
| **ID perangkat persisten** | Pengidentifikasi pihak pertama yang digunakan untuk deteksi perangkat yang sama persis saat penyimpanan bertahan. |
| **Hash komposit** | Hash sinyal terkelompok yang stabil digunakan untuk pemeriksaan duplikat deterministik dengan perlindungan tabrakan. |
| **Vektor sinyal** | Atribut perangkat dan browser/aplikasi yang divektorkan untuk pemulihan berkeyakinan tinggi. |
| **Konteks platform** | Sinyal browser, OS, aplikasi, perangkat keras, WebGL/canvas, media, lokal, zona waktu, dan integritas seluler jika tersedia. |**2. Analisis IP dan koneksi**Didit memperkaya data koneksi yang diamati dengan informasi risiko jaringan:- Geolokasi IP berdasarkan negara, wilayah, kota, dan koordinat
- Deteksi VPN, proksi, Tor, pusat data, dan jaringan privat
- Pemeriksaan IP yang diharapkan saat Anda memberikan IP yang diizinkan untuk sesi tersebut
- Pemeriksaan daftar blokir IP yang dikonfigurasi dalam aplikasi Anda**3. Pencocokan duplikat dan pemulihan**Didit memeriksa apakah sesi saat ini cocok dengan sesi sebelumnya dari `vendor_data` lain:| Pemeriksaan | Tujuan |
| - | - |
| **IP terduplikasi** | Mendeteksi alamat IP yang sama di berbagai pengguna yang berbeda. |
| **Fingerprint perangkat terduplikasi** | Mendeteksi penggunaan ulang persis dari identitas perangkat persisten yang sama. |
| **Perangkat yang dipulihkan** | Mendeteksi pemulihan fingerprint v2 berkeyakinan tinggi saat ID persisten berubah. |
| **Pengaman tabrakan** | Menekan hash gabungan berkualitas rendah alih-alih menggabungkan perangkat yang tidak terkait. |**4. Pemeriksaan silang lokasi**Analisis Perangkat & IP membandingkan konteks lokasi dengan titik referensi tepercaya:- Negara dokumen dan koordinat alamat
- Alamat IP sesi yang diharapkan
- Negara dan kota IP
- Jarak dan arah antara alamat dan lokasi IP**5. Tindakan dan pelaporan**Anda dapat mengonfigurasi setiap kategori risiko secara independen dan memanfaatkan hasilnya di setiap output Didit:| Saluran | Deskripsi |
| - | - |
| **Tindakan alur kerja** | Setujui, tinjau, atau tolak untuk VPN/proksi, ketidakcocokan lokasi, IP duplikat, perangkat duplikat persis, dan perangkat yang dipulihkan. |
| **Dasbor** | Tinjau peringatan, sesi yang cocok, informasi perangkat, dan detail jaringan di konsol Didit. |
| **Webhook dan API** | Terima peringatan dan kecocokan terstruktur dalam payload keputusan. |
| **Laporan** | Ekspor detail Analisis Perangkat & IP dalam PDF verifikasi. |## Model PencocokanAnalisis Perangkat & IP memisahkan kecocokan persis dari kecocokan yang dipulihkan sehingga Anda dapat menyesuaikan respons penipuan dengan aman:| Lapisan | Hal yang dideteksi | Sikap terhadap positif palsu |
| - | - | - |
| **ID persisten persis** | Identitas perangkat pihak pertama yang sama muncul di sesi pengguna lain. | Sinyal terkuat. Digunakan untuk `DUPLICATED_DEVICE_FINGERPRINT`. |
| **Hash komposit** | Hash perangkat deterministik yang sama muncul di sesi pengguna lain. | Dilindungi oleh deteksi tabrakan sehingga pool WebView/browser umum ditekan. |
| **Perangkat v2 yang dipulihkan** | ID persisten berubah, tetapi sinyal perangkat yang lengkap cocok dengan perangkat sebelumnya dengan keyakinan tinggi. | Konservatif. Digunakan untuk `DEVICE_RECOVERED_HIGH_CONFIDENCE` hanya setelah semua pemeriksaan ketat terpenuhi. |
| **Penggunaan ulang IP** | Alamat IP yang sama muncul di berbagai pengguna. | Kontekstual. Berguna untuk sindikat penipuan, tetapi kantor bersama, rumah tangga, dan operator seluler bisa jadi sah. |Pencocokan perangkat yang dipulihkan menggunakan indeks pemulihan vektor khusus. Jika indeks tersebut tidak tersedia, Didit tetap melanjutkan pemeriksaan duplikat persis dan tidak mengeluarkan kandidat pemulihan samar.Di **Jaringan**, Didit juga menyoroti penggunaan ulang proksi residensial ketika kecerdasan IP non-pusat data yang sama muncul di beberapa pengguna atau bisnis yang berbeda. Graf menampilkan sinyal risiko agregat, jumlah subjek, jenis koneksi, serta konteks ISP dan ASN; graf ini tidak mengungkap alamat IP mentah atau data profil organisasi lain.## Pola Penipuan yang TerdeteksiAnalisis Perangkat & IP membantu mengidentifikasi dan mengurangi:- Multi-akun dan pembuatan akun duplikat
- Upaya melewati KYC menggunakan perangkat yang sama di berbagai identitas berbeda
- Sindikat penipuan yang mengoordinasikan banyak akun dari perangkat atau infrastruktur bersama
- Penyalahgunaan bonus, penyalahgunaan referral, penyalahgunaan promo, dan penyalahgunaan uji coba gratis
- Onboarding identitas sintetis dari perangkat yang digunakan berulang kali
- Pola onboarding perantara uang
- Risiko pengambilalihan akun dari perangkat yang tidak dikenal atau berisiko tinggi
- Pengisian kredensial dan upaya pendaftaran otomatis
- Pengujian kartu, penyalahgunaan chargeback, dan penyalahgunaan pengembalian dana yang didukung oleh pola perangkat/jaringan berulang
- Penghindaran VPN, proxy, Tor, pusat data, dan proxy residensial
- Perusakan perangkat, penggunaan emulator, risiko jailbreak/root, dan kloning aplikasi jika sinyal seluler tersedia
- Spoofing lokasi dan ketidakcocokan antara dokumen, IP, zona waktu, operator, dan konteks perangkat
- Upaya verifikasi berbasis bot menggunakan browser headless atau klien skrip## Kemampuan Utama#### Pembuatan sidik jari dan pemulihan perangkat- **Deteksi perangkat duplikat persis**: Mendeteksi identitas perangkat yang sama di seluruh sesi dari nilai `vendor_data` yang berbeda.
- **Pemulihan dengan tingkat keyakinan tinggi**: Memulihkan hubungan perangkat yang kemungkinan sama saat penyimpanan berubah atau penjelajahan penyamaran/pribadi mengubah ID persisten.
- **Perlindungan benturan**: Menghindari penggabungan pengguna yang tidak terkait ketika hash perangkat tampak terlalu umum di banyak ID persisten yang berbeda.
- **Cakupan seluler dan web**: Menggunakan sinyal browser web dan sinyal seluler native, termasuk kolom terkait integritas jika tersedia.#### Inteligensi IP dan jaringan- **Deteksi VPN dan proxy**: Mengidentifikasi koneksi yang disamarkan atau dianonimkan.
- **Deteksi Tor dan pusat data**: Menandai infrastruktur berisiko tinggi.
- **Penggunaan ulang proxy residensial**: Mendeteksi penggunaan berulang dari jaringan yang sama dan tampak seperti jaringan residensial di berbagai subjek berbeda tanpa mengekspos nilai IP mentah di graf Networks.
- **Daftar blokir IP**: Menolak secara otomatis ketika IP muncul di daftar blokir aplikasi Anda.
- **Penegakan IP yang diharapkan**: Membandingkan IP yang diamati dengan IP yang diharapkan yang diberikan selama pembuatan sesi.#### Perbandingan geolokasi dan dokumen- **Deteksi ketidakcocokan negara**: Membandingkan negara dokumen dan negara IP.
- **Geofencing**: Hanya menerima sesi dari negara yang diizinkan — dengan penimpaan berdasarkan negara bagian/wilayah untuk negara seperti Amerika Serikat — berdasarkan geolokasi IP.
- **Pemeriksaan jarak alamat**: Membandingkan koordinat alamat dokumen dan geolokasi IP.
- **Konteks kecocokan sesi**: Mengembalikan sesi yang cocok dengan detail perangkat dan lokasi untuk peninjauan staf.## Konfigurasi TindakanGunakan pengaturan alur kerja untuk memilih tindakan bagi setiap risiko. Pelanggan konservatif sering kali menyetel `recovered_device_action` ke `REVIEW` terlebih dahulu, memeriksa peringatan perangkat yang dipulihkan selama beberapa minggu, dan baru beralih ke `DECLINE` setelah mengonfirmasi profil positif palsu lokal.| Pengaturan | Tindakan awal yang disarankan | Alasan |
| - | - | - |
| `vpn_detection_action` | `REVIEW` atau `DECLINE` | Tergantung pada apakah penggunaan VPN diizinkan di produk Anda. |
| `ip_mismatch_action` | `REVIEW` | Ketidakcocokan lokasi merupakan konteks yang kuat tetapi dapat bersifat sah. |
| `duplicated_ip_action` | `REVIEW` | Jaringan bersama dapat menghasilkan positif palsu. |
| `duplicated_device_action` | `REVIEW` atau `DECLINE` | Penggunaan ulang perangkat yang persis sama di seluruh pengguna merupakan sinyal penipuan yang kuat. |
| `recovered_device_action` | `REVIEW` | Pemulihan dengan tingkat keyakinan tinggi sengaja bersifat konservatif, tetapi harus dipantau sebelum penolakan otomatis. |
| `ip_geofencing_action` | `DECLINE` | Geofencing biasanya menyatakan aturan yurisdiksi yang ketat; gunakan `REVIEW` jika Anda lebih memilih triase manual untuk lokasi yang dibatasi. |Lihat [Peringatan Analisis Perangkat & IP](https://docs.didit.me/id/core-technology/ip-analysis/warnings-ip-analysis.md) untuk semua tag risiko dan [Konfigurasi Fitur Alur Kerja](https://docs.didit.me/id/management-api/workflows/feature-configs.md#analisis-perangkat-&-ip) untuk kolom API.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.