--- title: デバイスメタデータ description: キャプチャに使用されたデバイスのメタデータ（プラットフォーム、IP、位置情報など）と、そのデバイスで検出されたリスクシグナルを返すCapability。 canonical: https://developer.unico.io/ja/capabilities/device-metadata locale: ja generated_by: markdown-export --- # デバイスメタデータ この機能は、ユーザーがキャプチャに使用したデバイスのデータを、契約済みの他の製品の結果とあわせて返します。 ### 機能の概要 キャプチャセッションで使用されたデバイスのメタデータと、そのデバイスで検出されたリスクシグナルを収集します（データの詳細は下記を参照）。 これは検証ではありません。プロセスを承認または否認することはなく、プロセスを失敗させることもありません。データは独自のリスクルールや社内の意思決定エンジンでご利用ください。 ### 入力 追加のフィールドは不要です。この機能は、プロセスがすでに持っているキャプチャセッションを使用します。 - **Web:** Unico のジャーニー内で行われたキャプチャ。 - **Unico SDK を使用する API:** アプリ内で Unico SDK によって行われたキャプチャ。 > **メタデータは Unico SDK に依存します:** メタデータを収集するのは、キャプチャ中の Unico SDK です。API 統合では Unico SDK を使用する場合と使用しない場合があります： > > - **Unico SDK を使用する API:** メタデータは通常どおり返されます。 > - **Unico SDK を使用しない API:** メタデータは存在せず、レスポンスは `not_found` になります。 この機能は、お客様のアカウント向けに契約されたフローで有効化されます。有効化については Unico の担当者にお問い合わせください。 ### 考えられるレスポンス 結果は [プロセスの取得](/ja/developers/api-reference/get-process) の `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 | ### 有効な組み合わせ デバイスメタデータは、[利用可能なフロー](/ja/developers/start/flows)の事前構成されたフローには含まれません。お客様のアカウント向けに契約されたフローで、Web および SDK 統合における他の任意の Unico 製品と組み合わせて有効化できます。 ### このCapabilityを使用する製品 Web および SDK 統合における任意の Unico 製品に追加できます。 最終更新 **2026年10月28日**に