No project description provided
Project description
30 different honeypots in a single PyPI package for monitoring network traffic, bots activities, and username password credentials.
Why honeypots package is very powerful?
The honeypots respond back, non-blocking, can be used as objects, or called directly with the in-built auto-configure scripts! Also, they are easy to setup and customize, it takes 1-2 seconds to spin a honeypot up. You can spin up multiple instances with the same type. The output can be logged to a Postgres database, file[s], terminal or syslog for easy integration.
This honeypots package is the only package that contains all the following: dhcp, dns, elastic, ftp, http_proxy, http, https, imap, ipp, irc, ldap, memcache, mssql, mysql, ntp, oracle, pjl, pop3, postgres, rdp, redis, sip, smb, smtp, snmp, socks5, ssh, telnet, vnc.
Honeypots now is in the awesome telekom security T-Pot project!
Install
pip3 install honeypots
honeypots -h
Qeeqbox/honeypots customizable honeypots for monitoring network traffic, bots activities, and username\password credentials
Arguments:
--setup target honeypot E.g. ssh or you can have multiple E.g ssh,http,https
--list list all available honeypots
--kill kill all honeypots
--verbose Print error msgs
Honeypots options:
--ip Override the IP
--port Override the Port (Do not use on multiple!)
--username Override the username
--password Override the password
--config Use a config file for honeypots settings
--options Extra options (capture_commands for capturing all threat actor data)
General options:
--termination-strategy {input,signal} Determines the strategy to terminate by
--test Test a honeypot
--auto Setup the honeypot with random port
Usage Example - Auto configuration with default ports
Use a honeypot, or multiple honeypots separated by comma or word all
sudo -E python3 -m honeypots --setup ssh
Usage Example - Auto configuration with random port (No need for higher privileges)
Use a honeypot, or multiple honeypots separated by comma or word all
python3 -m honeypots --setup ssh --auto
Usage Example - Auto configure with specific ports
Use as honeypot:port or multiple honeypots as honeypot:port,honeypot:port
python3 -m honeypots --setup imap:143,mysql:3306,redis:6379
Usage Example - Custom configure with logs location
Use a honeypot, or multiple honeypots separated by comma or word all
python3 -m honeypots --setup ssh --config config.json
config.json (Output to folder and terminal)
{
"logs": "file,terminal,json",
"logs_location": "/var/log/honeypots/",
"syslog_address": "",
"syslog_facility": 0,
"postgres": "",
"sqlite_file":"",
"db_options": [],
"sniffer_filter": "",
"sniffer_interface": "",
"honeypots": {
"ftp": {
"port": 21,
"ip": "0.0.0.0",
"username": "ftp",
"password": "anonymous",
"log_file_name": "ftp.log",
"max_bytes": 10000,
"backup_count": 10
}
}
}
config.json (Output to syslog)
{
"logs": "syslog",
"logs_location": "",
"syslog_address": "udp://localhost:514",
"syslog_facility": 3,
"postgres": "",
"sqlite_file":"",
"db_options": [],
"sniffer_filter": "",
"sniffer_interface": "",
"honeypots": {
"ftp": {
"port": 21,
"ip": "0.0.0.0",
"username": "test",
"password": "test"
}
}
}
config.json (Output to Postgres db)
{
"logs": "db_postgres",
"logs_location": "",
"syslog_address":"",
"syslog_facility":0,
"postgres":"//username:password@172.19.0.2:9999/honeypots",
"sqlite_file":"",
"db_options":["drop"],
"sniffer_filter": "",
"sniffer_interface": "",
"honeypots": {
"ftp": {
"port": 21,
"username": "test",
"password": "test"
}
}
}
config.json (Output to Sqlite db)
{
"logs": "db_postgres",
"logs_location": "",
"syslog_address":"",
"syslog_facility":0,
"postgres":"",
"sqlite_file":"/home/test.db",
"db_options":["drop"],
"sniffer_sniffer_filter": "",
"sniffer_interface": "",
"honeypots": {
"ftp": {
"port": 21,
"username": "test",
"password": "test"
}
}
}
db structure
[
{
"id": 1,
"date": "2021-11-18 06:06:42.304338+00",
"data": {
"server": "'ftp_server'",
"action": "'process'",
"status": "'success'",
"ip": "'0.0.0.0'",
"port": "21",
"username": "'test'",
"password": "'test'"
}
}
]
Usage Example - Import as object and auto test
#ip= String E.g. 0.0.0.0
#port= Int E.g. 9999
#username= String E.g. Test
#password= String E.g. Test
#options= Boolean or String E.g OpenSSH 7.0
#logs= String E.g db, terminal or all
#always remember to add process=true to run_server() for non-blocking
from honeypots import QSSHServer
qsshserver = QSSHServer(port=9999)
qsshserver.run_server(process=True)
qsshserver.test_server(port=9999)
INFO:chameleonlogger:['servers', {'status': 'success', 'username': 'test', 'src_ip': '127.0.0.1', 'server': 'ssh_server', 'action': 'login', 'password': 'test', 'src_port': 38696}]
qsshserver.kill_server()
Usage Example - Import as object and test with external ssh command
from honeypots import QSSHServer
qsshserver = QSSHServer(port=9999)
qsshserver.run_server(process=True)
ssh test@127.0.0.1
Honeypot answer
INFO:chameleonlogger:['servers', {'status': 'success', 'username': 'test', 'src_ip': '127.0.0.1', 'server': 'ssh_server', 'action': 'login', 'password': 'test', 'src_port': 38696}]
Close the honeypot
qsshserver.kill_server()
Current Servers/Emulators
- QDNSServer
Server: DNS
Port: 53
Lib: Twisted
Logs: ip, port
- QFTPServer
Server: FTP
Port: 21
Lib: Twisted
Logs: ip, port, username and password
- QHTTPProxyServer
Server: HTTP Proxy
Port: 8080
Lib: Twisted
Logs: ip, port and data
- QHTTPServer
Server: HTTP
Port: 80
Lib: Twisted
Logs: ip, port, username and password
- QHTTPSServer
Server: HTTPS
Port: 443
Lib: Twisted
Logs: ip, port, username and password
- QIMAPServer
Server: IMAP
Port: 143
Lib: Twisted
Logs: ip, port, username and password
- QMysqlServer
Emulator: Mysql
Port: 3306
Lib: Twisted
Logs: ip, port, username and password
- QPOP3Server
Server: POP3
Port: 110
Lib: Twisted
Logs: ip, port, username and password
- QPostgresServer
Emulator: Postgres
Port: 5432
Lib: Twisted
Logs: ip, port, username and password
- QRedisServer
Emulator: Redis
Port: 6379
Lib: Twisted
Logs: ip, port, username and password
- QSMBServer
Server: Redis
Port: 445
Lib: impacket
Logs: ip, port and username
- QSMTPServer
Server: SMTP
Port: 25
Lib: smtpd
Logs: ip, port, username and password
- QSOCKS5Server
Server: SOCK5
Port: 1080
Lib: socketserver
Logs: ip, port, username and password
- QSSHServer
Server: SSH
Port: 22
Lib: paramiko
Logs: ip, port, username and password
- QTelnetServer
Server: Telnet
Port: 23
Lib: Twisted
Logs: ip, port, username and password
- QVNCServer
Emulator: VNC
Port: 5900
Lib: Twisted
Logs: ip, port, username and password
- QMSSQLServer
Emulator: MSSQL
Port: 1433
Lib: Twisted
Logs: ip, port, username and password or hash
- QElasticServer
Emulator: Elastic
Port: 9200
Lib: http.server
Logs: ip, port and data
- QLDAPServer
Emulator: LDAP
Port: 389
Lib: Twisted
Logs: ip, port, username and password
- QNTPServer
Emulator: NTP
Port: 123
Lib: Twisted
Logs: ip, port and data
- QMemcacheServer
Emulator: Memcache
Port: 11211
Lib: Twisted
Logs: ip, port and data
- QOracleServer
Emulator: Oracle
Port: 1521
Lib: Twisted
Logs: ip, port and connet data
- QSNMPServer
Emulator: SNMP
Port: 161
Lib: Twisted
Logs: ip, port and data
acknowledgement
By using this framework, you are accepting the license terms of all these packages: pipenv twisted psutil psycopg2-binary dnspython requests impacket paramiko redis mysql-connector pycryptodome vncdotool service_identity requests[socks] pygments http.server
Let me know if I missed a reference or resource!
Some Articles
Notes
Almost all servers and emulators are stripped-down - You can adjust that as needed
Other projects
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file test-honeypotsBrn-7.15.tar.gz
.
File metadata
- Download URL: test-honeypotsBrn-7.15.tar.gz
- Upload date:
- Size: 51.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.12
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | b18bc8c3b3c95a49918c9761732ae839c11ad3a92b9835d76d2f5d0901b501ef |
|
MD5 | c779992aa6c33fbb2c95ab9591d7d092 |
|
BLAKE2b-256 | 5264f751facbc25a78acf6c49ddd4e8b2a1f7821aa9fc63bf7649e724ae8bb10 |
File details
Details for the file test_honeypotsBrn-7.15-py3-none-any.whl
.
File metadata
- Download URL: test_honeypotsBrn-7.15-py3-none-any.whl
- Upload date:
- Size: 93.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.2 CPython/3.10.12
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 297c7b466760ae93bc1e48fdf6327868c76580a1eac27104ec11eb0f60e5d898 |
|
MD5 | 6caab0001c4ac6751096771e44352af0 |
|
BLAKE2b-256 | f4e1539c7326d5b06bad00d46ddd3de1dabeb683fa483b70cebfa24d2cd9b5da |