Pour vous connecter à vos environnements en SSH depuis votre machine locale, vous ajoutez la moitié publique d’une paire de clés SSH à votre compte PaaS. Le SSH Gate de la plateforme accepte ensuite les connexions authentifiées avec la clé privée correspondante.
Cette page couvre l’ajout d’une clé publique pour l’accès au compte. L’ajout d’une clé privée — utilisée par la plateforme pour s’authentifier sur vos dépôts Git distants au déploiement — est un flux séparé sous SSH Access to Git Repository.
Avant de commencer
Il vous faut une paire de clés SSH générée sur votre machine locale. Si vous n’en avez pas encore, voyez Générer une clé SSH pour les recettes ECDSA, EdDSA et RSA sur Linux, macOS et Windows.
La plateforme supporte les types de clés suivants :
- ECDSA
- EdDSA (Ed25519)
- RSA
Ed25519 est le défaut recommandé pour les nouvelles clés — court, rapide et bien supporté.
Ajouter une clé SSH publique
-
Ouvrir Account Settings. Dans le tableau de bord, regardez la barre d’outils supérieure et cliquez Settings.
-
Trouver le SSH Keychain. L’onglet Account Settings s’ouvre avec SSH Keychain déjà sélectionné à gauche. Cette page liste aussi ce que SSH permet de faire sur la plateforme avec quelques liens vers la documentation.
-
Basculer sur Public. Sous SSH Keychain, cliquez le sous-onglet Public. C’est là que vivent les clés d’accès au compte (par opposition aux clés privées utilisées pour Git).
-
Cliquer Add Public Key. Le dialogue s’ouvre avec un champ multiligne unique pour le corps de la clé.
-
Coller la clé publique. Collez le contenu intégral de votre fichier de clé publique (par exemple le corps de
~/.ssh/id_ed25519.pub). Le champ Title se remplit automatiquement à partir du commentaire en fin de clé — en généraluser@hostname— mais vous pouvez le remplacer par n’importe quoi de descriptif commeportable,poste-bureau,coureur-ci. -
Cliquer Add Key.
La clé apparaît dans la liste. La plateforme vous envoie aussi par courriel une confirmation avec l’empreinte de la clé et la chaîne de connexion SSH à coller dans votre client.
Ce qui est attaché à quoi
La clé SSH ajoutée est attachée à votre compte, pas à un environnement particulier. Chaque environnement sous ce compte accepte les connexions authentifiées avec la clé. Pas de gestion par environnement.
Pour donner l’accès à un environnement précis à un collègue sans lui donner votre compte, utilisez les fonctions de collaboration de la plateforme — il aura sa propre paire de clés sur son propre compte.
Retirer une clé
Chaque clé de la liste a un bouton X rouge à côté. Cliquez-le pour retirer la clé du compte. Le retrait révoque immédiatement sa capacité à s’authentifier via le SSH Gate.
Plusieurs clés
Vous pouvez ajouter plusieurs clés à un compte — un motif courant est une clé par appareil (portable, poste bureau, coureur CI). Elles coexistent ; n’importe laquelle peut authentifier. C’est l’alternative propre à recopier une même clé privée sur plusieurs machines.