pytunneling 0.0.2

Description:

pytunneling 0.0.2

pytunneling
NOTE: This module is still in early development and may not be fully stable. Use at own risk.
Description
Python module that allows multi-hop SSH tunneling/port-forwarding.
While modules like Paramiko and sshtunnel provide excellent SSH and SSH tunnelling functionality (and is what is used under the hood for this module), neither directly support multi-hop SSH tunneling commonly required in heavily firewalled environments or complex network structure that may not have direct connectivity.
The logic to this module progressively creates tunnels (that use the previous tunnel if applicable) based on your input until the final tunnel is created which is what is reported as the localport for you to use as you please. This may look something like; desktop 22<>22 bastion1 22<>22 bastion2 22<>5432 database server. Refer to usage below.
Install
Pip
pip install pytunneling

Requirements

Python 3.6 or greater

Usage
Import as Python module
Note: tunnel_info argument expects a list of dictionary objects containing keyword arguments noted in the sshtunnel docs corresponding to the bastion "hops", with the actual destination IP and port being target_ip and target_port.
from pytunneling import TunnelNetwork
from time import sleep
tunnel_info = [
{"ssh_address_or_host": "bastion1",
"ssh_username": "sshuser",
"ssh_pkey": "~/.ssh/id_rsa", # Note this refers to a local file on the machine that runs logic
#"ssh_private_key_password ": "somekeypassword", # If applicable
},
{"ssh_address_or_host": "bastion2",
"ssh_username": "sshuser",
"ssh_password": "somesecurepassword",
}
]
with TunnelNetwork(tunnel_info=tunnel_info, target_ip="database", target_port=5432) as tn:
print(f"Tunnel available at localhost:{tn.local_bind_port}")
while True:
# Use this tunnel
sleep(5)

CLI
CLI Usage
Note: The CLI is not yet implemented
# TODO

CLI Examples
# TODO

Known Issues

Currently this module will time out when an SSH thumbprint prompt appears (seen for first time SSH usage), be sure to validate SSH connection/credentials works. To investigate whether there is an option to accept or avoid this.

Contributing
Feel free to raise any feature requests/problems/improvements as issue or pull request via GitHub.