Metadata Perangkat
Kemampuan ini mengembalikan data perangkat yang digunakan pengguna untuk pengambilan gambar, bersama dengan hasil produk lain yang dikontrak.
Apa yang dilakukannya
Mengumpulkan metadata perangkat yang digunakan dalam sesi pengambilan gambar dan sinyal risiko yang terdeteksi di perangkat tersebut (detail data di bawah).
Ini bukan validasi: kemampuan ini tidak pernah menyetujui atau menolak proses, dan tidak pernah membuat proses gagal. Gunakan data ini dalam aturan risiko Anda sendiri atau mesin keputusan internal Anda.
Input
Tidak diperlukan field tambahan. Kemampuan ini menggunakan sesi pengambilan gambar yang sudah dimiliki proses.
- Web: pengambilan gambar yang dilakukan dalam perjalanan Unico.
- API dengan Unico SDK: pengambilan gambar yang dilakukan oleh Unico SDK di aplikasi Anda.
Unico SDK adalah komponen yang mengumpulkan metadata, selama pengambilan gambar. Integrasi API dapat menggunakan atau tidak menggunakan Unico SDK:
- API dengan Unico SDK: metadata dikembalikan seperti biasa.
- API tanpa Unico SDK: tidak ada metadata, dan responsnya adalah
not_found.
Kemampuan ini diaktifkan dalam alur yang dikontrak untuk akun Anda. Hubungi kontak Unico Anda untuk mengaktifkannya.
Kemungkinan respons
Hasilnya dikembalikan dalam objek authenticationInfo.deviceMetadata dari Dapatkan Proses.
status | Arti |
|---|---|
found | Metadata perangkat ditemukan. Field di bawah diisi dengan data yang dikumpulkan perangkat. |
not_found | Tidak ada metadata perangkat untuk pengambilan gambar ini, misalnya proses API tanpa Unico SDK. |
unavailable | Metadata tidak dapat diambil pada saat itu. Hasil proses tidak terpengaruh. |
Ketika status adalah found:
| Field | Tipe | Deskripsi |
|---|---|---|
deviceId | string | Pengidentifikasi perangkat. |
platform | string | Platform asal pengambilan gambar, misalnya WEB, ANDROID, IOS. |
ip | string | Alamat IP perangkat. |
ipCountry | string | Negara alamat IP. |
ipGeoCoordinates | object | Lokasi alamat IP (lat, lng). |
gpsCoordinates | object | Lokasi yang dilaporkan oleh GPS perangkat (lat, lng). |
osName | string | Nama sistem operasi. |
osVersion | string | Versi sistem operasi. |
browserName | string | Nama browser. Hanya Web. |
userAgent | string | User agent browser. Hanya Web. |
appStore | string | Toko aplikasi tempat aplikasi Anda diinstal. Hanya SDK native. |
detectedSignals | array of strings | Grup sinyal risiko yang terdeteksi di perangkat. Kosong jika tidak ada yang terdeteksi. |
Field yang tidak muncul berarti perangkat tidak mengumpulkan data tersebut.
detectedSignals hanya mencantumkan grup yang terdeteksi. Sebuah grup terdeteksi ketika setidaknya satu sinyalnya ditemukan:
| Grup | Arti |
|---|---|
origin_obfuscated | Asal akses yang sebenarnya disembunyikan, misalnya oleh Tor atau alat anti-fingerprinting. |
untrusted_location | Lokasi mungkin palsu, misalnya oleh proxy, VPN, atau GPS spoofer. |
environment_altered | Lingkungan perangkat diubah, misalnya emulator atau perangkat yang di-root atau di-jailbreak. |
app_manipulated | Aplikasi telah dirusak, di-hook, atau di-debug. |
assisted_session | Orang lain mungkin mengendalikan sesi, misalnya melalui berbagi layar atau bot. |
payload_untrusted | Data yang dikirim oleh perangkat telah dirusak. |
Tidak semua sinyal ada di setiap platform, sehingga perangkat yang sama dapat menampilkan grup yang berbeda di web dan di SDK native.
Ketersediaan
| Komponen integrasi yang diperlukan |
|---|
| SDK Web or SDK |
Kombinasi yang valid
Metadata Perangkat bukan bagian dari alur yang telah dikomposisikan sebelumnya di Alur yang tersedia. Kemampuan ini dapat diaktifkan bersama produk Unico lainnya dalam integrasi Web dan SDK, dalam alur yang dikontrak untuk akun Anda.
Produk yang menggunakan kemampuan ini
Kemampuan ini dapat ditambahkan ke produk Unico mana pun dalam integrasi Web dan SDK.