diff --git a/content/geoip/docs/databases/ip-risk.md b/content/geoip/docs/databases/ip-risk.md new file mode 100644 index 000000000..e858ce36d --- /dev/null +++ b/content/geoip/docs/databases/ip-risk.md @@ -0,0 +1,110 @@ +--- +draft: false +title: GeoIP IP Risk Databases +--- + +Maxmind's GeoIP IP Risk database contains all IP networks associated with +non-corporate proxies, VPNs, and other anonymous IP addresses, and other IP +addresses associated with risky activity. + +To learn more about the GeoIP IP Risk database, please see the +[GeoIP IP Risk database overview](https://get.maxmind.com/hubfs/Marketing/GeoIP%20IP%20Risk%20database/GeoIP%20IP%20Risk%20database%20product%20overview.pdf). +If you are interested in purchasing the database, please +[contact our Enterprise Business team](https://www.maxmind.com/en/solutions/connect-with-a-geoip-expert) +for assistance. + +{{< snippet "snippets/data-privacy-warning.md" >}} + +## Binary Database + +Binary databases make use of the +[MaxMind DB file format](https://maxmind.github.io/MaxMind-DB/). + +You can use the [mmdbinspect tool](https://github.com/maxmind/mmdbinspect) (in +beta), a command line interface built with Go, to look up one or more IPs from +one or more MMDB databases and receive output in a parsable JSON format. + +## CSV Database + +{{< snippet "snippets/csv-databases-intro.md" >}} + +{{< zip-file-content product-name="GeoIP2-IP-Risk" >}} + +{{< snippet "snippets/file-format.md" >}} + +### Blocks Files + +There are two CSV files for network blocks, one each for IPv4 and IPv6 blocks. +These are named `GeoIP2-IP-Risk-Blocks-IPv4.csv` and +`GeoIP2-IP-Risk-Blocks-IPv6.csv` respectively. + +{{< rawhtml >}} + +
+ + + + + + + + + + + + + + + + + + + + + +
NameTypeDescription
networkIP network as a string + This is the IPv4 or IPv6 network in CIDR format such as + "2.125.160.216/29" or "2001:c50::/32". We offer a utility to convert + this column to start/end IPs or start/end integers. See + the conversion utility section for + details. +
ip_riskdecimal + This field contains the risk associated with the IP address. The value + ranges from 0.01 to 99. A higher score indicates a higher risk. +
+ + Learn more about the IP risk score on our Knowledge Base. + +
+ min: 0.01, max: 99 +
+
+{{}} + +### Conversion Utility + +{{< snippet "snippets/conversion-utility.md" >}} + +## Example Files + +{{< snippet "snippets/example-files.md" >}} + +### CSV Example Files + +{{< csv-example-files >}} + +- [GeoIP2-IP-Risk-CSV_Example.zip](/static/GeoIP2-IP-Risk-CSV_Example.zip) + {{}} + +### MMDB Example Files + +{{< mmdb-example-files >}} + +- [GeoIP2-IP-Risk-Test.mmdb](https://github.com/maxmind/MaxMind-DB/blob/main/test-data/GeoIP2-IP-Risk-Test.mmdb) + {{}} + +## Database Changes + +{{< database-changes product="IP Risk" >}} diff --git a/content/geoip/docs/databases/static-ip-score.md b/content/geoip/docs/databases/static-ip-score.md new file mode 100644 index 000000000..66f9b2dfe --- /dev/null +++ b/content/geoip/docs/databases/static-ip-score.md @@ -0,0 +1,114 @@ +--- +draft: false +title: GeoIP Static IP Score Databases +--- + +This database indicates how static or dynamic an IP address is, which can be +useful for deciding whether an IP address represents the same user over time. + +To learn more about the GeoIP Static IP Score database, including terms and +pricing, please +[contact our Enterprise Business team](https://www.maxmind.com/en/solutions/connect-with-a-geoip-expert) +for assistance. + +{{< snippet "snippets/data-privacy-warning.md" >}} + +## Binary Database + +Binary databases make use of the +[MaxMind DB file format](https://maxmind.github.io/MaxMind-DB/). + +You can use the [mmdbinspect tool](https://github.com/maxmind/mmdbinspect) (in +beta), a command line interface built with Go, to look up one or more IPs from +one or more MMDB databases and receive output in a parsable JSON format. + +## CSV Database + +{{< snippet "snippets/csv-databases-intro.md" >}} + +{{< zip-file-content product-name="GeoIP2-Static-IP-Score" >}} + +{{< snippet "snippets/file-format.md" >}} + +### Blocks Files + +There are two CSV files for network blocks, one each for IPv4 and IPv6 blocks. +These are named `GeoIP2-Static-IP-Score-Blocks-IPv4.csv` and +`GeoIP2-Static-IP-Score-Blocks-IPv6.csv` respectively. + +{{< rawhtml >}} + +
+ + + + + + + + + + + + + + + + + + + + + +
NameTypeDescription
networkIP network as a string + This is the IPv4 or IPv6 network in CIDR format such as + "2.125.160.216/29" or "2001:c50::/32". We offer a utility to convert + this column to start/end IPs or start/end integers. See + the conversion utility section for + details. +
static_ip_scoredecimal + An indicator of how static or dynamic an IP address is. The value + ranges from 0 to 99.99 with higher values meaning a greater static + association. For example, many IP addresses with a user_type of + cellular have a score under one. Broadband IPs that don't change very + often typically have a score above thirty. +
+ This indicator can be useful for deciding whether an IP address + represents the same user over time. +
+ + Learn more about the static IP score on our Knowledge Base. + +
+ min: 0, max: 99.99 +
+
+{{}} + +### Conversion Utility + +{{< snippet "snippets/conversion-utility.md" >}} + +## Example Files + +{{< snippet "snippets/example-files.md" >}} + +### CSV Example Files + +{{< csv-example-files >}} + +- [GeoIP2-Static-IP-Score-CSV_Example.zip](/static/GeoIP2-Static-IP-Score-CSV_Example.zip) + {{}} + +### MMDB Example Files + +{{< mmdb-example-files >}} + +- [GeoIP2-Static-IP-Score-Test.mmdb](https://github.com/maxmind/MaxMind-DB/blob/main/test-data/GeoIP2-Static-IP-Score-Test.mmdb) + {{}} + +## Database Changes + +{{< database-changes product="Static IP Score" >}} diff --git a/content/geoip/docs/databases/user-count.md b/content/geoip/docs/databases/user-count.md new file mode 100644 index 000000000..e0b7fce36 --- /dev/null +++ b/content/geoip/docs/databases/user-count.md @@ -0,0 +1,177 @@ +--- +draft: false +title: GeoIP User Count Databases +--- + +The GeoIP User Count database provides insight into the number of expected users +on an IP address and on the associated subnet during the past 24 hours, helping +identify a variety of fraud including unauthorized access to content and click +fraud. + +To learn more about the GeoIP User Count database, including terms and pricing, +please +[contact our Enterprise Business team](https://www.maxmind.com/en/solutions/connect-with-a-geoip-expert) +for assistance. + +{{< snippet "snippets/data-privacy-warning.md" >}} + +## Binary Database + +Binary databases make use of the +[MaxMind DB file format](https://maxmind.github.io/MaxMind-DB/). + +You can use the [mmdbinspect tool](https://github.com/maxmind/mmdbinspect) (in +beta), a command line interface built with Go, to look up one or more IPs from +one or more MMDB databases and receive output in a parsable JSON format. + +## CSV Database + +{{< snippet "snippets/csv-databases-intro.md" >}} + +{{< zip-file-content product-name="GeoIP2-User-Count" >}} + +{{< snippet "snippets/file-format.md" >}} + +### Blocks Files + +There are two CSV files for network blocks, one each for IPv4 and IPv6 blocks. +These are named `GeoIP2-User-Count-Blocks-IPv4.csv` and +`GeoIP2-User-Count-Blocks-IPv6.csv` respectively. + +{{< alert warning >}} Please note that the CSV version of the GeoIP User Count +database contains separate CSV files covering the IPv4 and IPv6 space. All the +fields listed below are present as columns in both CSV files, but the values +associated with IPv6 fields in the IPv4 file will be `null`, and the IPv4 fields +in the IPv6 file will be `null`. {{}} + +{{< rawhtml >}} + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
NameTypeDescription
networkIP network as a string + This is the IPv4 or IPv6 network in CIDR format such as + "2.125.160.216/29" or "2001:c50::/32". We offer a utility to convert + this column to start/end IPs or start/end integers. See + the conversion utility section for + details. +
ipv4_32integer + The estimated number of users sharing the IPv4 address during the past + 24 hours. This is not an exact count of individual users but rather a + normalized value. +
+ + Learn more about the normalization and values of the user count on + our Knowledge Base. + +
ipv6_64integer + The estimated number of users sharing the IPv6 /64 network during the + past 24 hours. IPv6 /64 networks are usually assigned to individual + households and can be considered similar from a user perspective to an + individual IPv4 address. This is not an exact count of individual + users but rather a normalized value. +
+ + Learn more about the normalization and values of the user count on + our Knowledge Base. + +
ipv4_24integer + The estimated number of users sharing the IPv4 /24 network that the IP + address is contained within during the past 24 hours. This is not an + exact count of individual users but rather a normalized value. +
+ These values should be greater than the values provided in ipv4_32 + because they are representative of the number of users across a larger + number of IP addresses. +
+ + Learn more about the normalization and values of the user count on + our Knowledge Base. + +
ipv6_48integer + The estimated number of users sharing the IPv6 /48 network that the IP + address is contained within during the past 24 hours. This is not an + exact count of individual users but rather a normalized value. +
+ These values should be greater than the values provided in ipv6_64 + because they are representative of the number of users across a larger + number of IP addresses. +
+ + Learn more about the normalization and values of the user count on + our Knowledge Base. + +
+
+{{}} + +### Conversion Utility + +{{< snippet "snippets/conversion-utility.md" >}} + +## Example Files + +{{< snippet "snippets/example-files.md" >}} + +### CSV Example Files + +{{< csv-example-files >}} + +- [GeoIP2-User-Count-CSV_Example.zip](/static/GeoIP2-User-Count-CSV_Example.zip) + {{}} + +### MMDB Example Files + +{{< mmdb-example-files >}} + +- [GeoIP2-User-Count-Test.mmdb](https://github.com/maxmind/MaxMind-DB/blob/main/test-data/GeoIP2-User-Count-Test.mmdb) + {{}} + +## Database Changes + +{{< database-changes product="User Count" >}} diff --git a/hugo.toml b/hugo.toml index d9f2a9a45..2b1629688 100644 --- a/hugo.toml +++ b/hugo.toml @@ -209,6 +209,21 @@ title = 'MaxMind' pageRef = '/geoip/docs/databases/asn' parent = 'Database Documentation' weight = 70 + [[menus.geoip]] + name = 'IP Risk' + pageRef = '/geoip/docs/databases/ip-risk' + parent = 'Database Documentation' + weight = 80 + [[menus.geoip]] + name = 'Static IP Score' + pageRef = '/geoip/docs/databases/static-ip-score' + parent = 'Database Documentation' + weight = 90 + [[menus.geoip]] + name = 'User Count' + pageRef = '/geoip/docs/databases/user-count' + parent = 'Database Documentation' + weight = 100 [[menus.geoip]] name = 'GeoLite Databases and Web Services' pageRef = '/geoip/geolite2-free-geolocation-data' diff --git a/static/static/GeoIP2-IP-Risk-CSV_Example.zip b/static/static/GeoIP2-IP-Risk-CSV_Example.zip new file mode 100644 index 000000000..b088fd8f0 Binary files /dev/null and b/static/static/GeoIP2-IP-Risk-CSV_Example.zip differ diff --git a/static/static/GeoIP2-Static-IP-Score-CSV_Example.zip b/static/static/GeoIP2-Static-IP-Score-CSV_Example.zip new file mode 100644 index 000000000..e89515a76 Binary files /dev/null and b/static/static/GeoIP2-Static-IP-Score-CSV_Example.zip differ diff --git a/static/static/GeoIP2-User-Count-CSV_Example.zip b/static/static/GeoIP2-User-Count-CSV_Example.zip new file mode 100644 index 000000000..1c8700ff7 Binary files /dev/null and b/static/static/GeoIP2-User-Count-CSV_Example.zip differ