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:
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:
ssh-keygen -t ed25519ssh-keygen -t rsa -b 4096ssh-keygen -t rsa -b 3072Por defeito, a chave será guardada na pasta .ssh do utilizador Windows.
C:\Users\NOME_DO_UTILIZADOR\.ssh\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_cpanelQuando 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:
.pub. Deve ficar apenas no seu computador..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.pubGet-Content $env:USERPROFILE\.ssh\id_rsa.pubSe 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”.
ssh-keygen -t ed25519ssh-keygen -t rsa -b 4096ssh-keygen -t rsa -b 3072Por defeito, a chave será guardada na pasta .ssh do seu utilizador.
/Users/NOME_DO_UTILIZADOR/.ssh/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_cpanelQuando 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:
.pub. Deve ficar apenas no seu computador..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.pubcat ~/.ssh/id_rsa.pubSe 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”.
ssh-keygen -t ed25519ssh-keygen -t rsa -b 4096ssh-keygen -t rsa -b 3072Por defeito, a chave será guardada na pasta .ssh do seu utilizador.
/home/NOME_DO_UTILIZADOR/.ssh/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_cpanelQuando 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:
.pub. Deve ficar apenas no seu computador..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.pubcat ~/.ssh/id_rsa.pubSe 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”.
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.
Aceder ao cPanel e clicar em SSH Access.
Clicar em Manage SSH Keys.
Clicar em Import Key.
Preencher apenas os seguintes campos:
PC-casa..pub.Depois clicar em Import.
Depois de importar, voltar ao menu SSH Access. Na secção Public Keys, clicar em Manage na chave acabada de importar.
Clicar em Authorize para autorizar a chave para acesso SSH/SFTP.
A chave só fica apta para utilização em SSH/SFTP depois de estar autorizada no cPanel.
Depois de a chave estar importada e autorizada, pode testar a ligação SSH com o seguinte comando:
ssh utilizador@servidorPara testar uma ligação SFTP, pode usar:
sftp utilizador@servidorSubstituir:
utilizador pelo utilizador cPanel.servidor pelo hostname ou IP do servidor.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.
Possíveis causas:
Não é possível recuperar a passphrase. Deverá criar uma nova chave SSH e importar novamente a chave pública no cPanel.