Generating an SSH key automatically
In macOS and Linux environments, the Triton Service portal can quickly generate SSH key pairs. If you are working in a Windows environment, visit Manually generating an SSH key in Windows.
Joyent recommends RSA keys because the node-manta CLI programs work with RSA keys both locally and with the ssh agent. DSA keys will work only if the private key is on the same system as the CLI, and not password-protected.
- Navigate to the Triton Portal and open the Account Summary.
- From the SSH section, select Create SSH Key.
- In the Create SSH Key dialog, enter a Key Name and then select Create Key. The private and public SSH key pairs generate. When complete, Triton confirms that SSH keys have been successfully added to your account.
- In response to the confirmation message, click Ok. Triton generates a public and private key pair and downloads them to your local computer.
- Move the keys into the appropriate directory for your operating system. To move the keys in a macOS, run the following commands in a terminal:
$ mkdir ~/.ssh $ mv ~/Downloads/<ssh key name>_id_rsa ~/.ssh/. $ chmod 400 ~/.ssh/<ssh key name>_id_rsa $ mv ~/Downloads/<ssh key name>_id_rsa.pub ~/.ssh/.
If you have an existing SSH key pair, you can upload the public SSH key to your Triton account.
- From the Triton Service portal, select Account to open the Account Summary page.
- From the SSH section, select Import Public Key.
- Enter a Key Name. Although naming a key is optional, labels are a best practice for managing multiple SSH keys.
- Copy and paste the public SSH key and upload the file.
When Triton finishes the adding or uploading process, the public SSH key appears in the list of SSH keys.
ssh-agent is a program that stores encrypted SSH key passwords. Adding SSH keys to an agent is optional. Triton authenticates using the key fingerprint so you don't need to add SSH keys to the agent if you did not assign passwords to your keys.
If your keys are passphrase-protected, Triton requires that you add them to
If you decide to add your SSH keys to the ssh agent, use the default
ssh-add command. Don’t use an external application installed by
homebrew, or another external source.
- In a terminal, start the
$ eval "$(ssh-agent -s)" Agent pid 49186
If you are running a macOS Sierra 10.12.2 or later, you must modify the
~/.ssh/config file to automatically load keys into the
ssh-agent and store passphrases in your keychain. Read Apple's technotes for more information.
If you are running Windows or an earlier version of macOS, skip this step.
- To modify the
Host * AddKeysToAgent yes UseKeychain yes IdentityFile ~ /.ssh/id_rsa
- Add the SSH private key to the
ssh-agentand store your passphrase in the keychain.
$ ssh-add -K ~/.ssh/<key-name>
- To automatically log out at the end of your session, add the following command in the
.logoutfile or your
.bash_logoutfile, whichever is appropiate for your operating system.
$ kill $SSH_AGENT_PID
For Windows environments and developers who take a hands-on approach, learn more about generating an SSH key pair from the command line: