Skip to content

Commit 8f6d2cf

Browse files
dhogan8dhogan8
authored
Merge pull request #1483 from maxmind/dallas/add-geoip-dbs
Create basic dev docs for little-used premium databases
2 parents 6278efb + 6097779 commit 8f6d2cf

File tree

7 files changed

+416
-0
lines changed

7 files changed

+416
-0
lines changed

‎content/geoip/docs/databases/ip-risk.md‎

Lines changed: 110 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,110 @@
1+
---
2+
draft: false
3+
title: GeoIP IP Risk Databases
4+
---
5+
6+
Maxmind's GeoIP IP Risk database contains all IP networks associated with
7+
non-corporate proxies, VPNs, and other anonymous IP addresses, and other IP
8+
addresses associated with risky activity.
9+
10+
To learn more about the GeoIP IP Risk database, please see the
11+
[GeoIP IP Risk database overview](https://get.maxmind.com/hubfs/Marketing/GeoIP%20IP%20Risk%20database/GeoIP%20IP%20Risk%20database%20product%20overview.pdf).
12+
If you are interested in purchasing the database, please
13+
[contact our Enterprise Business team](https://www.maxmind.com/en/solutions/connect-with-a-geoip-expert)
14+
for assistance.
15+
16+
{{< snippet "snippets/data-privacy-warning.md" >}}
17+
18+
## Binary Database
19+
20+
Binary databases make use of the
21+
[MaxMind DB file format](https://maxmind.github.io/MaxMind-DB/).
22+
23+
You can use the [mmdbinspect tool](https://github.com/maxmind/mmdbinspect) (in
24+
beta), a command line interface built with Go, to look up one or more IPs from
25+
one or more MMDB databases and receive output in a parsable JSON format.
26+
27+
## CSV Database
28+
29+
{{< snippet "snippets/csv-databases-intro.md" >}}
30+
31+
{{< zip-file-content product-name="GeoIP2-IP-Risk" >}}
32+
33+
{{< snippet "snippets/file-format.md" >}}
34+
35+
### Blocks Files
36+
37+
There are two CSV files for network blocks, one each for IPv4 and IPv6 blocks.
38+
These are named `GeoIP2-IP-Risk-Blocks-IPv4.csv` and
39+
`GeoIP2-IP-Risk-Blocks-IPv6.csv` respectively.
40+
41+
{{< rawhtml >}}
42+
43+
<div class="table">
44+
<table>
45+
<tbody>
46+
<tr>
47+
<th>Name</th>
48+
<th>Type</th>
49+
<th>Description</th>
50+
</tr>
51+
52+
<tr>
53+
<td>network</td>
54+
<td>IP network as a string</td>
55+
<td>
56+
This is the IPv4 or IPv6 network in CIDR format such as
57+
"2.125.160.216/29" or "2001:c50::/32". We offer a utility to convert
58+
this column to start/end IPs or start/end integers. See
59+
<a href="#conversion-utility">the conversion utility section</a> for
60+
details.
61+
</td>
62+
</tr>
63+
64+
<tr>
65+
<td>ip_risk</td>
66+
<td>decimal</td>
67+
<td>
68+
This field contains the risk associated with the IP address. The value
69+
ranges from 0.01 to 99. A higher score indicates a higher risk.
70+
<br />
71+
<a
72+
href="https://support.maxmind.com/knowledge-base/articles/minfraud-ip-risk-score"
73+
>
74+
Learn more about the IP risk score on our Knowledge Base.
75+
</a>
76+
<br />
77+
min: 0.01, max: 99
78+
</td>
79+
</tr>
80+
</tbody>
81+
82+
</table>
83+
</div>
84+
{{</ rawhtml >}}
85+
86+
### Conversion Utility
87+
88+
{{< snippet "snippets/conversion-utility.md" >}}
89+
90+
## Example Files
91+
92+
{{< snippet "snippets/example-files.md" >}}
93+
94+
### CSV Example Files
95+
96+
{{< csv-example-files >}}
97+
98+
- [GeoIP2-IP-Risk-CSV_Example.zip](/static/GeoIP2-IP-Risk-CSV_Example.zip)
99+
{{</ csv-example-files >}}
100+
101+
### MMDB Example Files
102+
103+
{{< mmdb-example-files >}}
104+
105+
- [GeoIP2-IP-Risk-Test.mmdb](https://github.com/maxmind/MaxMind-DB/blob/main/test-data/GeoIP2-IP-Risk-Test.mmdb)
106+
{{</ mmdb-example-files >}}
107+
108+
## Database Changes
109+
110+
{{< database-changes product="IP Risk" >}}

‎content/geoip/docs/databases/static-ip-score.md‎

Lines changed: 114 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,114 @@
1+
---
2+
draft: false
3+
title: GeoIP Static IP Score Databases
4+
---
5+
6+
This database indicates how static or dynamic an IP address is, which can be
7+
useful for deciding whether an IP address represents the same user over time.
8+
9+
To learn more about the GeoIP Static IP Score database, including terms and
10+
pricing, please
11+
[contact our Enterprise Business team](https://www.maxmind.com/en/solutions/connect-with-a-geoip-expert)
12+
for assistance.
13+
14+
{{< snippet "snippets/data-privacy-warning.md" >}}
15+
16+
## Binary Database
17+
18+
Binary databases make use of the
19+
[MaxMind DB file format](https://maxmind.github.io/MaxMind-DB/).
20+
21+
You can use the [mmdbinspect tool](https://github.com/maxmind/mmdbinspect) (in
22+
beta), a command line interface built with Go, to look up one or more IPs from
23+
one or more MMDB databases and receive output in a parsable JSON format.
24+
25+
## CSV Database
26+
27+
{{< snippet "snippets/csv-databases-intro.md" >}}
28+
29+
{{< zip-file-content product-name="GeoIP2-Static-IP-Score" >}}
30+
31+
{{< snippet "snippets/file-format.md" >}}
32+
33+
### Blocks Files
34+
35+
There are two CSV files for network blocks, one each for IPv4 and IPv6 blocks.
36+
These are named `GeoIP2-Static-IP-Score-Blocks-IPv4.csv` and
37+
`GeoIP2-Static-IP-Score-Blocks-IPv6.csv` respectively.
38+
39+
{{< rawhtml >}}
40+
41+
<div class="table">
42+
<table>
43+
<tbody>
44+
<tr>
45+
<th>Name</th>
46+
<th>Type</th>
47+
<th>Description</th>
48+
</tr>
49+
50+
<tr>
51+
<td>network</td>
52+
<td>IP network as a string</td>
53+
<td>
54+
This is the IPv4 or IPv6 network in CIDR format such as
55+
"2.125.160.216/29" or "2001:c50::/32". We offer a utility to convert
56+
this column to start/end IPs or start/end integers. See
57+
<a href="#conversion-utility">the conversion utility section</a> for
58+
details.
59+
</td>
60+
</tr>
61+
62+
<tr>
63+
<td>static_ip_score</td>
64+
<td>decimal</td>
65+
<td>
66+
An indicator of how static or dynamic an IP address is. The value
67+
ranges from 0 to 99.99 with higher values meaning a greater static
68+
association. For example, many IP addresses with a user_type of
69+
cellular have a score under one. Broadband IPs that don't change very
70+
often typically have a score above thirty.
71+
<br />
72+
This indicator can be useful for deciding whether an IP address
73+
represents the same user over time.
74+
<br />
75+
<a
76+
href="https://support.maxmind.com/knowledge-base/articles/maxmind-user-context-data#static-ip-scoring"
77+
>
78+
Learn more about the static IP score on our Knowledge Base.
79+
</a>
80+
<br />
81+
min: 0, max: 99.99
82+
</td>
83+
</tr>
84+
</tbody>
85+
86+
</table>
87+
</div>
88+
{{</ rawhtml >}}
89+
90+
### Conversion Utility
91+
92+
{{< snippet "snippets/conversion-utility.md" >}}
93+
94+
## Example Files
95+
96+
{{< snippet "snippets/example-files.md" >}}
97+
98+
### CSV Example Files
99+
100+
{{< csv-example-files >}}
101+
102+
- [GeoIP2-Static-IP-Score-CSV_Example.zip](/static/GeoIP2-Static-IP-Score-CSV_Example.zip)
103+
{{</ csv-example-files >}}
104+
105+
### MMDB Example Files
106+
107+
{{< mmdb-example-files >}}
108+
109+
- [GeoIP2-Static-IP-Score-Test.mmdb](https://github.com/maxmind/MaxMind-DB/blob/main/test-data/GeoIP2-Static-IP-Score-Test.mmdb)
110+
{{</ mmdb-example-files >}}
111+
112+
## Database Changes
113+
114+
{{< database-changes product="Static IP Score" >}}

0 commit comments

Comments
 (0)