ssh-mitm - intercept ssh traffic

ssh-mitm is an intercepting (mitm) proxy server for security audits.

Redirect/mirror Shell to another ssh client supported in 0.2.8
Replace File in SCP supported in 0.2.6
Replace File in SFTP supported in 0.2.3
Transparent proxy support in 0.2.2! - intercepting traffic to other hosts is now possible when using arp spoofing or proxy is used as gateway.
Since release 0.2.0, SSH Proxy Server has full support for tty (shell), scp and sftp!

:warning: do not use this library in production environments! This tool is only for security audits!

Installation

pip install ssh-mitm

Start Proxy Server

Password authentication

Start the server:

ssh-mitm --remote-host 127.0.0.1

Connect to server:

ssh -p 10022 user@proxyserver

Public key authentication

When public key authentication is used, the agent is forwarded to the remote server.

Start the server:

ssh-mitm --forward-agent --remote-host 127.0.0.1

Connect to server:

ssh -A -p 10022 user@proxyserver

SSH MITM Attacks

SSH uses trust on first use. This means, that you have to accept the fingerprint if it is not known.

$ ssh -p 10022 hugo@localhost
The authenticity of host '[localhost]:10022 ([127.0.0.1]:10022)' can't be established.
RSA key fingerprint is SHA256:GIAALZgy8Z86Sezld13ZM74HGbE9HbWjG6T9nzja/D8.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '[localhost]:10022' (RSA) to the list of known hosts.

If a server fingerprint is known, ssh warns the user, that the host identification has changed.

$ ssh -p 10022 remoteuser@localhost
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
Someone could be eavesdropping on you right now (man-in-the-middle attack)!
It is also possible that a host key has just been changed.
The fingerprint for the RSA key sent by the remote host is
SHA256:GIAALZgy8Z86Sezld13ZM74HGbE9HbWjG6T9nzja/D8.
Please contact your system administrator.
Add correct host key in /home/user/.ssh/known_hosts to get rid of this message.
Offending RSA key in /home/user/.ssh/known_hosts:22
  remove with:
  ssh-keygen -f "/home/user/.ssh/known_hosts" -R "[localhost]:10022"
RSA host key for [localhost]:10022 has changed and you have requested strict checking.
Host key verification failed.

If the victim accepts the (new) fingerprint, then the session can be intercepted.

Use-Case: Honey Pot

When ssh proxy server is used as a honey pot, attackers will accept the fingerprint, because he wants to attack this machine. An attacker also does not know if the fingerprint is correct and if the key has changed, perhaps it the server was reinstalled and a new keypair was generated.

User-Case: Security Audit

Intercepting ssh during security audits is useful to understand, how an application works.

For example, if you have an application, which connects to you local router via ssh, to configure the device, you can intercept those connections, if the application does not know the fingerprint and accept it on first use.

If the application knows the fingerprint, then the same host key is used on every device. In this case, you have a good chance to extract the host key from a firmware updated and use it to trick the application.

Available modules

The proxy can be configured and extended using command line arguments.

Some arguments accept Python-class names as string.

Loading a class from a package:

ssh-mitm --ssh-interface ssh_proxy_server.forwarders.ssh.SSHForwarder

:warning: creating a pip package for custom classes is recommended, because loading from files has some bugs at the moment

Loading a class from a file (experimental):

ssh-mitm --ssh-interface /path/to/my/file.py:ExtendedSSHForwarder

SSH interface

cmd argument: --ssh-interface
base class: ssh_proxy_server.forwarders.ssh.SSHBaseForwarder
default: ssh_proxy_server.forwarders.ssh.SSHForwarder

Available forwarders:

ssh_proxy_server.forwarders.ssh.SSHForwarder - forwards traffic from client to remote server
ssh_proxy_server.plugins.ssh.sessionlogger.SSHLogForwarder - write the session to a file, which can be replayed with script
ssh_proxy_server.plugins.ssh.noshell.NoShellForwarder - keeps the session open, when used as master channel, but tty should not be possible to the remote server
ssh_proxy_server.plugins.ssh.mirrorshell.SSHMirrorForwarder - Mirror ssh session to another ssh client

SCP interface

cmd argument: --scp-interface
base class: ssh_proxy_server.forwarders.scp.SCPBaseForwarder
default: ssh_proxy_server.forwarders.scp.SCPForwarder

Available forwarders:

ssh_proxy_server.forwarders.scp.SCPForwarder - transfer file between client and server
ssh_proxy_server.plugins.scp.store_file.SCPStorageForwarder - save file to file system
ssh_proxy_server.plugins.scp.replace_file.SCPReplaceFile - replace transfered file with another file

SFTP Handler

cmd argument: --sftp-handler
base class: ssh_proxy_server.forwarders.sftp.SFTPHandlerBasePlugin
default: ssh_proxy_server.forwarders.sftp.SFTPHandlerPlugin

Available forwarders:

ssh_proxy_server.forwarders.sftp.SFTPHandlerPlugin - transfer file between client and server
ssh_proxy_server.plugins.sftp.store_file.SFTPHandlerStoragePlugin - save file to file system
ssh_proxy_server.plugins.sftp_replace.SFTPProxyReplaceHandler - replace transfered file with another file

Authentication:

cmd argument: --authenticator
base class: ssh_proxy_server.authentication.Authenticator
default: ssh_proxy_server.authentication.AuthenticatorPassThrough

Available Authenticators:

ssh_proxy_server.authentication.AuthenticatorPassThrough - default authenticator, which can reuse credentials

Currently, only one authenticator (AuthenticatorPassThrough) exists, but it supports arguments to specify remote host, username and password, which shlould fit most scenarios. (public keys are on the roadmap)

Authors

Manfred Kaiser
Simon Böhm

Release files for ssh-mitm 0.3.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ssh-mitm 0.3.1
File	Size	Uploaded
ssh-mitm-0.3.1.tar.gz	18.7 kB	Dec 13, 2020	Details

Built distribution (wheel)

Table of built distributions (wheels) for ssh-mitm 0.3.1
File	Interpreter	ABI	Platform	Reset
ssh_mitm-0.3.1-py3-none-any.whl 29.7 kB Dec 13, 2020	Python 3	none	any	Details

Total release size: 48.3 kB

Release files / ssh-mitm-0.3.1.tar.gz

Download URL	ssh-mitm-0.3.1.tar.gz
Size	18.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`70de38edc6dd6055351d4c96b98829f8a3bea2cf6dc8aa53b5f4d2a68eb346ee`
BLAKE2b-256 checksum How to use checksums	`6680b23c601100ac982aaa1f22a1959c16c95c9f0490d5f5b1685a2fed75bbf4`
Upload date	Dec 13, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.54.1 CPython/3.9.0`

Release files / ssh_mitm-0.3.1-py3-none-any.whl

Download URL	ssh_mitm-0.3.1-py3-none-any.whl
Size	29.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`724b06481631902894dd79b7bdfc7fd7d5aea501577c27ee0904642e72660114`
BLAKE2b-256 checksum How to use checksums	`3f8a23603b413588b1a0294b8e4182734c434ee420b7fa4b40d9c67eead463dc`
Upload date	Dec 13, 2020
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/3.2.0 pkginfo/1.6.1 requests/2.25.0 setuptools/49.2.1 requests-toolbelt/0.9.1 tqdm/4.54.1 CPython/3.9.0`