Manually generating your SSH key in Mac OS X
You generate an SSH key through Mac OS X by using the Terminal application. Once you upload a valid public SSH key, the Triton Compute Service uses SmartLogin to copy the public key to any new SmartMachine you provision.
The terminal provides you with a text-based command line interface to the Unix shell of Mac OS X.
To open the Mac OS X Terminal, follow these steps:
- In Finder, choose Utilities from the Go menu.
- Find the Terminal application in the Utilities window.
- Double-click the Terminal application.
The Terminal window opens with the command line prompt displaying the name of your machine and your username.
An SSH key consists of a pair of files. One is the private key, which you should never give to anyone. The other is the public key. You will need a public key to log into VMs and SmartMachines you provision. When you generate your keys, you will use
ssh-keygen to store the keys in a safe location so you can bypass the login prompt when connecting to your SmartMachine.
To generate SSH keys in Mac OS X, follow these steps:
Enter the following command in the Terminal window.
ssh-keygen -t rsa
This starts the key generation process. When you execute this command, the
ssh-keygenutility prompts you to indicate where to store the key.
Press the ENTER key to accept the default location. The
ssh-keygenutility prompts you for a passphrase.
- Type in a passphrase. You can also hit the ENTER key to accept the default (no passphrase). However, this is not recommended.
You will need to enter the passphrase a second time to continue.
After you confirm the passphrase, the system generates the key pair.
Your identification has been saved in /Users/myname/.ssh/id_rsa. Your public key has been saved in /Users/myname/.ssh/id_rsa.pub. The key fingerprint is: ae:89:72:0b:85:da:5a:f4:7c:1f:c2:43:fd:c6:44:38 email@example.com The key's randomart image is: +--[ RSA 2048]----+ | | | . | | E . | | . . o | | o . . S . | | + + o . + | |. + o = o + | | o...o * o | |. oo.o . | +-----------------+
Your private key is saved to the
id_rsa file in the
.ssh directory and is used to verify the public key you use belongs to the same Triton Compute Service account.
|Never share your private key with anyone!|
Your public key is saved to the
id_rsa.pub;file and is the key you upload to your Triton Compute Service account. You can save this key to the clipboard by running this:
pbcopy < ~/.ssh/id_rsa.pub
Now you need to upload the copied SSH key to your Cloud Management portal.
- After you copy the SSH key to the clipboard, return to the Cloud Management portal.
- In the SSH Key field, paste your SSH key.
- In the Name field, provide a name for the key. Providing a key name is optional but is a good practice for ease of management.
- Click the Add this key button. See below.
You may see a password prompt like this:
$ ssh firstname.lastname@example.org email@example.com's password:
This is because:
- You did not enter the correct passphrase.
- The private key on your Macintosh (
id_rsa) does not match the public key stored with your Triton Compute Service account.
- The public key was not entered correctly in your Joyent Cloud account.
The final step is to provision an instance and start using the Triton Compute Service.