Metadata Perangkat

Markdown

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.

• Kontrak Web & Native: diaktifkan dalam alur yang dikontrak untuk akun Anda. Proses mencantumkan PROCESS_CAPACITY_DEVICE_METADATA di capacities.
• Kontrak API: diaktifkan dalam Recipe API key Anda.

Metadata bergantung pada Unico SDK

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.

Hubungi kontak Unico Anda untuk mengaktifkannya.

Kemungkinan respons

Hasilnya dikembalikan dalam objek deviceMetadata:

• Kontrak Web & Native: di authenticationInfo.deviceMetadata dari Dapatkan Proses.
• Kontrak API: di 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 dikumpulkan perangkat tidak muncul di kontrak Web & Native dan bernilai null di kontrak API.

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

Surface	Didukung
SDK (Android, iOS, Flutter)	✅
Web (iFrame, Redirect)	✅

Kombinasi yang valid

Metadata Perangkat bukan bagian dari katalog flow yang telah dikomposisikan sebelumnya di Alur yang tersedia. Kemampuan ini diaktifkan dalam alur yang dikontrak untuk akun Anda (kontrak Web & Native) atau dalam Recipe API key Anda (kontrak API), dan dapat diaktifkan bersama produk Unico lainnya dalam integrasi Web dan SDK.

Kasus penggunaan yang menggunakan kemampuan ini

Kemampuan ini dapat ditambahkan ke kasus penggunaan Unico mana pun dalam integrasi Web dan SDK.