Aller au contenu
Vérifié

Accès développeur SSH

Clés SSH du compte, serveurs qu'elles peuvent atteindre et jetons de courte durée pour se connecter à l'un d'eux.

Accéder à un serveur géré par Xuda en SSH comporte trois couches : les clés que possède votre compte, celles qu'un serveur donné accepte, et un jeton de courte durée, révocable, qui ouvre réellement la connexion. Chaque connexion passe par un tunnel via Xuda ; rien ici ne vous donne directement l'adresse du serveur lui-même.

Ajouter une clé à votre compte

Paramètres > Sécurité > Clés SSH contient toutes les clés publiques que votre compte peut proposer à un serveur. Chaque clé tient sur une ligne : son nom, le type et la fin de la clé, sa date d'ajout, le nombre de serveurs qu'elle ouvre et un statut : Activé, Désactivé, Expire bientôt, Expiré ou Aucun serveur.

Générez une paire de clés, si vous n'en avez pas déjà une

Terminal
ssh-keygen

Acceptez l'emplacement de fichier par défaut et, si vous le souhaitez, définissez une phrase secrète. Cela crée deux fichiers : une clé privée que vous gardez, et un fichier .pub que vous partagez.

Ajoutez la clé publique

Appuyez sur Ajouter une clé SSH (un compte sans clé ouvre directement le formulaire). Dans le formulaire Nouvelle clé SSH, collez le contenu du fichier .pub dans Contenu de la clé SSH, donnez-lui un Nom de la clé, puis appuyez sur Ajouter une clé. La clé est vérifiée pendant que vous la collez : une clé privée, une ligne qui n'est pas une clé publique ou un commentaire sans @ est signalé avant que vous n'ajoutiez quoi que ce soit. Une Date d'expiration (facultatif) peut être aujourd'hui ou plus tard ; laissez-la vide pour une clé qui n'expire jamais. La nouvelle clé s'ouvre ensuite sur place, marquée Aucun serveur : personne ne peut l'utiliser tant que vous n'avez pas choisi ses serveurs (voir la section suivante).

Gérer une clé

Appuyez sur la ligne d'une clé pour l'ouvrir sur place ; une seule clé est ouverte à la fois. La clé ouverte affiche son statut, la clé avec sa date d'expiration et le nombre de jours restants avant cette date. Une clé qui a besoin de vous s'ouvre d'elle-même : une clé expirée mais toujours sur un serveur, sinon celle qui est sur un serveur et expire le plus tôt dans les 14 jours. Dans la clé ouverte :

  • Modifier change le nom de la clé et sa date d'expiration. La clé elle-même est en lecture seule : pour la changer, ajoutez une nouvelle clé. Sur une clé marquée Expire bientôt, le bouton indique Prolonger l'expiration, et sur une clé expirée Définir une nouvelle expiration ; c'est la même modification, ouverte sur la date. Effacer à côté de la date supprime l'expiration.
  • Le commutateur Accès désactive la clé sans la supprimer, ce qui la retire en une fois de tous les serveurs sur lesquels elle est installée. Un serveur injoignable garde la clé, et la ligne sous le commutateur indique combien de serveurs n'ont pas répondu, pour que vous puissiez réessayer. Réactiver une clé ne la réinstalle pas : ajoutez-la de nouveau sur chaque serveur.
  • Supprimer demande une confirmation, puis retire la clé de tous les serveurs qu'elle ouvre et la supprime. Si un serveur ne répond pas, la clé n'est pas supprimée.

Le Journal d'accès, dernière ligne sous vos clés, s'ouvre sur place et liste chaque attribution, retrait et expiration du compte, du plus récent au plus ancien : six événements, puis Tout afficher pour le reste (les 500 derniers au total). Activité de cette clé, dans une clé ouverte, ouvre le même journal pour cette seule clé, et Toutes les clés l'élargit de nouveau au compte.

Expiration

Une clé à moins de 14 jours de sa date d'expiration affiche Expire bientôt tant qu'elle est sur un serveur ; passé la date, elle affiche Expiré. Avant que sa date ne passe, une clé désactivée affiche Désactivé et une clé sur aucun serveur affiche Aucun serveur. Les clés expirées sont retirées de leurs serveurs une fois par heure ; désactivez une clé expirée pour la retirer tout de suite. Une fois retirée de ses serveurs, elle n'a plus de commutateur : donnez-lui une nouvelle date avec Définir une nouvelle expiration, puis ajoutez-la de nouveau sur un serveur. Une clé expirée ou désactivée ne peut pas être nouvellement attribuée à un serveur, mais retirer une clé déjà attribuée fonctionne toujours.

Choisir quel serveur une clé peut atteindre

Ajouter une clé à votre compte ne lui donne pas à lui seul accès à quoi que ce soit, et l'écran de la clé indique combien de serveurs elle ouvre, pas lesquels. Ouvrez l'onglet Avancé d'un VPS, d'un VPS géré, d'un datacenter ou d'un déploiement et appuyez sur Attribuer des clés, sur la ligne Clés SSH sous Rester à jour, pour choisir lesquelles des clés de votre compte peuvent atteindre ce serveur précis.

L'enregistrement rapproche votre sélection de ce qui était installé à l'ouverture du sélecteur : les clés nouvellement cochées sont installées d'abord, puis les clés décochées sont retirées, si bien qu'une clé que le serveur refuse (parce qu'elle est désactivée ou expirée) ne peut jamais retirer un accès qui fonctionnait déjà. Une clé désactivée ou expirée est signalée comme telle dans le sélecteur et ne peut pas être nouvellement sélectionnée.

Se connecter au serveur

Ouvrez le projet et appuyez sur Connecter sur sa ligne SSH sécurisé (projets de type VPS uniquement) pour ouvrir Accès développeur, un gestionnaire de jetons de connexion nommés et révocables, distinct des clés du compte ci-dessus.

Créez un accès nommé

Appuyez sur Ajouter un accès, donnez-lui un libellé (à qui ou à quoi il est destiné) et, si vous le souhaitez, une expiration (7, 30, 90 ou 365 jours, ou jamais). La création affiche un jeton de connexion à usage unique : copiez-le maintenant, il ne pourra plus être affiché.

Installez le client et connectez-vous

La boîte de dialogue fournit une commande d'installation à copier-coller et une commande de connexion par plateforme (macOS, Linux, Windows), construites autour de websocat, qui fait passer la connexion par un tunnel vers un port de votre propre machine. Pointez n'importe quel client SSH ou SFTP vers cette adresse locale une fois le tunnel lancé, en vous connectant en tant que root.

Gérez-le ensuite

Chaque accès nommé a son propre commutateur de suspension ; suspendre un accès, laisser passer une expiration ou le supprimer est appliqué au niveau du tunnel lui-même, ce qui ferme une session déjà en cours. Régénérer crée un nouveau jeton pour un accès existant et invalide l'ancien ; il ne se renouvelle jamais automatiquement, car cela couperait l'accès de quiconque l'utilise encore. Supprimer un accès demande d'abord une confirmation.

Permission denied (publickey)

Une tentative de connexion échoue avec cette erreur quand aucune clé du compte n'a encore été attribuée à ce serveur. Ajoutez une clé sous Paramètres > Sécurité > Clés SSH, puis attribuez-la au serveur, avant de réessayer.