Criar chaves SSH para acesso SSH/SFTP e importar no cPanel

  1. Portal Home
  2. Knowledgebase
  3. Criar chaves SSH para acesso SSH/SFTP e importar no cPanel
  •   20/05/2026 16:31
  •  
ℹ️ Informação

Este guia tem como objetivo fornecer os passos necessários para gerar uma chave SSH em Windows, macOS ou Linux, e importar a chave pública no cPanel para utilização em acessos SSH/SFTP.

Pode criar uma das seguintes chaves:

  • ED25519 — opção recomendada para a maioria dos casos.
  • RSA 4096 — opção recomendada quando for necessário usar RSA.
  • RSA 3072 — opção alternativa quando existir esse requisito específico.
⚠️ Aviso importante

Por segurança, não é recomendado gerar as chaves diretamente no cPanel nem importar a chave privada para o servidor. A chave privada é um ficheiro confidencial e deve ficar apenas no computador da pessoa que vai utilizar o acesso SSH/SFTP. No cPanel deve ser importada apenas a chave pública, ou seja, o ficheiro terminado em .pub.

Escolha abaixo o sistema operativo que utiliza:

🪟 Criar chave SSH no Windows
  1. Abrir o menu Iniciar.
  2. Procurar por PowerShell ou Windows Terminal.
  3. Abrir a aplicação.
  4. Executar apenas um dos comandos abaixo, de acordo com o tipo de chave pretendida.

ED25519 (recomendado)

ssh-keygen -t ed25519

RSA 4096

ssh-keygen -t rsa -b 4096

RSA 3072

ssh-keygen -t rsa -b 3072

Por defeito, a chave será guardada na pasta .ssh do utilizador Windows.

C:\Users\NOME_DO_UTILIZADOR\.ssh\
⚠️ Atenção ao nome da chave

Se já existir uma chave com o nome padrão, o sistema pode perguntar se pretende substituir o ficheiro. Nesse caso, não deve avançar sem confirmar. No passo abaixo pode indicar outro nome para a nova chave.

Exemplo do passo onde pode aceitar o nome sugerido ou escrever outro nome:

Enter file in which to save the key (C:\Users\USERNAME/.ssh/id_ed25519):

Se quiser usar outro nome, pode indicar, por exemplo:

C:\Users\USERNAME\.ssh\id_ed25519_cpanel
🔑 Passphrase recomendada

Quando for pedida a passphrase, recomendamos que escreva uma palavra-passe segura. A passphrase adiciona uma proteção extra caso a chave privada seja comprometida. Ao escrever, é normal não aparecerem caracteres no ecrã.

Enter passphrase (empty for no passphrase):
Enter same passphrase again:

Depois de criada a chave, serão gerados dois ficheiros:

  • Chave privada: ficheiro sem .pub. Deve ficar apenas no seu computador.
  • Chave pública: ficheiro com .pub. Esta é a chave que deve ser importada no cPanel.

Para ver/copiar a chave pública, execute o comando correspondente ao tipo de chave criada:

Get-Content $env:USERPROFILE\.ssh\id_ed25519.pub
Get-Content $env:USERPROFILE\.ssh\id_rsa.pub

Se tiver escolhido outro nome para a chave, ajuste o nome do ficheiro no comando.

Depois de criada a chave, avance para a secção “Importar a chave pública no cPanel”.

🍎 Criar chave SSH no macOS
  1. Abrir a aplicação Terminal.
  2. Executar apenas um dos comandos abaixo, de acordo com o tipo de chave pretendida.

ED25519 (recomendado)

ssh-keygen -t ed25519

RSA 4096

ssh-keygen -t rsa -b 4096

RSA 3072

ssh-keygen -t rsa -b 3072

Por defeito, a chave será guardada na pasta .ssh do seu utilizador.

/Users/NOME_DO_UTILIZADOR/.ssh/
⚠️ Atenção ao nome da chave

Se já existir uma chave com o nome padrão, o sistema pode perguntar se pretende substituir o ficheiro. Nesse caso, não deve avançar sem confirmar. No passo abaixo pode indicar outro nome para a nova chave.

Exemplo do passo onde pode aceitar o nome sugerido ou escrever outro nome:

Enter file in which to save the key (/Users/USERNAME/.ssh/id_ed25519):

Se quiser usar outro nome, pode indicar, por exemplo:

/Users/USERNAME/.ssh/id_ed25519_cpanel
🔑 Passphrase recomendada

Quando for pedida a passphrase, recomendamos que escreva uma palavra-passe segura. A passphrase adiciona uma proteção extra caso a chave privada seja comprometida. Ao escrever, é normal não aparecerem caracteres no ecrã.

Enter passphrase (empty for no passphrase):
Enter same passphrase again:

