デバイスメタデータ

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

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

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

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

メタデータは Unico SDK に依存します

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

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

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

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

status が found の場合：

フィールド	型	説明
`deviceId`	string	デバイスの識別子。
`platform`	string	キャプチャ元のプラットフォーム。例：`WEB`、`ANDROID`、`IOS`。
`ip`	string	デバイスの IP アドレス。
`ipCountry`	string	IP アドレスの国。
`ipGeoCoordinates`	object	IP アドレスの位置（`lat`、`lng`）。
`gpsCoordinates`	object	デバイスの GPS が報告した位置（`lat`、`lng`）。
`osName`	string	オペレーティングシステム名。
`osVersion`	string	オペレーティングシステムのバージョン。
`browserName`	string	ブラウザ名。Web のみ。
`userAgent`	string	ブラウザのユーザーエージェント。Web のみ。
`appStore`	string	アプリのインストール元のアプリストア。ネイティブ SDK のみ。
`detectedSignals`	array 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 製品と組み合わせて有効化できます。

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