Saltar para o conteúdo

Publicar por SFTP com uma chave SSH

Um método avançado: criar um par de chaves, registá-lo no seu alojamento e escolhê-lo no TOWeb.

Um método avançado

Por SFTP, o TOWeb liga-se normalmente com a palavra-passe do seu alojamento. Se o seu alojamento o aceitar, também se pode ligar com uma chave SSH: um ficheiro guardado no seu computador que substitui a palavra-passe. Este método serve sobretudo se já tiver chaves ou se o seu alojamento as exigir. A palavra-passe continua disponível e continua a ser a escolha certa na maioria dos casos.

Antes de escolher a chave

  • A chave fica neste computador. Uma pessoa a quem confie o site, um webmaster por exemplo, não o poderá publicar com esta chave. Dê-lhe antes um acesso por palavra-passe.
  • Para publicar a partir de outro computador, copie para lá a chave, ou crie uma nova e registe-a também no alojamento.
  • Se a chave se perder, o TOWeb deixa de poder publicar com este método. Volte à palavra-passe, ou crie uma nova chave.

Criar o par de chaves

Um par de chaves é composto por uma chave privada, que fica consigo, e por uma chave pública, que entrega ao alojamento. No Mac, abra o Terminal. No Windows 10 ou 11, abra o PowerShell. Escreva depois este comando e prima Enter:

1
ssh-keygen -t ed25519

Aceite a localização proposta com Enter. Escolha depois uma frase-passe, ou deixe-a vazia. São criados dois ficheiros na pasta .ssh da sua pasta pessoal: id_ed25519, a chave privada, e id_ed25519.pub, a chave pública. Se já existir um ficheiro id_ed25519, responda n: já tem uma chave, utilize-a.

Com o PuTTYgen, exporte a chave privada no formato OpenSSH, pelo menu Conversions › Export OpenSSH key: o TOWeb não lê ficheiros .ppk.

Registar a chave pública no alojamento

Abra o ficheiro id_ed25519.pub com um editor de texto e copie o seu conteúdo: uma única linha que começa por ssh-ed25519. Cole-a na área de cliente do seu alojamento, na secção das chaves SSH, cujo nome varia de um alojamento para outro. Sem uma secção assim, acrescente esta linha ao ficheiro .ssh/authorized_keys da sua conta de alojamento, ou peça-o ao seu alojamento.

Nunca entregue o ficheiro id_ed25519, sem .pub: é a chave privada.

Configurar o TOWeb

  1. Abra Publicar e escolha SFTP em Método.
  2. Em Autenticação, escolha Chave SSH.
  3. Em Caminho da chave privada, clique em Escolher… e selecione a chave privada, id_ed25519 sem .pub. Também pode escrever o caminho, por exemplo ~/.ssh/id_ed25519.
  4. Se a chave tiver uma frase-passe, escreva-a em Frase-passe (se a chave tiver uma). Fica guardada de forma cifrada no seu computador.
  5. Clique em Testar ligação.

Se a ligação falhar, a mensagem indica a causa: chave não encontrada nesse local, frase-passe em falta ou incorreta, ou um ficheiro que não é uma chave reconhecida. Com uma chave, o TOWeb nunca tenta a palavra-passe em seu lugar.

Para voltar à palavra-passe, escolha Palavra-passe em Autenticação.

Atualizado a 19 de novembro de 2026