Proxmox Backup Client failed: error missing key — comment résoudre

Lors de l’utilisation de Proxmox Backup Client avec le chiffrement, vous pouvez rencontrer le message « error: missing key ». Cet article explique la cause de cette erreur et propose des solutions.

Comprendre l’erreur

Cette erreur survient lorsque Proxmox Backup Client tente de sauvegarder vers un datastore chiffré ou de restaurer depuis celui-ci, mais ne parvient pas à trouver la clé de chiffrement. Le client a besoin de cette clé pour chiffrer les données avant de les envoyer au serveur (lors des sauvegardes) ou pour les déchiffrer après les avoir reçues (lors des restaurations).

Causes fréquentes

1. Clé de chiffrement non spécifiée

Si vous avez activé le chiffrement lors de la création de votre première sauvegarde mais n’avez pas spécifié la clé pour les opérations suivantes :

# Ceci échouera si le datastore exige le chiffrement
proxmox-backup-client backup root.pxar:/ --repository user@server:store

# Spécifiez le fichier de clé
proxmox-backup-client backup root.pxar:/ --repository user@server:store --keyfile /path/to/encryption-key.json

2. Fichier de clé introuvable

Le fichier de clé a pu être déplacé, supprimé, ou le chemin est incorrect. Vérifiez que le fichier de clé existe :

ls -la /path/to/encryption-key.json

3. Permissions du fichier de clé

Le fichier de clé doit être lisible par l’utilisateur exécutant la sauvegarde :

chmod 600 /path/to/encryption-key.json

Solutions

Spécifier explicitement le fichier de clé

Utilisez toujours le paramètre --keyfile lorsque vous travaillez avec des datastores chiffrés :

proxmox-backup-client backup root.pxar:/ \
  --repository user@pbs!token@server:store \
  --keyfile /etc/proxmox-backup/encryption-key.json

Définir le fichier de clé via une variable d’environnement

Vous pouvez définir la variable d’environnement PBS_ENCRYPTION_PASSWORD pour éviter de spécifier le fichier de clé à chaque fois.

Regénérer la clé (en dernier recours)

Si vous avez perdu votre clé de chiffrement, vous ne pourrez pas déchiffrer les sauvegardes existantes. Vous pouvez générer une nouvelle clé pour les sauvegardes futures :

proxmox-backup-client key create /etc/proxmox-backup/encryption-key.json

Attention : Les sauvegardes chiffrées existantes seront irrécupérables sans la clé d’origine. Conservez toujours des copies sécurisées de vos clés de chiffrement.

Prévention

• Conservez les clés de chiffrement dans un emplacement sécurisé et séparé
• Gardez plusieurs copies de votre clé (clé USB chiffrée, gestionnaire de mots de passe)
• Documentez quelle clé est utilisée pour quelle tâche de sauvegarde
• Ne stockez jamais la clé sur le même système que celui que vous sauvegardez

Besoin d’aide ?

Contactez notre équipe de support si vous avez besoin d’assistance pour la gestion des clés de chiffrement sur votre instance Cloud-PBS.