Watch-IPのデータソースとカバレッジ

Watch-IPのレスポンスの各フィールドは、エンドポイントに応じて2つのソースのいずれかに由来します:接続元ブラウザに対する当社独自のネットワークレベルのデータ(GET /v1/geo)、または指定されたIPアドレスに対するサードパーティのDB-IP City LiteおよびASN Liteデータベース(GET/POST /v1/lookup)です。どちらのエンドポイントも、ソースが提供する位置情報から、同じ通貨/コンプライアンス/ロケール/日の出日の入り/祝日/年齢/税金のフィールドを算出します。メールチェックには独自のソースがあり、以下で説明します。このページでは、どのフィールドがどのソースに基づくか、何が欠けているか、誤りと思われる点をどう報告するかを示します — いずれかのソースをご自身で評価する方法は精度のページを参照してください。

GET /v1/geo:ネットワークレベルデータとローカルのエンリッチメント

country、region、regionCode、city、latitude、longitude、continent、postalCode、timezone、asn、asOrganizationは、接続元クライアントに対する自社のリクエストレベルのネットワークデータから取得されます—Watch-IPが別途維持するデータベースからではなく、リクエストのたびに新しく読み取られます。currency、callingCode、locale、sun(日の出・日の入り)、holiday、age、tax、complianceの各フィールドは、その位置情報とAPIに同梱された維持管理中の参照テーブルからローカルで算出されます。これらは地域に基づくヒントであり、訪問者について独立して観測された事実ではありません。security(VPN・Tor・データセンター・脅威・制裁対象ネットワークの指標)は、後述のリストデータと照合され、それを含むプランでのみ表示されます。

GET/POST /v1/lookup:DB-IP City Lite

指定されたアドレスに対するip、found、country、continent、region、city、latitude、longitudeは、DB-IPのCity Liteデータベースから取得されます。postalCodeとtimezoneはこのエンドポイントでは常にnullです—City Liteはこれらを提供しません—また、asn/asOrganization/securityはルックアップのレスポンスに一切含まれません。found: falseは、現在読み込まれているデータベースにそのアドレスと一致するレコードが存在しないことを意味します。同じ実装は、データベース自体が利用できない場合や読み込みが完了していない場合にもfound: falseを返すことがあるため、falseは「利用可能な結果がない」ことを意味するものとして扱い、そのアドレスに実際の位置情報が存在しないことの証明とはみなさないでください。

データソース: DB-IP(db-ip.com)—City Liteエディション。
帰属表示: IP Geolocation by DB-IP(db-ip.com)。このエディションに対するDB-IPのライセンス条件に基づきます。
更新頻度: City LiteについてのDB-IP自身のリリーススケジュールによって決まります。Watch-IPはレコードごとの鮮度を独自に検証していません。

セキュリティリストのカバレッジはネットワークの種類とIPバージョンによって異なる

isTor、isVpn、isDatacenter、isThreat、isSanctionedNetworkの各フィールドは、自社のネットワークレベルデータやDB-IPから導出されるのではなく、別途維持されているリストと照合されます。IPv4接続は5つのカテゴリーすべてと照合されます。IPv6接続はTorを除くすべてと照合されます—現在、無料で利用できるIPv6版のTor出口リストの情報源が存在しないためです。したがって、実際にTor出口であるかどうかにかかわらず、IPv6接続のisTorは常にfalseになります。これらのリストは自社のストレージ内で作成・保存され、スケジュールに従って更新されます。更新が遅延または失敗した場合、レスポンスが壊れるのではなく、リストデータが古くなる、または空になる形で劣化します。そのため、falseという結果は「現在読み込まれているリストに一致がなかった」ことを意味するだけであり、接続の安全性が検証されたことを意味するものでは決してありません。

メールチェック:使い捨てドメインリスト、DNS、登録データ

isDisposableは、コミュニティが管理する3つのオープンソースの使い捨てドメインリストを統合し数時間ごとに更新したリストと照合します。上流の誤った掲載で検出されないよう、大手メールボックスプロバイダーや企業ドメインの組み込み許可リストは除外されます。掲載ドメインのサブドメインも該当します。disposableSource: mx_hostは、掲載ドメインがどのメールサーバーを使っているかについてのWatch-IP独自の観測に基づきます — 複数の掲載ドメインを扱い、共有メールプロバイダーではないメールホストは使い捨てとして扱われます。mxは最大1日キャッシュされるリアルタイムのDNS検索(DNS-over-HTTPS)で、失敗したり遅かったりした検索は推測せずunknownとして報告されます。isFreeProvider、isRoleAccount、didYouMeanは、Watch-IPが管理する厳選テーブルに基づきます。emailDomainAgeDays(サインアップチェックのみ)は、RDAP経由の公開ドメイン登録データに基づき、7日間キャッシュされ、レジストリが公開していない場合はnullです。個々のメールボックスについて参照するソースはありません。

disposable-email-domains: github.com/disposable-email-domains/disposable-email-domains — CC0 / パブリックドメイン。
disposable/disposable-email-domains: github.com/disposable/disposable-email-domains — MITライセンス。
FakeFilter: github.com/7c/fakefilter — BSD-3-Clauseライセンス。
更新頻度: リストは数時間ごとに再取得されます。上流のダウンロードが失敗したり途中で切れたりした場合は、リストを縮小せず最後の正常なリストを保持します。

観測された値と算出された値の違い

country/region/city/座標/ASNは、観測された値に最も近いものとして扱ってください—該当するリクエストやアドレスについて、自社のネットワークレベルデータまたはDB-IPのデータベースから直接読み取られます。通貨、国番号、ロケール、日の出・日の入り、祝日、年齢、税、コンプライアンスの各フィールドは、その位置情報と静的な参照テーブルから導出された算出済みのヒントとして扱ってください:デフォルト値としては有用ですが、接続の先にいる人物について独立して検証された事実ではありません。

疑わしいエラーを見つけた場合

具体的なIPアドレスやリクエスト、そして期待していた結果とともにお問い合わせください—このページに記載されている既知の制限なのか、リストの記載が古くなっているのか、あるいはDB-IPに確認が必要な事項なのかを確認できます。Watch-IPはDB-IPの基盤データベースを管理していないため、修正までの期間を保証することはできませんが、この方法で報告された問題は追跡し、結果をお伝えします。