AsnBlacklist

Plugin for Velocity and BungeeCord proxies that blocks user IPs based on their AutonomousSystemNumber (ASN). Protect your server against Layer 7 bot attacks with ASN-level filtering.

> WARNING! This solution ~~is quick fix~~ does not guarantee complete protection against all bots, > however, it correctly performs the intended functionality.

## Localization

The localization files are located in the `translations` directory of the plugin and support the (https://docs.advntr.dev/minimessage/format.html) format. Localization files are generated automatically on the first plugin startup. The message shown when a user is blocked by ASN can be configured using the `asnblacklist.message.kick` key. > Example: > > ```properties > asnblacklist.message.kick=Your ASN is blacklisted on this server. > ``` >

[!(https://raw.githubusercontent.com/novitpw/asn-blacklist/master/images/disconnect_reason_en.png)](https://raw.githubusercontent.com/novitpw/asn-blacklist/master/images/disconnect_reason_en.png)

If you need to display a message with line breaks, use the `` tag. > Example: > > ```properties > asnblacklist.message.kick=\ > Your ASN is blacklisted on this server. > ```

## Configuration

All duration formats must be specified using the standard ISO 8601 format, for example:

• `PT6H` → 6 hours
• `P3D` → 3 days
• `P2DT3H4M` → 2 days, 3 hours, 4 minutes

> ### asn-blacklist > > Blacklisted ASN. You can look up information or obtain the ASN number (https://bgp.tools/) > > Example: > > ```yaml > asn-blacklist: > - "AS35048" # Value with the AS prefix > - "53667" # Value without the AS prefix > ```

> ### maxmind-database > > MaxMind database settings. > > - `api-key` — MaxMind API key. The default configuration already includes a valid one. If necessary, you can use your own key generated (https://www.maxmind.com/en/accounts/current/license-key). > - `file` — Path to the local database file > - `ttl` — Local database retention period (ISO 8601). After the retention period expires, the database will be downloaded again. > > Example: > > ```yaml > maxmind-database: > api-key: "apiKey" > file: "GeoLite2-ASN.mmdb" > ttl: "P3D" > ```

> ### cache-ttl > > Cache duration for verified ASNs (ISO 8601). > > Example: > > ```yaml > cache-ttl: "PT12H" > ```

## Commands

• `/asnblacklist` - Main command. Aliases - `/asnbl`
• `/asnblacklist add ` - Add ASN to the blacklist.
• `/asnblacklist remove ` - Remove ASN from the blacklist.
• `/asnblacklist list` - Get blacklist of the ASN.
• `/asnblacklist reload` - Reload configuration and localization.

[!(https://raw.githubusercontent.com/novitpw/asn-blacklist/master/images/commands_en.png)](https://raw.githubusercontent.com/novitpw/asn-blacklist/master/images/commands_en.png)

## Support and Feedback

Please use the (https://github.com/novitpw/ans-blacklist/issues) to report bugs and submit suggestions.

The project is licensed under (https://github.com/novitpw/asn-blacklist/LICENSE).

# Описание на русском

Плагин для прокси Velocity и BungeeCord, предназначенный для блокировки IP адресов пользователей по AutonomousSystemNumber (ASN). Блокировка по ASN позволяет серверам защититься от ботов на уровне L7.

> ВНИМАНИЕ! Данное решение ~~является костылём~~ не гарантирует полноценную защиту от всех ботов, > однако, оно корректно выполняет задуманный функционал.

## Локализация

Локализация находится в директории `translations` плагина, поддерживает формат (https://docs.advntr.dev/minimessage/format.html). Файлы локализации создаются автоматически при первом запуске. Сообщение о блокировке пользователя по ASN настраивается с помощью ключа `asnblacklist.message.kick`. > Пример: > > ```properties > asnblacklist.message.kick=Ваш ASN заблокирован на данном сервере. > ``` >

[](https://raw.githubusercontent.com/novitpw/asn-blacklist/master/images/disconnect_reason.png)

Если необходимо вывести сообщение с переносами строк, то необходимо использовать тег ``. > Пример: > > ```properties > asnblacklist.message.kick=\ > Ваш ASN заблокирован на данном сервере. > ```

## Конфигурация

Все форматы времени указываются в стандарте ISO 8601, например:

• `PT6H` → 6 часов
• `P3D` → 3 дня
• `P2DT3H4M` → 2 дня, 3 часа, 4 минуты

> ### asn-blacklist > > Список заблокированных ASN. Узнать информацию или получить номер ASN можно [на сайте bgp.tools](https://bgp.tools/) > > Пример: > > ```yaml > asn-blacklist: > - "AS35048" # Значение с префиксом AS > - "536