https://github.com/farridav/keymanager

SSH Key manager, powered by fabric
https://github.com/farridav/keymanager

Last synced: 2 months ago
JSON representation

SSH Key manager, powered by fabric

• Host: GitHub
• URL: https://github.com/farridav/keymanager
• Owner: farridav
• Created: 2014-08-01T21:06:05.000Z (over 10 years ago)
• Default Branch: develop
• Last Pushed: 2014-08-18T15:33:41.000Z (over 10 years ago)
• Last Synced: 2024-03-19T13:10:49.933Z (9 months ago)
• Language: Python
• Size: 371 KB
• Stars: 6
• Watchers: 2
• Forks: 1
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
keymanager

==========

[![Build Status](https://travis-ci.org/farridav/keymanager.svg?branch=develop)](https://travis-ci.org/farridav/keymanager)

SSH Key manager, powered by fabric

When controlling access to various servers for various people, it can become

quite difficult/tedious to manage, for some people its acceptable to pass

around one common keyfile, but this presents the problem that if any user ever

leaves, the keyfile will need replacing, and re-distributing to all users.

A way to get around this problem, and be generally more secure, is to use

individual public keys, if a user needs access to one or more servers, they

give you their public key, and you put it into the `authorized_keys` file on

the user account/server they need access to.

Doing this manually, e.g:

    ssh user@host

    echo "ssh-rsa KEY_HASH user@host" >> ~/.authorized_keys

Can become tedious to manage, so I wrote a manager that allows you to manage

keys on multiple servers very easily, it uses the already amazing [fabric](https://github.com/fabric/fabric)

library.

### Setup (production)

    pip install git+git://github.com/farridav/keymanager.git

\* Will be on pypi soon, see [Issue 2](https://github.com/farridav/keymanager/issues/2)

### Setup (development)

#### Clone the project

    git clone [email protected]:farridav/keymanager.git

    cd keymanager

#### Install requirements

    pip install -r test-requirements.txt

#### Run the tests

    nosetests

### Using it

#### List available commands

    keymanager

#### Get more details/examples for a command (same as fabric)

    keymanager -d 

#### List users

    keymanager list --hosts user@host,otheruser@otherhost

#### Add a new user

##### User prompt

    keymanager add --hosts user@host

##### By path to key

    keymanager add:~/.ssh/id_rsa.pub --hosts user@host

##### By direct key

    keymanager add:ssh-rsa KEY_HASH user@host --hosts user@host

#### Batch Add Users

##### Add a list of users

    keymanager add_batch:~/.ssh/keys_list.txt --hosts user@host

##### Adding a list of users, removing those listed (confirmation required)

    keymanager add_batch:~/.ssh/keys_list.txt,replace=True --hosts user@host

##### Use the `force` argument to avoid user input

    keymanager add_batch:~/.ssh/keys_list.txt,replace=True,force=True --hosts user@host

#### Delete a user

##### User prompt

    keymanager delete --hosts user@host

##### By Username

    keymanager delete:user@host --hosts user@host

#### Batch Delete Users

##### Delete a list of users (confirmation required)

    keymanager delete_batch:~/.ssh/keys_list.txt --hosts user@host

##### Use the `force` argument to avoid user input

    keymanager delete_batch:~/.ssh/keys_list.txt,force=True --hosts user@host