Metadata-Version: 2.1
Name: ssh-mitm-plugins
Version: 0.4
Summary: advanced features for ssh-mitm server
Home-page: https://github.com/ssh-mitm/ssh-mitm-plugins
Author: Simon Böhm
Author-email: support@ssh-mitm.at
License: UNKNOWN
Project-URL: Documentation, https://ssh-mitm-plugins.readthedocs.io
Project-URL: Source, https://github.com/ssh-mitm/ssh-mitm-plugins
Project-URL: Tracker, https://github.com/ssh-mitm/ssh-mitm-plugins/issues
Keywords: ssh proxy mitm network security audit plugins features advanced
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: License :: OSI Approved :: GNU Lesser General Public License v3 (LGPLv3)
Classifier: Topic :: System :: Networking
Classifier: Development Status :: 4 - Beta
Requires-Python: >= 3.6
Description-Content-Type: text/markdown
License-File: LICENSE

# SSH-MITM Plugins

![SSH-MITM example](https://ssh-mitm.at/img/mitm-example.png)

With version 0.4.0 the [ssh-mitm projects](http://ssh-mitm.at/) locks the features
shipping with the core functionality of the program. It is now preferred that any additions to the
feature-set is made through the modular capabilities that the ssh-mitm project is built upon. Using
entrypoints in combination with modules anyone can make their own ssh-mitm plugins.

This projects adds some advanced features to the ssh-mitm server that furthers its capabilities
to realise security audits.

## Installation

Installing the ssh-mitm server including these plugins is very simple:

    $ pip install ssh-mitm-plugins
    
Alternatively, ssh-mitm-plugins is featured as an optional dependency in the ssh-mitm package.
Installation can occur through:
    
    $ pip install ssh-mitm[plugins]
    
The current version of the ssh-mitm server will be installed and additional advanced features
will be available through these plugins. The ssh-mitm server will operate normally as described
by the [ssh-mitm project](#ssh-mitm).

## Plugins

Following advanced features will be made available through the modular runtime compilation of 
the ssh-mitm server.

#### SSH
* injectorshell - a way to hijack a ssh session and execute commands on an separated shell
* stealthshell - improving on the *injectorshell*, this ssh interface will
make hijacking of a ssh session undetectable
* scriptedshell - perfect for security audits and information gathering, this ssh interface executes
a script on the remote machine and stores the output on the ssh-mitm server

For a more detailed look at the plugins usage and operation refer to the 
[documentation](http://ssh-mitm-plugins.readthedocs.io).

## SSH-MITM

**For more information about the core functionality of the ssh-mitm server visit:**

* Github        - https://github.com/ssh-mitm/ssh-mitm
* Website       - http://ssh-mitm.at
* Documentation - http://docs.ssh-mitm.at


