https://github.com/shimizukawa/sshh

sshh is a ssh helper utility
https://github.com/shimizukawa/sshh

agent ssh

Last synced: about 15 hours ago
JSON representation

sshh is a ssh helper utility

• Host: GitHub
• URL: https://github.com/shimizukawa/sshh
• Owner: shimizukawa
• License: apache-2.0
• Created: 2019-05-05T01:57:13.000Z (over 5 years ago)
• Default Branch: master
• Last Pushed: 2023-02-07T22:28:07.000Z (over 1 year ago)
• Last Synced: 2024-08-10T19:21:37.449Z (about 2 months ago)
• Topics: agent, ssh
• Language: Python
• Homepage: https://pypi.org/project/sshh/
• Size: 44.9 KB
• Stars: 1
• Watchers: 2
• Forks: 0
• Open Issues: 5
• Metadata Files:
  • Readme: README.rst
  • Changelog: CHANGELOG.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
====

sshh

====

.. image:: https://img.shields.io/pypi/v/sshh.svg

   :alt: PyPI

   :target: http://pypi.org/p/sshh

.. image:: https://img.shields.io/pypi/pyversions/sshh.svg

   :alt: PyPI - Python Version

.. image:: https://img.shields.io/github/license/shimizukawa/sshh.svg

   :alt: License

   :target: https://github.com/shimizukawa/sshh/blob/master/LICENSE

.. image:: https://img.shields.io/github/stars/shimizukawa/sshh.svg?style=social&label=Stars

   :alt: GitHub stars

   :target: https://github.com/shimizukawa/sshh

``sshh`` is an ssh helper tool for batch registration of ssh private keys in ssh-agent.

The main purpose of sshh is to avoid ``ssh: Too many authentication failures`` that occurs when

the number of keys registered in ssh-agent exceeds a certain number. This error occurs when the

upper limit of key attempts is exceeded when the server is setting the upper limit of private key

attempts strictly.

This problem can be avoided by clearing all the keys registered in ssh-agent and registering

as many as necessary, or entering the passphrase each time. However, in situations where there

are multiple keys and servers, ssh connections can be very cumbersome. sshh uses Python's

subprocess package to start a new ssh-agent, and further calls ssh-add to collectively register

as many private keys as necessary. This relieves you from the hassle.

Usages

=======

Init

-----

::

    (.venv) $ sshh-config init

    Enter password for your registry: xxxxx

    The registry file ~/.sshh.registry is created.

Change password

----------------

::

    (.venv) $ sshh-config chpw

    Enter CURRENT password for your registry: xxxxx

    Enter NEW password for your registry: yyyyy

    Enter NEW password again for verification: yyyyy

    Password has been changed.

Register key

-------------

::

    (.venv) $ sshh-add -g prod ~/id_rsa_server1

    Enter password for your registry: xxxxx

    Enter passphrase for the keyfile: yyyyy

    The keyfile is registered.

List keys

----------

::

    (.venv) $ sshh-add -l

    Enter password for your registry: xxxxx

    [prod]

    /home/user/.ssh/id_rsa_server1

    /home/user/.ssh/id_rsa_server2

    [stg]

    /home/user/.ssh/id_rsa_server7

    /home/user/.ssh/id_rsa_server8

Invoke ssh-agent

-----------------

::

    (venv) $ sshh-agent -g prod

    Enter password for your registry: xxxxx

    Enter password for your registry:

    Registering keys for session "prod"

    ssh-agent PID=67779 session "prod" has been started. To close this session, exit shell.

    [prod] (venv) $

    [prod] (venv) $ exit

    exit

    ssh-agent PID=67779 session "prod" has been closed.

    (venv) $

License

=======

Licensed under the Apache Software Licence.

CHANGES

=======

See: https://github.com/shimizukawa/sshh/blob/master/CHANGELOG.rst