エンリッチメントの実行タイミング
取引の作成中にインラインで実行されます。subject.device_context.network_context.ip_address(またはいずれかの当事者のデバイスIP)を指定してPOST /v3/transactions/を送信します。- DiditがインメモリキャッシュでIPを検索します(TTLは24時間)。
- キャッシュにない場合は、共有IPエンリッチメントテーブルを確認します(鮮度は約30日)。
- データが古いか存在しない場合は、複数プロバイダーによるフェイルオーバーを備えたDiditのエンリッチメントパイプラインを通じてIPを照会します。
- エンリッチメントされたフィールドは取引レコードに書き戻され、ルールで利用できるようになります。
エンリッチされたフィールド
ルールでのエンリッチメントフィールドの使用
エンリッチメントフィールドはいずれもルールの条件として使用できます。よく使われるパターンは次のとおりです。 IPによる高リスク法域キャッシュレイヤー
最初の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エンリッチメントが表示される場所。