Page tree
Skip to end of metadata
Go to start of metadata

This document is for a previous release of cPanel & WHM. To view our latest documentation, visit our Home page.

For cPanel & WHM 11.46

(WHM >> Security Center >> Manage root's SSH Keys)

Overview

You can create a new SSH key set for use on your server. After you create the new SSH key, you must authorize the key.

How to generate a new SSH key

Warning:

If you use a custom key name, after it is imported you must manually specify the SSH key. The command to manually specify the SSH key is: ssh -i /root/.ssh/key_name.

To generate a new SSH key set, perform the following steps: 

  1. Click Generate a New Key.
  2. If you wish to use a customer key name, enter the key name in the Key Name (defaults to id_dsa): text box.
  3. If you wish to use a password for the SSH key:
    • Enter and confirm the new password in the appropriate text boxes.

      Notes:

      • The system grades the password that you enter on a scale of 100 points. 0 indicates a weak password, while 100 indicates a very secure password.
      • Some web hosts require a minimum password strength. A green password Strength meter indicates that you met the required password strength.
      • Click Password Generator to generate a strong password. For more information, read our Password Generator documentation.
  4. Select your key type.
    • DSA keys provide quicker key generation and signing times.
    • RSA keys provide quicker verification times.
  5. Select your desired key size. 

    While greater key sizes are more secure, they result in larger file sizes and slower authentication times.

  6. Click Generate Key.
  7. WHM will display the saved location of the key.

Authorize a new SSH key

To authorize a new SSH key set for use, perform the following:

  1. Locate your new SSH key in the Public Keys table (Home >> Security Center >> Manage root's SSH Keys).
  2. Click Manage Authorization in the appropriate column.
  3. Click Authorize to allow the server to use the new key.

You must authorize the SSH key for the key to function.

Additional information

To view the new public SSH key, click the View/Download Key link in the Public Keys table.

To use the key, copy the public SSH key to the machine from which you wish to remotely access the web server.