メインコンテンツへスキップ
デバイスのIPアドレスを含むすべての取引は、ルールによる評価の前に、サーバー側でリアルタイムにエンリッチメントされます。エンリッチメントでは国、都市、VPN/Tor/データセンターのフラグ、ASN、通信キャリアが付加され、これらはすべてルールの条件として使用できます。

エンリッチメントの実行タイミング

取引の作成中にインラインで実行されます。
  1. subject.device_context.network_context.ip_address(またはいずれかの当事者のデバイスIP)を指定してPOST /v3/transactions/を送信します。
  2. DiditがインメモリキャッシュでIPを検索します(TTLは24時間)。
  3. キャッシュにない場合は、共有IPエンリッチメントテーブルを確認します(鮮度は約30日)。
  4. データが古いか存在しない場合は、複数プロバイダーによるフェイルオーバーを備えたDiditのエンリッチメントパイプラインを通じてIPを照会します。
  5. エンリッチメントされたフィールドは取引レコードに書き戻され、ルールで利用できるようになります。
エンリッチメントはインラインで実行され、ルールの実行前に完了しますが、失敗しても処理をブロックしません。エンリッチメントを完了できない場合でも取引は処理され、IPがエンリッチメントデータなしで表示されるだけです。

エンリッチされたフィールド

ルールでのエンリッチメントフィールドの使用

エンリッチメントフィールドはいずれもルールの条件として使用できます。よく使われるパターンは次のとおりです。 IPによる高リスク法域
VPN/Torの使用
データセンター/非住宅からのアクセス
IPアドレスの国 ≠ KYCの国

キャッシュレイヤー

最初の2つのレイヤーでヒットした場合、追加料金は発生しません。新規の解決処理は従量課金の対象となる場合があります。請求コンソールをご確認ください。

失敗時の動作

  • エンリッチメントの失敗が原因で取引の作成が失敗することはありません。
  • 欠落しているエンリッチメントフィールドは、それを参照するルールの条件には一致しません。
  • 処理が滞っているエンリッチメントに関するアラートは、内部モニタリングを通じてお客様の運用チームに通知されます。顧客への影響はありません。

有効性によるフィルタリング

ルーティングできないIPアドレスはエンリッチメントの前にスキップされます。
  • プライベート(10/8、172.16/12、192.168/16)
  • ループバック(127/8)
  • リンクローカル(169.254/16)
  • マルチキャスト、未指定
これにより、プロバイダーのクォータを節約し、無意味なエンリッチメントデータを避けられます。

取引のエンリッチメント内容の確認

APIで確認する。 独立したエンリッチメントブロックはありません。エンリッチメントされたフィールドは、parties配列の該当するエントリにある当事者自身のdevice.network_contextオブジェクト内に、送信したip_addressと並んで書き込まれます。
リクエストで指定したフィールドは保持されます。エンリッチメントは省略したキーのみを補完し、リゾルバーが空で返したキーは省略されます。deviceの完全な構造についてはレスポンススキーマを参照してください。 コンソールで確認する。 取引の詳細ページでは、IPとデバイスタブにIPエンリッチメントが地図上のピンとともに表示されます。

プライバシーに関する考慮事項

  • 生のIPアドレスは取引とともに保存されます。
  • エンリッチメントデータはIPをキーとする共有テーブルに保存され、ユーザーごとには保存されません。
  • 忘れられる権利に基づく削除では取引からIPが削除されますが、共有キャッシュのエントリは残ります(個人を特定する情報ではないため)。

次のステップ

ルール

条件でエンリッチされたフィールドを使用します。

ルールライブラリ

IPベースのプリセットルール。

レスポンススキーマ

IPエンリッチメントが表示される場所。
最終更新日 2026年11月1日