Acesso SSH para programadores
Chaves SSH da conta, os servidores que podem alcançar e tokens de curta duração para ligar a um deles.
Alcançar um servidor gerido pelo Xuda por SSH tem três camadas: as chaves que a sua conta possui, quais delas um dado servidor aceita e um token de curta duração e revogável que realmente abre a ligação. Todas as ligações passam por um túnel através do Xuda; nada aqui lhe dá diretamente o endereço do próprio servidor.
Adicionar uma chave à sua conta
Definições > Segurança > Chaves SSH contém todas as chaves públicas que a sua conta pode oferecer a um servidor. Cada chave ocupa uma linha: o seu nome, o tipo e o fim da chave, quando foi adicionada, quantos servidores abre e um estado: Ativado, Desativado, Expira em breve, Expirado ou Sem servidor.
Gere um par de chaves, se ainda não tiver um
Aceite a localização de ficheiro predefinida e, opcionalmente, defina uma frase-passe. Isto cria dois ficheiros: uma chave privada que guarda consigo e um ficheiro .pub que partilha.
Adicione a chave pública
Carregue em Adicionar chave SSH (uma conta sem chaves abre logo o formulário). No formulário Nova chave SSH, cole o conteúdo do ficheiro .pub em Conteúdo da chave SSH, dê-lhe um Nome da chave e carregue em Adicionar chave. A chave é verificada à medida que a cola, por isso uma chave privada, uma linha que não seja uma chave pública ou um comentário sem @ é assinalado antes de adicionar fosse o que fosse. Uma Data de validade (opcional) pode ser hoje ou posterior; deixe-a vazia para uma chave que nunca expira. A nova chave abre então no próprio local, marcada como Sem servidor: ninguém a pode usar até escolher os respetivos servidores (veja a secção seguinte).
Gerir uma chave
Carregue na linha de qualquer chave para a abrir no próprio local; só uma chave está aberta de cada vez. A chave aberta mostra o seu estado, a chave com a sua data de validade e os dias que faltam até essa data. Uma chave que precisa de si abre sozinha: uma que expirou mas ainda está num servidor ou, caso contrário, a que está num servidor e expira mais cedo nos próximos 14 dias. Na chave aberta:
- Editar altera o nome e a data de validade da chave. A chave em si é só de leitura: para a alterar, adicione uma nova chave. Numa chave marcada como Expira em breve o botão diz Prolongar a validade, e numa chave expirada Definir nova validade; ambos são a mesma edição, aberta na data. Limpar, junto à data, remove a validade.
- O interruptor Acesso desativa a chave sem a eliminar, o que a retira de uma só vez de todos os servidores onde está instalada. Um servidor que não pode ser alcançado mantém a chave, e a linha sob o interruptor indica quantos servidores não responderam, para poder tentar de novo. Voltar a ativar uma chave não a reinstala: adicione-a de novo em cada servidor.
- Eliminar pede-lhe confirmação, depois retira a chave de todos os servidores que ela abre e elimina-a. Se um servidor não responder, a chave não é eliminada.
O Registo de acessos, a última linha sob as suas chaves, abre no próprio local e lista todas as concessões, remoções e expirações da conta, das mais recentes para as mais antigas: seis eventos, depois Mostrar tudo para os restantes (os últimos 500 no total). Atividade desta chave, numa chave aberta, abre o mesmo registo apenas para essa chave, e Todas as chaves alarga-o de novo à conta.
Uma chave a menos de 14 dias da data de validade mostra Expira em breve enquanto estiver num servidor; passada a data, mostra Expirado. Antes de a data passar, uma chave desativada mostra Desativado e uma que não está em nenhum servidor mostra Sem servidor. As chaves expiradas saem dos seus servidores uma vez por hora; desative uma chave expirada para a retirar já. Depois de sair dos servidores, deixa de ter interruptor: dê-lhe uma nova data com Definir nova validade e adicione-a de novo a um servidor. Uma chave expirada ou desativada não pode ser atribuída de novo a um servidor, mas remover uma já atribuída continua a funcionar.
Escolher a que servidor uma chave pode aceder
Adicionar uma chave à sua conta não lhe dá, por si só, acesso a nada, e o ecrã da própria chave mostra quantos servidores ela abre, não quais. Abra o separador Avançado de um VPS, VPS gerido, datacenter ou implementação e carregue em Atribuir chaves, na linha Chaves SSH em Manter atualizado, para escolher quais das chaves da sua conta podem aceder a esse servidor em particular.
Ao guardar, a sua seleção é reconciliada com o que estava instalado quando abriu o seletor: as chaves recém-marcadas são instaladas primeiro, depois as desmarcadas são removidas, de modo que uma chave que o servidor recuse (por estar desativada ou expirada) nunca pode retirar um acesso que já funcionava. Uma chave desativada ou expirada é mostrada como tal no seletor e não pode ser selecionada de novo.
Ligar ao servidor
Abra o projeto e carregue em Ligar na linha SSH seguro (apenas projetos da família VPS) para abrir Acesso de programador, um gestor de tokens de ligação com nome e revogáveis, separado das chaves da conta acima.
Crie um acesso com nome
Carregue em Adicionar acesso, dê-lhe uma etiqueta (para quem ou para quê é) e, opcionalmente, uma validade (7, 30, 90 ou 365 dias, ou nunca). Ao criá-lo é mostrado um token de ligação de utilização única: copie-o agora, não pode voltar a ser mostrado.
Instale o cliente e ligue-se
A caixa de diálogo dá um comando de instalação para copiar e colar e um comando de ligação por plataforma (macOS, Linux, Windows), construídos em torno de websocat, que faz o túnel da ligação para uma porta na sua própria máquina. Aponte qualquer cliente SSH ou SFTP para esse endereço local quando o túnel estiver a funcionar, iniciando sessão como root.
Gira-o depois
Cada acesso com nome tem o seu próprio interruptor de suspensão; suspender, deixar passar uma validade ou eliminar um acesso é aplicado no próprio túnel, fechando uma sessão já em curso. Regenerar cria um novo token para um acesso existente e invalida o antigo; nunca roda automaticamente, uma vez que isso cortaria o acesso a quem ainda o estivesse a usar. Eliminar um acesso pede primeiro confirmação.
Uma tentativa de ligação falha com este erro quando nenhuma chave da conta foi ainda atribuída a esse servidor. Adicione uma chave em Definições > Segurança > Chaves SSH e depois atribua-a ao servidor, antes de tentar de novo.