Tinkerwell 4 is out now! See what's new or buy now.
Tinkerwell background image
Tinkerwell Logo Tinkerwell
Go back to Blog

How to set up the 1Password SSH agent for secure SSH connections

Since we abandoned passwords to access web servers, SSH keys have been the primary way to connect to these servers. Simply generate a key pair, add the public key to the authorized_keys file of the server and you can connect. Unfortunately, many applications need to connect to these servers via your key and most people don't use individual keys but a master key for everything. That's fine until one application grabs the key and shares it with someone else who then has access to all your servers.

You can solve this issue by using an ssh-agent that manages the keys and authorizes applications but never shares your keys with the application itself. In this guide, we're using the 1Password SSH Agent of 1Password version 8 to connect to servers via Tinkerwell.

Tinkerwell only works with ED-25519 key if you pair it with 1Password at the moment. RSA key work fine for other connections but the SSH agent requires ED-25519 keys.

Setting up the key

  1. Open 1Password and create a new item
  2. Select SSH key
  3. Import your existing key or create a new one
  4. Save

Screenshot of 1Password SSH Key generation

Add the key to a server

If you are using a new key, add this key to the server by adding the public key to the authorized_keys file.

Enable the 1Password SSH Agent

  1. Open the 1Password preferences and go to `Developer`
  2. Select the options to use the SSH agent and display the key names so that you can identify which keys the application requests.

Screenshot of 1Password Settings

Configure the client (CLI)

Your ssh-agent is set up, but your machine does not know which connections are connections managed with the agent. The easiest way is to switch all connections to the agent, you can do this by adding a wildcard host to your ~/.ssh/config file. If you want to introduce the ssh-agent for some servers only, add their hosts to the config file separately and enable the agent for them.

Host *
IdentityAgent "~/Library/Group Containers/2BUA8C4S2C.com.1password/t/agent.sock"

If you are working on Windows or Linux, you can check the configuration here.

Using the ssh-agent

Every time you connect to a server via SSH, the ssh-agent will step in and handle the connection without exposing the private key file to the application. So whether you connect to a server via your terminal, Table Plus or Tinkerwell, you have to authorize the connection via your 1Password password or fingerprint. This adds another level of security to your connection and allows you to create keys for new connections easily.

Example: Configure a connection in Tinkerwell

Create a new SSH connection within Tinkerwell – and select a key file so that Tinkerwell knows that a key is required. The key file can be a randomly generated one because Tinkerwell will use the ssh-agent on connect and you don't have to add the public key for this private key file to the server.

Screenshot of Tinkerwell Connection Settings

Connecting to a server requires your 1Password master authentication and does not share your private key with Tinkerwell anymore.

Eric L. Barnes, Creator of Laravel News
“I use Tinkerwell all the time now. Love that app.”

Eric L. Barnes

Creator of Laravel News

Luke Hebblethwaite, Developer
“Testing code, writing one-off scripts, or just playing with random logic is far easier with Tinkerwell. Its one of the best purchases I've made in my career.”
Luke Hebblethwaite


Tinkerwell: The PHP Scratchpad

The must-have companion to your favorite IDE. Quickly iterate on PHP code within the context of your web application.

Buy now Learn more