Skip to main content

Create and place an SSH key on a cloud server

SSH keys can be used to securely connect to a server over an encrypted SSH protocol. This is a key pair: the private key is stored on the local computer, and the public key is placed on the server.

For authorization on a cloud server, we recommend using SSH keys instead of a login and password.

You can use ed25519, rsa, ecdsa, and dsa SSH keys. Learn more about SSH keys for users.

  1. Create an SSH key pair.

  2. Optional: add the public SSH key to the user profile.

  3. Place the public SSH key on a cloud server.

1. Create an SSH key pair

You can create SSH keys in two ways:

Create an SSH key pair via the OS

  1. Open the CLI.

  2. Generate an SSH key pair:

    ssh-keygen -t <key_type>

    Specify <key_type> — the SSH key type: ed25519, rsa, ecdsa, or dsa

  3. A message will appear asking you to choose a directory to store the key pair—example for an RSA key:

    Enter file in which to save the key (~/.ssh/id_rsa):

    To leave the default key storage directory, press Enter. If you want to choose a different directory, enter it in the format /path/to/id_rsa and press Enter.

  4. Optional: enter a passphrase for additional security, repeat it, and press Enter:

    Enter passphrase (empty for no passphrase):
    Enter same passphrase again:
  5. Wait for a message that the keys have been generated. Two files will be created: id_rsa (private key) and id_rsa.pub (public key). The key fingerprint and its image will appear in the terminal:

    Your identification has been saved in ~/.ssh/id_rsa
    Your public key has been saved in ~/.ssh/id_rsa.pub
    The key fingerprint is:
    The key's randomart image is:
  6. Display the public SSH key:

    cat <path>

    Specify <path> — the full path to the public key you specified in step 3, for example, ~/.ssh/id_rsa.pub.

Create an SSH key pair via OpenStack CLI

The SSH key will only be available for the single service user, project, and pool for which you configured authorization in the OpenStack API.

When generating SSH keys via OpenStack CLI, the public key is automatically added to the user profile.

  1. Open the OpenStack CLI.

  2. Generate an SSH key pair:

    openstack keypair create <key_name> --private-key <file_for_key>

    Specify:

    • <key_name> — key name;
    • <file_for_key> — the file where the private SSH key will be saved on the local computer.

2. Optional: add a public SSH key to the user profile

A public SSH key can be added to your profile or another user's profile. You can then place the key on the server during creation or on an existing server.

The key will be available in all projects the user is added to.

If you generated the SSH key pair via OpenStack CLI, the public key was automatically added to your profile.

  1. In the control panel, open the menu (account number) in the upper-right corner and select Profile.

  2. Go to the Access section.

  3. Open the SSH keys tab.

  4. Click Add key.

  5. Enter the key name.

  6. Paste the public SSH key in OpenSSH format.

  7. Click Add.

3. Place a public SSH key on a cloud server

You can place a public SSH key when creating a cloud server or on an existing server.

To access a cloud server via SSH, you need to add a public SSH key to the ~/.ssh/authorized_keys file on the server. You can add multiple keys, for example, if you need to grant access to several users.

Public SSH keys can be placed on an existing server using a utility or manually.

The utility adds the public SSH key to the end of the ~/.ssh/authorized_keys file. The command used creates the directory and file if they do not already exist.

  1. Open the CLI on your local computer.

  2. Copy the public SSH key to the cloud server:

    ssh-copy-id -i <path> <username>@<ip_address>

    Specify:

    • <path> — the full path to the public key on your local computer, for example ~/.ssh/id_rsa.pub;
    • <username> — the username;
    • <ip_address> — the public IP address of the server.
  3. Enter the user password.

SSH keys for the user

How to add a key to the user profile
  • For yourself: in the control panel, in the upper-right corner, open the menu (account number) → Profile → Access section → SSH Keys tab;
  • for another user: in the control panel, click IAM in the top menu → Panel Users or Service Users section → user page;
  • it will be added automatically when creating SSH keys via OpenStack CLI (the openstack keypair create command);
  • via API;
  • via Terraform;
  • via selvpc CLI
How to add it to a cloud server when creating the server
  • Via OpenStack CLI (the openstack server create command);
  • via API;
  • via Terraform
Available forFor a single user of any type
Available in projectsIn all projects to which the user has been added
Available in pools
  • Available in all pools if added in the control panel under Account → Users → tab with the required user type → user page;
  • available only in the pools to which it was added via OpenStack CLI, API, Terraform, or selvpc CLI
Where to view the list of keys
  • Yours: in the control panel, open the menu in the top-right corner (account number) → Profile → section Access → tab SSH Keys;
  • other users: in the control panel, click IAM in the top menu → section Panel Users ** or ** Service Users → user page;
  • via OpenStack CLI (command openstack keypair list);
  • via API;
  • via Terraform;
  • via selvpc CLI