メインコンテンツへスキップ

デバイスメタデータ

Markdown

この機能は、ユーザーがキャプチャに使用したデバイスのデータを、契約済みの他の製品の結果とあわせて返します。

機能の概要​

キャプチャセッションで使用されたデバイスのメタデータと、そのデバイスで検出されたリスクシグナルを収集します(データの詳細は下記を参照)。

これは検証ではありません。プロセスを承認または否認することはなく、プロセスを失敗させることもありません。データは独自のリスクルールや社内の意思決定エンジンでご利用ください。

入力​

追加のフィールドは不要です。この機能は、プロセスがすでに持っているキャプチャセッションを使用します。

  • Web: Unico のジャーニー内で行われたキャプチャ。
  • Unico SDK を使用する API: アプリ内で Unico SDK によって行われたキャプチャ。
メタデータは Unico SDK に依存します

メタデータを収集するのは、キャプチャ中の Unico SDK です。API 統合では Unico SDK を使用する場合と使用しない場合があります:

  • Unico SDK を使用する API: メタデータは通常どおり返されます。
  • Unico SDK を使用しない API: メタデータは存在せず、レスポンスは not_found になります。

この機能は、お客様のアカウント向けに契約されたフローで有効化されます。有効化については Unico の担当者にお問い合わせください。

考えられるレスポンス​

結果は プロセスの取得 の authenticationInfo.deviceMetadata オブジェクトで返されます。

status意味
foundデバイスメタデータが見つかりました。以下のフィールドには、デバイスが収集した内容が入ります。
not_foundこのキャプチャのデバイスメタデータはありません。例:Unico SDK を使用しない API プロセス。
unavailableその時点でメタデータを取得できませんでした。プロセスの結果には影響しません。

status が found の場合:

フィールド型説明
deviceIdstringデバイスの識別子。
platformstringキャプチャ元のプラットフォーム。例:WEB、ANDROID、IOS。
ipstringデバイスの IP アドレス。
ipCountrystringIP アドレスの国。
ipGeoCoordinatesobjectIP アドレスの位置(lat、lng)。
gpsCoordinatesobjectデバイスの GPS が報告した位置(lat、lng)。
osNamestringオペレーティングシステム名。
osVersionstringオペレーティングシステムのバージョン。
browserNamestringブラウザ名。Web のみ。
userAgentstringブラウザのユーザーエージェント。Web のみ。
appStorestringアプリのインストール元のアプリストア。ネイティブ SDK のみ。
detectedSignalsarray of stringsデバイスで検出されたリスクシグナルのグループ。何も検出されなかった場合は空です。

フィールドが存在しない場合は、デバイスがそのデータを収集しなかったことを意味します。

detectedSignals には検出されたグループのみが列挙されます。グループは、そのシグナルのうち少なくとも1つが見つかった場合に検出されます:

グループ意味
origin_obfuscatedアクセスの本当の発信元が隠されています。例:Tor やアンチフィンガープリントツール。
untrusted_location位置情報が偽装されている可能性があります。例:プロキシ、VPN、GPS スプーファー。
environment_alteredデバイスの環境が改変されています。例:エミュレーター、root 化または脱獄されたデバイス。
app_manipulatedアプリが改ざん、フック、またはデバッグされています。
assisted_session別の人物がセッションを操作している可能性があります。例:画面共有やボット。
payload_untrustedデバイスから送信されたデータが改ざんされています。

すべてのシグナルがすべてのプラットフォームに存在するわけではないため、同じデバイスでも Web とネイティブ SDK で異なるグループが表示されることがあります。

利用可能なサーフェス​

必要な統合コンポーネント
SDK Web or SDK

有効な組み合わせ​

デバイスメタデータは、利用可能なフローの事前構成されたフローには含まれません。お客様のアカウント向けに契約されたフローで、Web および SDK 統合における他の任意の Unico 製品と組み合わせて有効化できます。

このCapabilityを使用する製品​

Web および SDK 統合における任意の Unico 製品に追加できます。