Skip to main content

Minimalist Session Manager for SSH/SFTP

Project description

Welcome to

Minimalist Session Manager for SSH/SFTP
***************************************

Design
======

* store session information in .msh files, including various ssh cmdline options
* use a password keeping service to store encrypted passwords in ~/.missh

Platforms
=========

MiSSH is written in Python 2.7. It should work well on most POSIX platforms.
I have tested it on Mac OSX, Linux and Cygwin.

Install
=======

please use easy_install_ to install missh::

sudo easy_install missh

Upgrade::

sudo easy_install -U missh

.. _easy_install: https://pypi.python.org/pypi/setuptools

Command line
============

missh [opt] [file_path]
-o open the session file
-n create a new session file
-m change the master password
-t timeout change the timeout of caching the master password, in minutes
-k kill the background password keeping service
-r reconnect automatically after disconnection
-f use sftp to connect the host
-h show the help information
-v verbose mode

.. * \-C file use file as the configuration

Notice
======

Please **DO NOT** change the term size **AFTER** login, otherwise the term might get stuck.
If it got stuck, you need to log out and log in again.
This is a problem of the term, not MiSSH :)

Examples
========

* missh host.msh
* missh -o host.msh
* missh -n new_host.msh
* missh -f host.msh
* missh -m
* missh -t 120

.. * missh -C myssh.conf my_host.msh
* ./my_host.msh # when missh is in the correct path
* ./my_host.msh -C myssh.conf

Screen shots
============

Open or create a seesion file::

┌ MiSSH - test.msh ────────────────────────────────────────────────────────────┐
│ │
│ Host: user@host.net:22 │
│ Password: --- │
│ Other options: │
│ │
│ % set dynamic socks proxy │
│ -D 1080 │
│ │
│ % forward a local port to a service at a remote port, e.g. vnc @ host:1 │
│ % -L 5901 │
│ % -L 5901:1.2.3.4:5901 │
│ │
│ % forward a remote port to a service at a local port │
│ % -R 8080 │
│ │
│ % sftp options use # as the line header │
│ # -r │
│ │
│ │
│ Cancel OK │
└──────────────────────────────────────────────────────────────────────────────┘

.. Edit the configuration::

Session file format
================

* host = user\@host:port
* # there might be multiple lines of opt:
* opt = -D 1080
* opt = -L 5901
* opt = -R 8080

Configuration file format
=========================

* timeout = 120
* master = NONCE,mi_hash(master_key)
* host_sha256 = NONCE,key_encrypted_using_master1024_key_under_aes

License
=======

BSD 2-Clause License at https://github.com/LenxWei/MiSSH/blob/master/COPYING

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
missh-0.3.0-py2.7.egg (63.8 kB) Copy SHA256 hash SHA256 Egg 2.7
missh-0.3.0.tar.gz (31.9 kB) Copy SHA256 hash SHA256 Source None

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page