Difference between revisions of "OpenStack Key Pairs"

From CAC Documentation wiki
Jump to navigation Jump to search
(Created page with "This is a stub page for temporary content about key pairs in CAC's OpenStack version of Red Cloud. When completed, this page will discuss creating, downloading, updating and...")
 
Line 1: Line 1:
This is a stub page for temporary content about key pairs in CAC's OpenStack version of Red Cloud.  When completed, this page will discuss creating, downloading, updating and using key pairs.
+
 
 +
== About Key Pairs in Red Cloud ==
 +
 
 +
The best way to provide secure and easy access to your Red Cloud instances is through the use of key pairs for [SSH authentication](https://www.ssh.com/ssh/public-key-authentication).  Key pairs are made up of a private key that only you know, and a public key that is distributed to people and systems with which you would like to have secure communications.  Red Cloud allows you to easily generate or upload such key pairs to use with your instances.
 +
 
 +
When you create a new instance, you should specify a key pair to be used for logging in to that instance.  You can only add a key pair to an instance at the time of its creation, not afterwards, so it is important not to overlook this step.  It is possible to generate a new key pair during the process of creating an instance.
 +
 
 +
In Linux instances, the pair's public key is installed into the root account at the time of its creation, allowing you to log in simply by providing the private key.  For Windows instances, you will need to provide the private key to the Red Cloud web interface in order to fetch a valid password for logging in to the instance's administrator account.
 +
 
 +
Key pairs are created per user within an account, so other account members will not be able to use the key pairs you createYou will also not be able to use a given key pair in multiple accounts unless you upload it to each account.
 +
 
 +
== Creating a Key Pair ==
 +
 
 +
Your key pairs can be managed through the Red Cloud web interface by selecting the "Compute" tab and then selecting the "Key Pairs" sub-tab.  This will display a list of your current key pairs as well as buttons for creating, importing or deleting key pairs. (add image)
 +
 
 +
Begin by clicking "Create Key Pair", which raises a simple wizard dialog.  Enter a unique and meaningful name for the key pair and then click "Create Keypair".  The text for your private key is then displayed in the wizard.  It is critical that you copy this text, either by selecting all of the text in the display and using a hot key or context menu item to copy it to the clipboard, or by clicking the "Copy Private Key to Clipboard" button.  This will be your only chance to copy the text, so do not forget to do so.  When you have copied it, click "Done" to close the wizard. (add image of wizard)
 +
 
 +
Saving to file
 +
 
 +
== Importing a Key Pair ==
 +
 
 +
 
 +
== Using Your Key Pair to Connect to a Linux Instance ==
 +
 
 +
== Using Your Key Pair to Connect to a Windows Instance ==

Revision as of 17:15, 7 December 2018

About Key Pairs in Red Cloud

The best way to provide secure and easy access to your Red Cloud instances is through the use of key pairs for [SSH authentication](https://www.ssh.com/ssh/public-key-authentication). Key pairs are made up of a private key that only you know, and a public key that is distributed to people and systems with which you would like to have secure communications. Red Cloud allows you to easily generate or upload such key pairs to use with your instances.

When you create a new instance, you should specify a key pair to be used for logging in to that instance. You can only add a key pair to an instance at the time of its creation, not afterwards, so it is important not to overlook this step. It is possible to generate a new key pair during the process of creating an instance.

In Linux instances, the pair's public key is installed into the root account at the time of its creation, allowing you to log in simply by providing the private key. For Windows instances, you will need to provide the private key to the Red Cloud web interface in order to fetch a valid password for logging in to the instance's administrator account.

Key pairs are created per user within an account, so other account members will not be able to use the key pairs you create. You will also not be able to use a given key pair in multiple accounts unless you upload it to each account.

Creating a Key Pair

Your key pairs can be managed through the Red Cloud web interface by selecting the "Compute" tab and then selecting the "Key Pairs" sub-tab. This will display a list of your current key pairs as well as buttons for creating, importing or deleting key pairs. (add image)

Begin by clicking "Create Key Pair", which raises a simple wizard dialog. Enter a unique and meaningful name for the key pair and then click "Create Keypair". The text for your private key is then displayed in the wizard. It is critical that you copy this text, either by selecting all of the text in the display and using a hot key or context menu item to copy it to the clipboard, or by clicking the "Copy Private Key to Clipboard" button. This will be your only chance to copy the text, so do not forget to do so. When you have copied it, click "Done" to close the wizard. (add image of wizard)

Saving to file

Importing a Key Pair

Using Your Key Pair to Connect to a Linux Instance

Using Your Key Pair to Connect to a Windows Instance