ssh-add

Ajouter, afficher et retirer des identités d’un agent existant.

Avant de commencer

L’agent doit être accessible par SSH_AUTH_SOCK. L’absence d’identités diffère d’une impossibilité de joindre l’agent. -t limite la durée de chargement, sans supprimer ni faire expirer le fichier de clé. Retirer une identité de l’agent ne révoque pas son autorisation sur le serveur et ne supprime pas un élément du trousseau.

Exemples

Charger une clé privée pour une heure et saisir sa phrase secrète si demandée.

ssh-add -t 1h ~/.ssh/id_ed25519

Lister les empreintes des identités chargées dans l’agent.

ssh-add -l

Retirer cette identité de l’agent sans supprimer son fichier.

ssh-add -d ~/.ssh/id_ed25519

Options et exemples

identity_fileCourant

Ajoutez une clé privée à l'agent, en lui demandant sa phrase secrète si nécessaire.

Exemple

ssh-add ~/.ssh/id_ed25519

-l / -LCourant

Répertoriez les empreintes digitales ou les clés publiques actuellement détenues par l'agent.

Exemple

ssh-add -l

-t lifeCourant

Limiter la durée pendant laquelle l'identité reste dans l'agent ; cela n'expire pas et ne révoque pas la clé elle-même.

Exemple

ssh-add -t 1h ~/.ssh/id_ed25519

-d identity_fileCourant

Supprimez une identité de l'agent ; cela ne le révoque pas sur le serveur.

Exemple

ssh-add -d ~/.ssh/id_ed25519

-D

Supprimez toutes les identités de l'agent actuel, sans supprimer les fichiers clés.

Exemple

ssh-add -D

-c

Exiger une confirmation avant qu'une identité ajoutée ne soit utilisée ; un programme de confirmation approprié est requis.

Exemple

ssh-add -c ~/.ssh/id_ed25519

-x / -X

Verrouillez ou déverrouillez l'agent de manière interactive.

Exemple

ssh-add -x

-T public_key

Testez si l'agent peut utiliser la clé privée correspondante.

Exemple

ssh-add -T ~/.ssh/id_ed25519.pub

Références officielles

Vérifié le 27 octobre 2026