Yoke: SSH Connection Manager
Yoke is a PHP based SSH connection manager. Sometimes storing servers hosts, usernames, ports and passwords can be tricky, SSH Key authentication makes it easier for us, but it doesn't solve the problem of remembering all the other information.
Also, sometimes we face ourselves with more than one private key to authenticate with (like multiple accounts on AWS)., (*1)
Yoke aims to be a single repository for server managements to allow you to fastly connect to your servers just by remembering it's alias, like., (*2)
yoke connect myserver
With security in mind, all information about your servers is encrypted using AES 256., (*3)
NOTICE The encryption key is also stored into your computer, Yoke encryption only makes it harder for users to identify and decrypt the information. But just like SSH private keys, it does not protect against people getting access to your filesystem., (*4)
Installation
In order to use Yoke, you need PHP 8+ installed, with openssl extension enables (default on most installs), (*5)
The installation process is based on the global composer packages, so you need to have a working composer install with the correct binary path settings. Read this tutorial , (*6)
If you have the requirements, install Yoke by running:, (*7)
composer global require yokessh/yoke
This is all you need to do! Time for usage instructions., (*8)
Usage
Using Yoke is really simple and straightforward., (*9)
Adding a Server Connection
In order to store a new connection, just run the command, (*10)
yoke add [alias]
You will then be presented with a few questions:, (*11)
Registering a new Server Configuration!
Server connection alias (server1): sample-server
👤 Server username (none): sample-user
🖥️ Server hostname or IP Address (192.168.0.1): server.sampleapp.com
🚪 Server Port (22): 6262
🔐 Authentication Method:[system|key|password] (system): key
🔑 Private Key (~/.ssh/id_rsa):
Server registered successfully! 🥳
Connecting
As we have this connection in place, we can establish a connection, anytime we want just by running a simple command:, (*12)
yoke connect sample-server
In case it's a server with a password, you can optionally ask to show the password when connecting:, (*13)
yoke connect sample-server --password
Easy right?, (*14)
Listing connections
Forgot a server alias? Don't worry, you can just run:, (*15)
yoke servers
To see a list of stored connections, like this one, (*16)
+---------------+----------------------+-------------+------+--------------+
| Name | Host | Username | Port | Auth. Method |
+---------------+----------------------+-------------+------+--------------+
| server-a | a.sampleapp.comm | admin | 22 | key |
| server-b | b.sampleapp.com | root | 2222 | system |
| server-c | c.sampleapp.com | root | 22 | password |
+---------------+----------------------+-------------+------+--------------+
Removing a connection
Don't need a stored connection anymore?, (*17)
Just run, (*18)
yoke delete alias
Confirm the deletion and it's done!., (*19)
Final Notes:
There are 3 different allows authentication types:, (*20)
-
key - uses a specified private key to establish the connection
-
system - Do not specify a private key to connect, it lets ssh try to connection with current user's key
-
password - SSH does not allow passing plain password as a parameter, Yoke will just show the password on screen, so you can copy and paste it. Password authentication is highly unrecommended.
Wallogit.com
