Clés SSH

Les clés SSH permettent à Kuploy de s'authentifier en votre nom auprès de dépôts Git privés, pour en cloner les sources lors des builds. Elles se gèrent dans Settings → SSH Keys.

Ajouter une clé existante

1. Allez dans Settings → SSH Keys et cliquez sur Add SSH Key.
2. Renseignez :
   • Name — un libellé pour reconnaître la clé (par exemple github-deploy) ;
   • Description — une note facultative (par exemple « clé de déploiement de mon dépôt privé ») ;
   • Public Key — la ligne ssh-rsa … ou ssh-ed25519 … ;
   • Private Key — le bloc PEM/OpenSSH complet, lignes -----BEGIN … PRIVATE KEY----- et -----END … PRIVATE KEY----- comprises.
3. Cliquez sur Create.

Kuploy vérifie le format avant d'enregistrer : seules les clés RSA et ED25519 sont acceptées. Une clé mal formée est refusée sur place (« Invalid public key format » ou « Invalid private key format »).

Générer une paire de clés en local

Si vous n'avez pas encore de clé, créez-en une avec ssh-keygen :

ssh-keygen -t ed25519 -f ./kuploy-key -N "" -C "kuploy"

Deux fichiers sont écrits :

• kuploy-key.pub → à coller dans Public Key (ssh-ed25519 AAAA… kuploy)
• kuploy-key → à coller dans Private Key (-----BEGIN OPENSSH PRIVATE KEY-----…)

Pour du RSA : ssh-keygen -t rsa -b 4096 -f ./kuploy-key -N "" -C "kuploy".

Générer une clé depuis l'interface

La fenêtre propose aussi Generate RSA SSH Key et Generate ED25519 SSH Key, qui créent une paire pour vous et remplissent les deux champs. Servez-vous des boutons de téléchargement Public Key et Private Key pour en garder une copie avant de cliquer sur Create : la clé privée n'est affichée qu'une seule fois.

Utiliser une clé

Une fois enregistrée, la clé devient sélectionnable lors de la configuration d'un fournisseur Git pointant vers un dépôt privé.