risk-db - IP-Abuse Reporting System & IP/Network/ASN Risk-Da

项目说明

Open IP, Network & ASN Risk-Databases

<p align="center">
<a title="Support this Project (Donate, Support-Licenses)" href="
<img src=" alt="Support Badge (Donate, Support-Licenses)"/>
</a>
</p>

----

![Lint]()
![Test]()

This project wants to help admins/systems flag large quantities of bad traffic.

Most generic attacks and bots originate from cloud-pro, datacenters and other threat-actors.

By flagging clients originating from these sources you can achieve a nice security impro.

The databases created from the gathered data will be and stay open-source!

If you (*just*) want to keep track of abusers internally - you could also host your dedicated instance of this app.

<a href="
<img src=" alt="World Map Example" width="70%"/>
<img src=" alt="ASN Chart Example" width="50%"/>
</a>

You can find basic examples for the latest data here: www.risk.oxl.app

---

Repositories

Simple Lists

You can find simple IP-/Network-/ASN-Lists here: O-X-L/risk-db-lists

Raw Data

If the raw report-data could be useful for a project of yours - please contact us at:

Categorizing Bot-Traffic

You can find information about how to categorize bot-traffic here: O-X-L/open-bot-list

----

Contribute

Contributions like reporting issues, engaging in discussions or PRs are welcome!

See also: Contributing

----

Usage

You SHOULD NOT just drop any requests from these sources.

There might be legit users using a VPN that would match as false-positive.

You might want to flag traffic from those sources and restrict their access like:

* Lower the rate-limits
* Show (more) captcha's on forms
* Lower lifetime of session cookies
* Add that flag to your logs so you can use it to analyze the traffic
* Deny access to administrati

Be aware that we cannot if reports are false-positives. We currently only keep track of simple reporter-reputation metrics.

----

Download Databases

![Database Updated At]()

ASN: JSON (Example)

Networks: IPv4, IPv6 (Example)

IPs: IPv4 JSON, IPv4 MMDB, IPv6 JSON, IPv6 MMDB (Examples: JSON, MMDB)

<details>
Databases marked with the key all include all reports.

The ones marked with med (*default*) and high only include reports from reporters that have a certain level of reputation.

We recommend the use of our GeoIP-ASN Database and IPInfo ASN/Country Databases to get more IP-metadata

ASN

* Reports of ASN in JSON-format / All / High

* Reports of filtered ASN in JSON-format (*only the ones tagged as hosting-, proxy- or *)

Networks

* Reports of IP in JSON-format / All / High

* Reports of IP in JSON-format / All / High

IPs

* Reports of IPv4 in JSON-format / All / High

* Reports of IPv4 in MMDB-format / All / High

* Reports of IPv6 in JSON-format / All / High

* Reports of IPv6 in MMDB-format / All / High

Tip:

You can use jq to easily filter the JSON data:

</details>

Download Limits:

* Without token: 2 Downloads per IP & day
* With token: 5 Downloads per IP & day

----

API

![API Uptime]()

Swagger API-Docs

* ASN Lists: Hosting, VPN, Crawler, Scanner, ISP (*extending lists dynamically is still under de..*)
* IP Lookup
* Network Lookup
* ASN Lookup

API Limits:

<details>

* Without token:
* 500 Requests per IP & 10 min
* 5000 Requests per IP & day
* Anti-DOS

* With token:
* 5000 Requests per IP & 10 min
* Anti-DOS

</details>

----

DNS-BL

You can also query IPs via DNS:

Query Limits: 60/min & 10k/day

For details see: src/riskdb/dnsbl and dnsbl-server

----

Report

![API Uptime]()

You can use our reporting API to report IPs!

A categories are: bot, probe, rate, attack, crawler, spam, malware, hosting, vpn, proxy

Limits:

<details>

* Without token:
* 500 Requests per IP & 10 min
* 5000 Requests per IP & day
* Anti-DOS

* With token:
* 5000 Requests per IP & 10 min
* Anti-DOS

</details>

If you want to get a (free) token for your systems - feel free to contact us at:

----

Integrations

#### Report Script

A simple script that follows the content of a specific log-file and parses abuser information from it.

See: Report Script

#### Graylog

See: Graylog Alert Reporting

#### Fail2Ban

TBD

----

Alternati

This project is still in an early stage.

You may also want to check out these projects: (*not open/free data*)

* CrowdSec
* AbuseIP-DB
* IPInfo Pri
* nitefood/asn CLI-Tools

----

License

Databases

BSD-3-Clause

Free to use.

If you are nice, you can optionally mention that you use this IP data:

----

Scripts (this repository)

GPLv3

项目信息

开发语言：Python

Star 数：38

技术要点

该项目属于防护思路方向的开源资源，代码结构清晰，适合安全研究人员学习参考。项目围绕IP-Abuse Reporting System & IP/Network/ASN Risk-Databases展开，提供了可运行的实现，对理解相关安全机制、工具原理与攻防技术具有较高的研究价值。

从技术实现角度看，此类项目的核心在于对底层原理的深入理解与工程化落地。开发者在研究过程中可以结合官方文档与社区讨论，梳理项目的初始化流程、核心模块职责与数据流转，逐步掌握其中的技术细节与设计思路。

使用与学习建议

1. 下载源码压缩包，解压到本地环境。

2. 根据项目类型准备对应的运行环境与依赖。

3. 按照 README 中的步骤完成配置与部署。

4. 在隔离的测试环境中运行验证，避免影响生产系统。

免责声明

本资源来源于开源社区，仅供安全研究、技术学习与合法授权范围内的攻防演练使用，请勿用于任何非法或侵害他人权益的用途。使用本项目产生的一切后果由使用者自行承担。