Comment créer des clés API et ajouter des clés SSH

Les deux types de clés se trouvent sur une même page : Compte, puis Clés API et SSH.

Clés API

Une clé API permet à un script ou à un outil d’utiliser le panel en votre nom, par exemple pour démarrer un serveur depuis un bot ou lire son état. Traitez-la comme un mot de passe : toute personne qui la possède peut faire ce qu’elle autorise.

Les clés API cessent de fonctionner 30 jours après leur création. Créez une nouvelle clé et mettez à jour votre script avant cette date. Vous pouvez avoir jusqu’à 25 clés.

Créer une clé

1. Ouvrez le panel, cliquez sur Compte, puis sur Clés API et SSH.
2. Sous Clés API, saisissez une Description d’au moins 4 caractères pour vous rappeler à quoi sert la clé, comme « Bot Discord de redémarrage ».
3. Dans IP autorisées, listez les adresses IP qui peuvent utiliser la clé, une par ligne. Laissez le champ vide pour autoriser n’importe quelle adresse. Une clé restreinte est plus sûre : utilisez-en une dès que vous savez où le script tourne.
4. Cliquez sur Créer.

5. La fenêtre Votre clé API affiche la clé. Elle n’est affichée qu’une fois et ne peut pas être récupérée ensuite. Copiez-la dans votre gestionnaire de mots de passe ou dans le coffre à secrets de votre script avant de fermer la fenêtre.

Supprimer une clé

Repérez la clé dans la liste sous le formulaire et supprimez-la. Tout ce qui l’utilise cesse aussitôt de fonctionner. Supprimez les clés que vous n’utilisez plus, ainsi que toute clé que vous pensez avoir fuité.

Clés SSH

Une clé SSH vous permet de vous connecter en SFTP sans saisir votre mot de passe.

Ajouter une clé

1. Créez une paire de clés sur votre ordinateur si vous n’en avez pas. La plupart des systèmes savent le faire avec la commande ssh-keygen. Ne partagez jamais le fichier de la clé privée.
2. Ouvrez la page Clés API et SSH.
3. Sous Clés SSH, saisissez un Nom de la clé SSH, comme « PC maison ».
4. Collez votre clé publique dans Clé publique. Elle tient sur une ligne et commence par le type de clé, par exemple ssh-ed25519. Les clés DSA ne sont pas acceptées, et les clés RSA doivent faire au moins 2048 bits.
5. Cliquez sur Enregistrer.

L’utiliser

Dans FileZilla ou WinSCP, choisissez le fichier de votre clé privée à la place d’un mot de passe lors de la connexion. Consultez Comment se connecter aux fichiers de votre serveur avec SFTP.

Bon à savoir

• Vous verrez un avis de sécurité quand une clé API est créée ou supprimée. Consultez Comment gérer les notifications et les préférences.
• Les clés agissent en votre nom. Si une personne quitte votre équipe, retirez son accès au serveur au lieu de partager une clé. Consultez Comment inviter des amis et leur donner accès.