---
title: デバイスメタデータ
description: キャプチャに使用されたデバイスのメタデータ（プラットフォーム、IP、位置情報など）と、そのデバイスで検出されたリスクシグナルを返すCapability。
canonical: https://developer.unico.io/ja/dual-api/capabilities/device-metadata
locale: ja
generated_by: markdown-export
---

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

### 機能の概要

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

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

### 入力

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

- **Web & Native コントラクト:** お客様のアカウント向けに契約されたフローで有効化されます。プロセスの `capacities` に `PROCESS_CAPACITY_DEVICE_METADATA` が含まれます。
- **API コントラクト:** お客様の API キーの Recipe で有効化されます。

> **警告: メタデータは Unico SDK に依存します**
>
> メタデータを収集するのは、キャプチャ中の Unico SDK です。API 統合では Unico SDK を使用する場合と使用しない場合があります：
>
> - **Unico SDK を使用する API:** メタデータは通常どおり返されます。
> - **Unico SDK を使用しない API:** メタデータは存在せず、レスポンスは `not_found` になります。

有効化については Unico の担当者にお問い合わせください。

### 考えられるレスポンス

結果は `deviceMetadata` オブジェクトで返されます：

- **Web & Native コントラクト:** [プロセスの取得](/dual-api/developers/api-reference/web-sdk/get-process) の `authenticationInfo.deviceMetadata`。
- **API コントラクト:** [プロセスの取得](/dual-api/developers/api-reference/api/get-process) の `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 | デバイスで検出されたリスクシグナルのグループ。何も検出されなかった場合は空です。 |

デバイスが収集しなかったフィールドは、Web & Native コントラクトでは存在せず、API コントラクトでは `null` になります。

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

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

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

### 利用可能なサーフェス

| サーフェス | サポート |
|---|:-:|
| **SDK**（Android、iOS、Flutter） | ✅ |
| **Web**（iFrame、Redirect） | ✅ |

### 有効な組み合わせ

デバイスメタデータは、[利用可能なフロー](/dual-api/capabilities/available-flows)の事前構成された `flow` カタログには含まれません。お客様のアカウント向けに契約されたフロー（Web & Native コントラクト）またはお客様の API キーの Recipe（API コントラクト）で有効化され、Web および SDK 統合における他の任意の Unico 製品と組み合わせて有効化できます。

### このCapabilityを使用するユースケース

Web および SDK 統合における任意の Unico ユースケースに追加できます。