SSH Keys¶

This document describes our acceptable use policy for managing SSH Keys.

What is an ssh key?¶

A key is a set of security credentials that you use to prove your identity when connecting to an instance. Before launching an instance, you must specify a key.Credentials allow you to run a secure shell (SSH) session in your compute instance.

You can choose an existing key or upload a new one.
Depending on how you manage your security, you can specify the same key for all your instances, or you can specify different keys per instance.
To connect to an instance using SSH, follow Connect to an Instance.

View my account keys¶

Sign into the console.
Next, click the Account keys icon in the sidebar menu (shown below).

Account Keys¶

Note

Your keys will be shown. If your account does not have a key, a button will appear to help you upload a new key.

Generate an SSH Key¶

Launch a Terminal on your system to generate an SSH Key. For MacOS* systems, follow the Linux OS instructions.

Click the tab for your operating system (OS).

Launch a Terminal on your local system.
To generate an SSH key, copy and paste the following to your Terminal.
```
ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_rsa
```
If you’re prompted to overwrite, select No.
Click the copy icon. Then paste this command in your Terminal to show the generated SSH key.
```
cat ~/.ssh/id_rsa.pub
```
Continue below.

Launch a new PowerShell window on your local system.
Optional: If you haven't generated a key before, create an .ssh directory.
```
mkdir $env:UserProfile\.ssh
```
Copy and paste the following to your terminal to generate SSH Keys
```
ssh-keygen -t rsa -b 4096 -f $env:UserProfile\.ssh\id_rsa
```
If you are prompted to overwrite, select No.
Click the copy icon. Then paste paste this command to show the generated SSH key.
```
cat $env:UserProfile\.ssh\id_rsa.pub
```
Continue below.

Upload an SSH Key¶

In the Intel® Developer Cloud, click on the Account keys icon.

Account keys icon¶
In Account keys, click Upload key.
Enter a name for your key in Key name.
Paste the contents of your SSH key in Key contents.

Contents of SSH key¶
Select Upload.
Verify that your SSH key appears in the table, as shown.

Account Keys - SSH Key added¶

Delete an SSH Key¶

Go to the Keys menu.
Locate your key in the table.
Click Delete next to your key name.
Click Delete to confirm deletion.

Note

You cannot delete a key that is currently being used in an instance. Close the instance first. Then delete the SSH key.

Update an SSH Key¶

To update an SSH key while the instance is running, follow these steps.

In the console, click the Compute instances.
For your desired instance, find the Actions column and click Edit.
From Public keys shown, select the key that you wish to update.
Save changes.

Note

Next, a dialog appears showing the instructions on how to complete configuration.
Follow the onscreen instructions to update your SSH key.