Git via SSH

Vous pouvez accéder aux données et y écrire dans les dépôts sur huggingface.co en utilisant SSH (Secure Shell Protocol). Lors de la connexion via SSH, vous vous authentifiez à l’aide d’un fichier de clé privée sur votre machine locale.

Certaines actions, telles que la publication de modifications ou le clonage de dépôts privés, vous obligeront à téléverser votre clé publique SSH sur votre compte sur huggingface.co.

Vous pouvez utiliser une clé SSH existante ou en générer une nouvelle spécifiquement pour huggingface.co.

Vérification des clés SSH existantes

Si vous disposez déjà d'une clé SSH, vous pouvez utiliser cette clé pour authentifier les opérations Git via SSH.

Les clés SSH se trouvent généralement sous ~/.ssh sur Mac et Linux, et sous C:\\Users\\<username>\\.ssh sur Windows. Listez les fichiers de ce répertoire et recherchez des fichiers de la forme :

• id_rsa.pub
• id_ecdsa.pub
• id_ed25519.pub

Ces fichiers contiennent votre clé publique SSH.

Si vous n’avez pas de tel fichier sous ~/.ssh, vous devrez générer une nouvelle clé. Sinon, vous pouvez ajouter votre/vos clé(s) publique(s) SSH existante(s) à votre compte huggingface.co.

Générer une nouvelle paire de clés SSH

Si vous n’avez aucune clé SSH sur votre machine, vous pouvez utiliser ssh-keygen pour générer une nouvelle paire de clés SSH (clés publique et privée) :

$ ssh-keygen -t ed25519 -C "your.email@example.co"

Nous vous recommandons de saisir une phrase de passe lorsque cela vous est demandé. Une phrase de passe constitue un niveau de sécurité supplémentaire : il s’agit d’un mot de passe qui sera demandé à chaque utilisation de votre clé SSH.

Une fois votre nouvelle clé générée, ajoutez-la à votre agent SSH avec ssh-add :

$ ssh-add ~/.ssh/id_ed25519

Si vous avez choisi un emplacement différent de l’emplacement par défaut pour stocker votre clé SSH, vous devez remplacer ~/.ssh/id_ed25519 par l’emplacement du fichier que vous avez utilisé.

Ajouter une clé SSH à votre compte

Pour accéder aux dépôts privés via SSH, ou pour pousser des modifications via SSH, vous devez ajouter votre clé publique SSH à votre compte huggingface.co. Vous pouvez gérer vos clés SSH dans vos paramètres utilisateur.

Pour ajouter une clé SSH à votre compte, cliquez sur le bouton « Ajouter une clé SSH ».

Ensuite, saisissez un nom pour cette clé (par exemple, « Ordinateur personnel »), puis copiez et collez le contenu de votre clé SSH publique dans la zone ci-dessous. La clé publique se trouve dans le fichier ~/.ssh/id_XXXX.pub que vous avez trouvé ou généré aux étapes précédentes.

Cliquez sur « Add key », et voilà ! Vous avez ajouté une clé SSH à votre compte huggingface.co.

Tester votre authentification SSH

Une fois que vous avez ajouté votre clé SSH à votre compte huggingface.co, vous pouvez tester que la connexion fonctionne comme prévu.

Dans un terminal, exécutez :

$ ssh -T git@hf.co

Si vous voyez un message contenant votre nom d'utilisateur, félicitations ! Tout s'est bien passé, vous êtes prêt à utiliser git via SSH.

Sinon, si le message indique quelque chose comme ce qui suit, assurez-vous que votre clé SSH est bien utilisée par votre agent SSH.

Hi anonymous, welcome to Hugging Face.

Empreintes des clés SSH de Hugging Face

Les empreintes des clés publiques peuvent être utilisées pour valider une connexion à un serveur distant.

Voici les empreintes des clés publiques publiques de Hugging Face :