Depois de criada a chave, serão gerados dois ficheiros:

  • Chave privada: ficheiro sem .pub. Deve ficar apenas no seu computador.
  • Chave pública: ficheiro com .pub. Esta é a chave que deve ser importada no cPanel.

Para ver/copiar a chave pública, execute o comando correspondente ao tipo de chave criada:

cat ~/.ssh/id_ed25519.pub
cat ~/.ssh/id_rsa.pub

Se tiver escolhido outro nome para a chave, ajuste o nome do ficheiro no comando.

Depois de criada a chave, avance para a secção “Importar a chave pública no cPanel”.

🐧 Criar chave SSH no Linux
  1. Abrir a aplicação Terminal.
  2. Executar apenas um dos comandos abaixo, de acordo com o tipo de chave pretendida.

ED25519 (recomendado)

ssh-keygen -t ed25519

RSA 4096

ssh-keygen -t rsa -b 4096

RSA 3072

ssh-keygen -t rsa -b 3072

Por defeito, a chave será guardada na pasta .ssh do seu utilizador.

/home/NOME_DO_UTILIZADOR/.ssh/
⚠️ Atenção ao nome da chave

Se já existir uma chave com o nome padrão, o sistema pode perguntar se pretende substituir o ficheiro. Nesse caso, não deve avançar sem confirmar. No passo abaixo pode indicar outro nome para a nova chave.

Exemplo do passo onde pode aceitar o nome sugerido ou escrever outro nome:

Enter file in which to save the key (/home/USERNAME/.ssh/id_ed25519):

Se quiser usar outro nome, pode indicar, por exemplo:

/home/USERNAME/.ssh/id_ed25519_cpanel
🔑 Passphrase recomendada

Quando for pedida a passphrase, recomendamos que escreva uma palavra-passe segura. A passphrase adiciona uma proteção extra caso a chave privada seja comprometida. Ao escrever, é normal não aparecerem caracteres no ecrã.

Enter passphrase (empty for no passphrase):
Enter same passphrase again:

Depois de criada a chave, serão gerados dois ficheiros:

  • Chave privada: ficheiro sem .pub. Deve ficar apenas no seu computador.
  • Chave pública: ficheiro com .pub. Esta é a chave que deve ser importada no cPanel.

Para ver/copiar a chave pública, execute o comando correspondente ao tipo de chave criada:

cat ~/.ssh/id_ed25519.pub
cat ~/.ssh/id_rsa.pub

Se tiver escolhido outro nome para a chave, ajuste o nome do ficheiro no comando.

Depois de criada a chave, avance para a secção “Importar a chave pública no cPanel”.

📥 Importar a chave pública no cPanel

⚠️ Atenção

No cPanel deve ser importada apenas a chave pública, ou seja, o conteúdo do ficheiro terminado em .pub. Não cole nem envie a chave privada.

  1. Aceder ao cPanel e clicar em SSH Access.

    Menu SSH Access no cPanel

  2. Clicar em Manage SSH Keys.

    Botão Manage SSH Keys no cPanel

  3. Clicar em Import Key.

    Botão Import Key no cPanel

  4. Preencher apenas os seguintes campos:

    • Choose a name for this key: colocar um nome familiar, por exemplo PC-casa.
    • Paste the public key into the following text box: colar o conteúdo completo da chave pública, ou seja, o ficheiro terminado em .pub.

    Depois clicar em Import.

    Formulário de importação de chave SSH no cPanel

  5. Depois de importar, voltar ao menu SSH Access. Na secção Public Keys, clicar em Manage na chave acabada de importar.

    Gerir chave pública importada no cPanel

  6. Clicar em Authorize para autorizar a chave para acesso SSH/SFTP.

    Autorizar chave SSH no cPanel

ℹ️ Informação

A chave só fica apta para utilização em SSH/SFTP depois de estar autorizada no cPanel.

✅ Testar a ligação SSH/SFTP

Depois de a chave estar importada e autorizada, pode testar a ligação SSH com o seguinte comando:

ssh utilizador@servidor

Para testar uma ligação SFTP, pode usar:

sftp utilizador@servidor

Substituir:

  • utilizador pelo utilizador cPanel.
  • servidor pelo hostname ou IP do servidor.
ℹ️ Nota

Se tiver guardado a chave com outro nome ou noutra localização, poderá ser necessário indicar manualmente o ficheiro da chave com a opção -i.

🛠️ Erros comuns

⚠️ “Permission denied (publickey)”

Possíveis causas:

  • A chave pública foi importada, mas não foi autorizada no cPanel.
  • Está a ser usada a chave privada errada.
  • O utilizador SSH/SFTP está incorreto.
  • A porta SSH está incorreta.
  • O acesso SSH/SFTP não está ativo para a conta.
⚠️ A passphrase foi esquecida

Não é possível recuperar a passphrase. Deverá criar uma nova chave SSH e importar novamente a chave pública no cPanel.

  Imprimir

Comments

Please login to comment