Acceso de desarrollador por SSH
Claves SSH de la cuenta, a qué servidores pueden llegar y tokens de corta duración para conectarte a uno.
Llegar a un servidor gestionado por Xuda mediante SSH tiene tres capas: las claves que posee tu cuenta, cuáles de ellas acepta un servidor concreto y un token revocable de corta duración que es el que realmente abre la conexión. Toda conexión pasa por un túnel a través de Xuda; nada de esto te entrega directamente la dirección propia del servidor.
Añadir una clave a tu cuenta
Configuración > Seguridad > Claves SSH contiene todas las claves públicas que tu cuenta puede ofrecer a un servidor. Cada clave es una línea: su nombre, el tipo y el final de la clave, cuándo se añadió, a cuántos servidores da acceso y un estado: Activado, Desactivado, Caduca pronto, Caducado o Sin servidor.
Genera un par de claves, si todavía no tienes uno
Acepta la ubicación de archivo predeterminada y, si quieres, establece una frase de contraseña. Esto crea dos archivos: una clave privada que te quedas tú y un archivo .pub que compartes.
Añade la clave pública
Pulsa Añadir clave SSH (una cuenta sin claves abre el formulario directamente). En el formulario Nueva clave SSH, pega el contenido del archivo .pub en Contenido de la clave SSH, ponle un Nombre de la clave y pulsa Agregar clave. La clave se comprueba al pegarla, así que una clave privada, una línea que no es una clave pública o un comentario sin @ se señala antes de que añadas nada. Una Fecha de vencimiento (opcional) puede ser hoy o posterior; déjala vacía para una clave que nunca caduca. La clave nueva se abre entonces en el sitio, marcada como Sin servidor: nadie puede usarla hasta que elijas sus servidores (consulta la sección siguiente).
Gestionar una clave
Pulsa la fila de cualquier clave para abrirla en el sitio; solo hay una clave abierta a la vez. La clave abierta muestra su estado, la clave con su fecha de vencimiento y los días que quedan hasta esa fecha. Una clave que te necesita se abre sola: una que ha caducado pero sigue en un servidor y, si no hay ninguna, la que está en un servidor y caduca antes dentro de 14 días. En la clave abierta:
- Editar cambia el nombre de la clave y su fecha de vencimiento. La clave en sí es de solo lectura: para cambiarla, añade una clave nueva. En una clave marcada como Caduca pronto el botón dice Ampliar el vencimiento, y en una clave caducada Fijar un nuevo vencimiento; ambos son la misma edición, abierta en la fecha. Limpiar, junto a la fecha, quita el vencimiento.
- El interruptor Acceso desactiva la clave sin eliminarla, lo que la quita de todos los servidores en los que está instalada a la vez. Un servidor al que no se puede llegar conserva la clave, y la línea bajo el interruptor indica cuántos servidores no respondieron, para que puedas volver a intentarlo. Volver a activar una clave no la reinstala: añádela de nuevo en cada servidor.
- Eliminar te pide confirmación, luego quita la clave de todos los servidores que abre y la elimina. Si un servidor no responde, la clave no se elimina.
El Registro de accesos, la última fila bajo tus claves, se abre en el sitio y lista cada concesión, retirada y caducidad de la cuenta, de la más reciente a la más antigua: seis eventos, y luego Mostrar todo para el resto (los últimos 500 en total). Actividad de esta clave, en una clave abierta, abre el mismo registro solo para esa clave, y Todas las claves lo amplía de nuevo a la cuenta.
Una clave a menos de 14 días de su fecha de vencimiento muestra Caduca pronto mientras está en un servidor; pasada la fecha muestra Caducado. Antes de que pase su fecha, una clave desactivada muestra Desactivado y una que no está en ningún servidor muestra Sin servidor. Las claves caducadas se quitan de sus servidores una vez por hora; desactiva una clave caducada para quitarla ahora. Cuando ya está fuera de sus servidores no tiene interruptor: dale una fecha nueva con Fijar un nuevo vencimiento y vuelve a añadirla en un servidor. Una clave caducada o desactivada no se puede asignar de nuevo a un servidor, pero quitar una ya asignada sigue funcionando.
Elegir a qué servidor puede llegar una clave
Añadir una clave a tu cuenta no le da por sí solo acceso a nada, y la pantalla de la propia clave muestra a cuántos servidores da acceso, no a cuáles. Abre la pestaña Avanzado de un VPS, un VPS gestionado, un centro de datos o un despliegue y pulsa Asignar claves, en la fila Claves SSH bajo Mantenerlo al día, para elegir cuáles de las claves de tu cuenta pueden llegar a ese servidor concreto.
Al guardar se concilia tu selección con lo que estaba instalado cuando abriste el selector: primero se instalan las claves recién marcadas y después se quitan las desmarcadas, de modo que una clave que el servidor rechaza (porque está desactivada o caducada) nunca puede quitar un acceso que ya funcionaba. Una clave desactivada o caducada se muestra como tal en el selector y no se puede seleccionar de nuevo.
Conectarte al servidor
Abre el proyecto y pulsa Conectar en su fila Conéctese por SSH de forma segura (solo proyectos de la familia VPS) para abrir Acceso de desarrollador, un gestor de tokens de conexión con nombre y revocables, independiente de las claves de la cuenta de arriba.
Crea un acceso con nombre
Pulsa Agregar acceso, ponle una etiqueta (para quién o para qué es) y, si quieres, un vencimiento (7, 30, 90 o 365 días, o ninguno). Al crearlo se muestra un token de conexión de un solo uso: cópialo ahora, no se puede volver a mostrar.
Instala el cliente y conéctate
El cuadro de diálogo ofrece un comando de instalación para copiar y pegar y un comando de conexión por plataforma (macOS, Linux, Windows), construidos en torno a websocat, que canaliza la conexión a un puerto de tu propia máquina. Apunta cualquier cliente SSH o SFTP a esa dirección local una vez que el túnel esté en marcha, iniciando sesión como root.
Gestiónalo después
Cada acceso con nombre tiene su propio interruptor de suspensión; suspender un acceso, dejar que pase su vencimiento o eliminarlo se aplica en el propio túnel, cerrando una sesión que ya está en curso. Regenerar genera un token nuevo para un acceso existente e invalida el anterior; nunca rota automáticamente, ya que eso dejaría sin acceso a quien aún lo esté usando. Eliminar un acceso pide confirmación antes.
Un intento de conexión falla con este error cuando todavía no se ha asignado ninguna clave de la cuenta a ese servidor. Añade una clave en Configuración > Seguridad > Claves SSH y luego asígnala al servidor antes de volver a intentarlo.