SHA256:aBG5R7IomF4BSsx/h6tNAUVLhEkkaNGB8Sluyh/Q/qY (ECDSA) SHA256:skgQjK2+RuzvdmHr24IIAJ6uLWQs0TGtEUt3FtzqirQ (DSA - obsolète) SHA256:dVjzGIdV7d6cwKIeZiCoRMa2gMvSKfGZAvHf4gMiMao (ED25519) SHA256:uqjYymysBGCXXiMVebB8L8RIuWbPSKGBxQQNhcT5a3Q (RSA)

Vous pouvez ajouter les entrées de clé ssh suivantes à votre fichier ~/.ssh/known_hosts pour éviter de vérifier manuellement les hôtes Hugging Face :

hf.co ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDtPB+snz63eZvTrbMY2Qt39a6HYile89JOum55z3lhIqAqUHxLtXFd+q+ED8izQvyORFPSmFIaPw05rtXo37bm+ixL6wDmvWrHN74oUUWmtrv2MNCLHE5VDb3+Q6MJjjDVIoK5QZIuTStlq0cUbGGxQk7vFZZ2VXdTPqgPjw4hMV7MGp3RFY/+Wy8rIMRv+kRCIwSAOeuaLPT7FzL0zUMDwj/VRjlzC08+srTQHqfoh0RguZiXZQneZKmM75AFhoMbP5x4AW2bVoZam864DSGiEwL8R2jMiyXxL3OuicZteZqll0qfRlNopKnzoxS29eBbXTr++ILqYz1QFqaruUgqSi3MIC9sDYEqh2Q8UxP5+Hh97AnlgWDZC0IhojVmEPNAc7Y2d+ctQl4Bt91Ik4hVf9bU+tqMXgaTrTMXeTURSXRxJEm2zfKQVkqn3vS/zGVnkDS+2b2qlVtrgbGdU/we8Fux5uOAn/dq5GygW/DUlHFw412GtKYDFdWjt3nJCY8=
hf.co ssh-dss AAAAB3NzaC1kc3MAAACBAORXmoE8fn/UTweWy7tCYXZxigmODg71CIvs/haZQN6GYqg0scv8OFgeIQvBmIYMnKNJ7eoo5ZK+fk1yPv8aa9+8jfKXNJmMnObQVyObxFVzB51x8yvtHSSrL4J3z9EAGX9l9b+Fr2+VmVFZ7a90j2kYC+8WzQ9HaCYOlrALzz2VAAAAFQC0RGD5dE5Du2vKoyGsTaG/mO2E5QAAAIAHXRCMYdZij+BYGC9cYn5Oa6ZGW9rmGk98p1Xc4oW+O9E/kvu4pCimS9zZordLAwHHWwOUH6BBtPfdxZamYsBgO8KsXOWugqyXeFcFkEm3c1HK/ysllZ5kM36wI9CUWLedc2vj5JC+xb5CUzhVlGp+Xjn59rGSFiYzIGQC6pVkHgAAAIBve2DugKh3x8qq56sdOH4pVlEDe997ovEg3TUxPPIDMSCROSxSR85fa0aMpxqTndFMNPM81U/+ye4qQC/mr0dpFLBzGuum4u2dEpjQ7B2UyJL9qhs1Ubby5hJ8Z3bmHfOK9/hV8nhyN8gf5uGdrJw6yL0IXCOPr/VDWSUbFrsdeQ==
hf.co ecdsa-sha2-nistp256 AAAAE2VjZHNhLXNoYTItbmlzdHAyNTYAAAAIbmlzdHAyNTYAAABBBL0wtM52yIjm8gRecBy2wRyEMqr8ulG0uewT/IQOGz5K0ZPTIy6GIGHsTi8UXBiEzEIznV3asIz2sS7SiQ311tU=
hf.co ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAINJjhgtT9FOQrsVSarIoPVI1jFMh3VSHdKfdqp/O776s