Skip to content

Latest commit

 

History

History
162 lines (105 loc) · 4.35 KB

README.md

File metadata and controls

162 lines (105 loc) · 4.35 KB
Raw

Honeypot Blocklist Logo

Honeypot from Sequoia Heights MS

Overview

This repository offers an integrated solution featuring a probe and client. Our blocklists, sourced from our honeypot network, are freely available. We provide a sync client for up-to-date protection and a probe tool for contributing new data. The blocklist contains IP addresses that have attempted unauthorized access on a honeypot probe, serving as a valuable resource for enhancing network security.

Features

  • Regularly updated list of malicious IP addresses.
  • Easy integration with various firewalls and security systems.
  • Helps prevent unauthorized access and potential security breaches.

Products

This repository offers two separate products:

  1. Honeypot Probe: Collects IPs from Fail2ban and uploads them to GitHub.
  2. Honeypot Client: Syncs IPs from GitHub and applies them to Firewalld or ufw.

Installation

Prerequisites

Ensure you have the following dependencies installed:

  • gcc
  • systemd
  • sqlite-devel
  • fail2ban (for the probe)
  • firewalld or ufw (for the client)
  • logrotate

Installing from RPMs (x86_64)

  1. Download the RPM files

    Download the latest RPMs for the probe and client from the releases page.

  2. Install the Probe

    sudo yum install honeypot-blocklist-probe-<version>.el9.x86_64.rpm
or
sudo yum install honeypot-blocklist-probe-<version>.el8.x86_64.rpm

  3. Install the Client

    sudo yum install honeypot-blocklist-client-<version>.el9.x86_64.rpm
or
sudo yum install honeypot-blocklist-client-<version>.el8.x86_64.rpm

Upgrading from 1.3-x to 1.4-x

/usr/local/bin/honeypot-probe --upgrade,
optional:
systemctl start honeypot-probe
systemctl start honeypot-client

Cloning the Repository

git clone https://github.com/sequoiaheightsms/honeypot-blocklist.git

Configuration

Honeypot Probe

The probe syncs fail2ban and applies new IPs to an SQLite DB in GitHub.

A helper script called setup.sh

./setup.sh --probe

it will help generate an SSH key pair (if it doesn't already exist) for secure communication with GitHub. The key will be labeled as id_rsa_probe. If the key exists, it will not generate a new one.

also it will install and configure Fail2ban by creating /etc/fail2ban/jail.local:

[sshd]
enabled  = true
port     = ssh
logpath  = %(sshd_log)s
backend  = %(sshd_backend)s
maxretry = 2
bantime  = 6h

and perform the installation of the RPMs and start and enable the services.

Honeypot Client

The client syncs the blocklist from GitHub and applies the IPs to Firewalld/UFW. The helper script can be used for installation and setup.

./setup.sh --client

Logging

Both the probe and client log their activities to:

  • Probe: /var/log/honeypot-probe.log
  • Client: /var/log/honeypot-client.log

Log rotation is handled by logrotate with the following configurations:

  • Probe: /etc/logrotate.d/honeypot-probe
  • Client: /etc/logrotate.d/honeypot-client

Contributing

We welcome contributions from the community. Here’s how you can contribute without using the honeypot probe:

  1. Fork the Repository: Click on the "Fork" button on the top right of this page.

  2. Clone Your Fork: Clone your forked repository to your local machine.

    git clone https://github.com/yourusername/honeypot-blocklist.git

  3. Create a Branch: Create a new branch for your feature or bug fix.

    git checkout -b feature-name

  4. Make Your Changes: Make your changes to the code.

  5. Commit Your Changes: Commit your changes with a descriptive commit message.

    git commit -m "Description of changes"

  6. Push Your Changes: Push your changes to your fork.

    git push origin feature-name

  7. Create a Pull Request: Create a pull request from your forked repository on GitHub.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contact

Please contact Robert Romero.

Acknowledgments

We want to thank all contributors and the community for their support and contributions.