Watch-IP

訪問者ジオロケーションにVPN・Torのシグナルを追加する

訪問者の接続が既知のVPNネットワーク、Tor出口ノード、データセンター/ホスティングネットワーク、またはその他対応するネットワークカテゴリーと一致するかどうかを把握できます。Watch-IPは対象のGET /v1/geoレスポンスにこれらの指標を追加し、他の情報と合わせて評価できるようにします。

セキュリティ情報が含まれるプランを見るgeoリファレンスを読む →

対象プラン

securityはStarter、Growth、Scale、Enterpriseプランに含まれます。Freeプランではレスポンスから完全に省略されます—誤解を招くようなすべてfalseのオブジェクトが送られるわけではありません—そのため、フィールドを読み取る前にその存在を確認してください。

IPv4とIPv6の対応範囲は異なります

IPv4接続はTor、VPN、データセンター、脅威、制裁対象ネットワークのリストと照合されます。IPv6接続はTorを除くすべてと照合されます—現時点で無料のIPv6 Tor出口リストの情報源がないため、IPv6接続では実際にTor出口であるかどうかに関わらずisTorは常にfalseになります。IPv6の対応範囲をIPv4と同等であるとは記載しないでください。

省略、false、trueは異なる状態です

securityオブジェクトが省略されている場合、お使いのプランにこのデータが含まれていないことを意味し、接続がチェックされて安全だと判定されたわけではありません。含まれるフィールドでfalseの値は、Watch-IPが現在読み込んでいるリストに一致がなかったことを意味します—リスト型の検知はすべてを見つけられるわけではないため、安全であることが確認された判定ではありません。評価されていない結果やfalseの結果を「Clean」「Safe」「Verified」として表示しないでください。

情報源と更新

これらのフィールドの元になるリストは当社独自のストレージにコンパイルされ、定期的に更新されます。コールドスタート時は最初のルックアップで一時的にブロックされますが、読み込み後は、バックグラウンドで更新処理が実行される間、リクエストはインメモリキャッシュから提供されます。そのため、更新が遅延・失敗した場合は、破損したレスポンスではなく、古いデータや空のデータに劣化します。

審査ワークフローの例

isVpnやisDatacenterは、アカウント履歴やその他のシグナルと合わせた手動審査キューへの1つの入力として扱い、それだけを根拠に訪問者を完全にブロックしないでください。例えば、同じサインアップイベントで使い捨てメールチェックと組み合わせることは、すべてのVPN利用者を拒否するのではなく、少数のサインアップを審査に回す妥当な方法です。

これが行わないこと

これらのフィールドは住宅用プロキシを識別せず、本人確認も行わず、包括的な脅威・匿名性検知製品でもありません—これらは少数のリスト型指標です。

セキュリティレスポンスのフィールド

isTor
現在読み込まれているIPv4の出口リストから判定された、既知のTor出口ノード。IPv6では常にfalseです。
isVpn
既知の商用VPNプロバイダーのネットワーク。IPv4・IPv6両方に対応。
isDatacenter
データセンター/ホスティングネットワーク—多くのVPN出口がホスティング基盤上で稼働しているため、VPNの上位集合となります。
isThreat
既知の悪意あるIP範囲、または既知の脅威ASN上にあること。IPv4・IPv6両方に対応。
isSanctionedNetwork
Watch-IPが四半期ごとに見直している、国家制裁対象の通信/ホスティング事業者のリストに基づきます—他のフィールドより信頼度が低い緩やかなシグナルであり、制裁コンプライアンス審査ではありません。

セキュリティフィールドを安全に読み取る

ブラウザJavaScript

const response = await fetch('https://api.watch-ip.com/v1/geo', {
  headers: { 'X-Api-Key': 'YOUR_PUBLISHABLE_KEY' },
});
const geo = await response.json();

if (!geo.security) {
  // お使いのプランにはセキュリティデータが含まれていません—この接続について何も仮定しないでください。
} else if (geo.security.isVpn || geo.security.isDatacenter) {
  // リストとの一致—それ自体でブロックするのではなく、自社の審査ロジックへの1つの入力として使用してください。
} else {
  // 現在読み込まれているリストに一致なし—接続が安全であることの保証ではありません。
}

フィールドを読み取る前に、必ず`security`が存在するかどうかを分岐してください—オブジェクトが存在しない場合と、存在するがfalseの場合は異なる意味を持ちます。

よくある質問

住宅用プロキシを検知できますか?

いいえ。現在のリストは既知の商用VPN、Tor、データセンター、脅威/制裁対象ネットワークを対象としており、実際の消費者向けIPアドレスを経由するため、はるかにリスト照合が難しい住宅用プロキシサービスという広いカテゴリーは対象外です。

falseは何を意味しますか?

Watch-IPが現在読み込んでいるリストに一致がなかったことを意味します。リストがすべてのVPN、出口ノード、悪意のあるネットワークを網羅することはできないため、接続が安全であるという積極的な主張ではありません。

IPv6のTorは対応していますか?

いいえ。現在の実装には無料のIPv6 Tor出口リストの情報源がないため、IPv6接続ではisTorは常にfalseです。他のすべてのフィールドはIPv6に対応しています。

これらのチェックは任意のIPに対して利用できますか?

現時点では利用できません。このデータは接続元ブラウザ専用のGET /v1/geoレスポンスの一部であり、別のIPルックアップエンドポイント(/v1/lookup)はsecurityブロックを返しません。

1つのフラグだけでブロックできますか?

可能ですが、1つのリスト型フラグだけを根拠とする自動ブロックは、それ単体では弱い判断材料です—誤検知は発生しますし、正当な利用者も通常の理由でVPNや共有ネットワークを経由します。ほとんどの統合では、これらのフィールドを審査判断への1つの入力として使用しています。

関連ページ