Metadata-Version: 2.1
Name: ssh-tarpit
Version: 0.4.1
Summary: SSH tarpit that slowly sends an endless banner
Home-page: https://github.com/Snawoot/ssh-tarpit
Author: Vladislav Yarmak
Author-email: vladislav-ex-src@vm-0.com
License: MIT
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Environment :: No Input/Output (Daemon)
Classifier: Intended Audience :: System Administrators
Classifier: Natural Language :: English
Classifier: Topic :: Internet
Classifier: Topic :: Utilities
Classifier: Topic :: Security
Requires-Python: >=3.5.3
Description-Content-Type: text/markdown
License-File: LICENSE

ssh-tarpit
==========

SSH tarpit that slowly sends an endless banner. [Original idea by Chris Wellons](https://nullprogram.com/blog/2019/03/22/). This is Python 3 implementation focused on safety and correctness.

## Requirements

* Python 3.5.3+

## Installation


### From PyPI

Standard Python package installation. This package is available on PyPI:

```
pip3 install ssh-tarpit
```

### From source

Run within source directory:

```
pip3 install .
```

### Docker

Run:

```
docker run -d \
    --security-opt no-new-privileges \
    -p 22:2222 \
    --restart unless-stopped \
    --name ssh-tarpit \
    yarmak/ssh-tarpit
```

## Usage

Synopsis:

```
$ ssh-tarpit --help
usage: ssh-tarpit [-h] [--disable-uvloop] [-v {debug,info,warn,error,fatal}]
                  [-i INTERVAL] [-f [LOGFILE [LOGFILE ...]]] [-a BIND_ADDRESS]
                  [-p BIND_PORT] [-D]

SSH tarpit that slowly sends an endless banner

optional arguments:
  -h, --help            show this help message and exit
  --disable-uvloop      do not use uvloop even if it is available (default:
                        False)
  -v {debug,info,warn,error,fatal}, --verbosity {debug,info,warn,error,fatal}
                        logging verbosity (default: info)
  -i INTERVAL, --interval INTERVAL
                        interval between writes in seconds (default: 2.0)
  -f [LOGFILE [LOGFILE ...]], --logfile [LOGFILE [LOGFILE ...]]
                        file(s) to log to. Empty string argument represents
                        stderr. Flag without arguments disables logging
                        completely. Default is stderr only. (default: [''])

listen options:
  -a BIND_ADDRESS, --bind-address BIND_ADDRESS
                        bind address (default: 127.0.0.1)
  -p BIND_PORT, --bind-port BIND_PORT
                        bind port (default: 2222)
  -D, --dualstack       force dualstack socket mode. Sets socket IPV6_V6ONLY
                        option to 0 (default: False)

```


