Stocker les sauvegardes dans Dropbox

Voici comment configurer ta Dropbox comme destination de tes sauvegardes. Tu ne saisis aucun mot de passe : tu te connectes chez Dropbox, tu y donnes ton accord et tu reviens sur la page « Destinations ».

Ce qu’il te faut

• un compte Dropbox avec assez d’espace libre pour tes sauvegardes,
• un site dont l’administration est accessible via https://,
• l’extension PHP cURL avec https sur le serveur web.

S’il manque cURL au serveur web, Dropbox est grisé dans le choix des types de destination et porte l’étiquette Non disponible sur ce serveur.

Étape 1 : choisir le type de destination

Ouvre la page Destinations et clique sur Ajouter une destination. Choisis Dropbox.

1. Nom est libre. L’extension propose « Dropbox 1 » ; tout nom qui n’est pas encore utilisé convient.
2. La note sur la connexion indique que tu seras redirigé vers Dropbox et que tu reviendras ensuite sur cette page, et que le service auth.cloneworx.de sert d’intermédiaire pour la connexion.
3. La note du type de destination indique que l’extension reçoit dans ta Dropbox son propre dossier sous « Apps » et ne voit rien d’autre, et que les sauvegardes supprimées restent restaurables un certain temps dans Dropbox.
4. Le bouton Connecter avec Dropbox lance la connexion.

Le formulaire n’a ni champ pour un mot de passe, ni champ pour un dossier, ni bouton Tester la connexion : une destination de type Dropbox ne naît qu’avec la connexion, et son emplacement est le dossier que Dropbox tient pour l’application.

Étape 2 : connecter avec Dropbox

Clique sur Connecter avec Dropbox. Ton navigateur quitte la page Destinations :

1. Connecte-toi chez Dropbox et donne ton accord.
2. Ensuite, le service auth.cloneworx.de affiche une page qui nomme le site auquel l’accès est transmis. Ne continue que s’il s’agit de ton site.
3. Ton navigateur revient sur la page Destinations. On y lit brièvement Finalisation de la connexion …

L’extension enregistre la destination, teste immédiatement la connexion et annonce le résultat : « … » enregistrée et connectée. Tu n’as plus besoin d’enregistrer.

1. Toutes les destinations sont connectées.
2. Le message nomme la destination : enregistrée et connectée.
3. La nouvelle destination figure dans la liste. Le point vert signifie : connectée.
4. L’emplacement de la destination est l’adresse du compte Dropbox connecté.

Une connexion commencée reste valable 15 minutes. Les plans et les sauvegardes n’utilisent une destination qu’après un test de connexion réussi.

Si l’extension trouve dans ta Dropbox des sauvegardes qui ne figurent pas dans ta liste, la tuile Sauvegardes trouvées sur « … » apparaît. Pour en savoir plus : Retrouver des sauvegardes après une perte totale.

Étape 3 : choisir la destination dans le plan de sauvegarde

• Ta première destination : L’extension crée le plan « Sauvegarde quotidienne » : chaque jour à une heure aléatoire, tout, cette destination, Sauvegardes max. 7. Le plan est en pause jusqu’à ce que tu l’actives.
• Une destination supplémentaire : Choisis-la sur la page Sauvegarde, dans la tuile Plans de sauvegarde, dans un plan. La version gratuite permet deux plans et une destination par plan.

Pour en savoir plus : Planifier des sauvegardes automatiques.

Si la connexion ne fonctionne pas

Si tu reviens de Dropbox sans accès, aucune destination n’est créée. La page Destinations indique la raison, et le formulaire se rouvre avec tes données.

1. Le message dit : Dropbox indique que l’accès n’a pas été accordé. Rien n’a été connecté.
2. Le formulaire est de nouveau ouvert, avec tes données.
3. Le bouton Connecter avec Dropbox relance la connexion.

Message	Que faire
La connexion nécessite https : l’adresse de l’administration de ce site ne commence pas par https.	Le message figure dans le formulaire avant que le navigateur ne quitte la page. Le service de connexion ne transmet un accès qu’à un site dont l’administration est accessible via https://. Passe le site en https.
La connexion a été annulée. Rien n’a été connecté.	C’est une information, pas une erreur. Clique une nouvelle fois sur Connecter avec Dropbox si tu veux configurer la destination.
… indique que l’accès n’a pas été accordé. Rien n’a été connecté.	Relance la connexion et donne ton accord chez Dropbox.
… n’a pas accordé toutes les autorisations dont la sauvegarde a besoin. Rien n’a été connecté.	L’extension a besoin des quatre autorisations, voir la section « Ce que l’extension peut voir dans Dropbox ». Relance la connexion.
Cette connexion est inconnue ou a expiré. Recommence la connexion.	Ici, le formulaire ne se rouvre pas. Clique sur Ajouter une destination et recommence.
La connexion a pris trop de temps ou a déjà été utilisée. Recommence la connexion.	Relance la connexion.
Le service de connexion est actuellement injoignable. Réessaie plus tard.	Réessaie plus tard. Sous le message, Afficher le journal mène au journal général.
… est actuellement injoignable ou signale une erreur. Réessaie plus tard.	Le message nomme Dropbox. Réessaie plus tard. Ici aussi, Afficher le journal mène au journal général.
La connexion a réussi, mais le premier accès au compte a échoué : …	La raison figure après les deux-points. Relance la connexion une fois qu’elle est résolue.

Ce que l’extension peut voir dans Dropbox

Chez Dropbox, l’application a le type d’accès « App folder » : l’extension voit dans ta Dropbox son propre dossier sous « Apps » et rien d’autre. C’est Dropbox qui fixe le nom de ce dossier. L’extension ne voit aucun autre fichier de ta Dropbox.

L’extension demande à Dropbox quatre autorisations :

Autorisation	Pour quoi
account_info.read	lire l’adresse et l’espace du compte
files.metadata.read	lister les fichiers de son dossier
files.content.read	lire les fichiers de son dossier
files.content.write	écrire des fichiers dans son dossier

Les sauvegardes se trouvent dans ta Dropbox sous Apps/<nom de l’app>/cloneworx-backup-<code>/<sauvegarde>/. La structure et les fichiers d’une sauvegarde sont les mêmes que sur toute autre destination.

Le service de connexion auth.cloneworx.de

Dropbox exige un secret pour la connexion. Un secret ne peut pas figurer dans une extension dont tout le monde peut lire le code. Il se trouve donc chez un petit service de cloneworx, auth.cloneworx.de, qui sert d’intermédiaire pour la connexion.

Qui envoie	Ce que le service apprend
Ton navigateur, quand tu cliques sur Connecter avec Dropbox	l’adresse de la page d’administration de ton site, une valeur aléatoire et la langue
Ton serveur web, après le retour	le code de la connexion. Le service transmet la connexion à Dropbox.
Ton serveur web, tant que la destination est utilisée	l’accès permanent enregistré, chaque fois qu’un nouvel accès est nécessaire : toutes les quelques heures

S’y ajoutent, comme pour toute requête, les adresses IP du navigateur et du serveur web. Le service n’enregistre rien. Il ne reçoit jamais de sauvegarde, jamais de fichier et jamais l’adresse de ton compte Dropbox.

Sur la destination se trouvent deux valeurs, chiffrées comme tout mot de passe d’une destination : l’accès permanent et l’accès valable quelques heures. L’adresse du compte Dropbox connecté est visible sur la destination. Elle ne figure jamais dans le journal ni dans le rapport de support.

Les champs de la vue Étendu

1. Délai de connexion (secondes) accepte de 3 à 60, la valeur par défaut est 10.
2. Débit d’envoi (octets par seconde) peut rester vide : c’est alors ce que le test de connexion a mesuré qui s’applique. L’extension choisit ensuite la taille des sections d’un envoi.

Il n’y a pas non plus de champ pour un dossier dans la vue Étendu.

Modifier et tester la destination

Dans la ligne de la destination, clique sur Plus …, puis Modifier.

1. Nom est le nom de la destination dans les listes et les messages.
2. Le compte connecté est l’adresse du compte Dropbox dans lequel se trouvent les sauvegardes.
3. Enregistrer enregistre tes modifications.
4. Le bouton Reconnecter avec Dropbox relance la connexion pour cette destination.
5. Tester la connexion teste la connexion.

Clique sur Tester la connexion. Le test de connexion écrit un petit fichier dans la Dropbox, le relit et le supprime. Il envoie en plus un fichier de test en trois sections, mesure ainsi le débit d’envoi et vérifie que Dropbox indique, après une réponse perdue, la bonne position pour reprendre. Pour finir, il compare la taille et la somme de contrôle. Il supprime aussi ce fichier.

1. Le résultat du test : la connexion fonctionne, un fichier de test a été écrit, relu et supprimé.
2. La méthode d’envoi et le débit d’envoi mesuré.

Ligne du résultat	Signification
La connexion fonctionne : un fichier de test a été écrit, relu et supprimé.	Écrire, relire et supprimer fonctionnent.
Méthode d’envoi : par sections (upload session) ; un envoi reprend là où il s’est arrêté.	L’extension envoie chaque fichier par sections. Si la réponse à une section se perd, cela ne coûte que cette seule section.
Débit d’envoi mesuré : … par seconde.	Selon le débit, l’extension choisit la taille des sections : de sorte qu’une section et la réponse de Dropbox tiennent dans le reste d’une étape.

Avertissement après un test réussi

Un avertissement figure en jaune sous le résultat. La destination reste malgré tout utilisable.

Avertissement	Signification
Le service n’indique aucune somme de contrôle pour le fichier ; après un envoi, seule la taille est vérifiée.	Après un envoi, l’extension compare la taille, pas la somme de contrôle.

Si le test échoue

Un test échoué nomme la cause, pour certaines causes en dessous la raison plus précise, puis le message d’erreur de Dropbox dans la ligne Message de la destination : … Le message d’erreur n’est pas traduit. L’adresse du compte Dropbox y est remplacée par <user>.

1. La cause en clair, ici : la destination signale qu’il ne reste plus d’espace.
2. Le message d’erreur de Dropbox, non traduit.

Message	Que faire
La destination signale qu’il ne reste plus d’espace.	Libère de l’espace dans ton compte Dropbox et teste à nouveau.
Le compte a refusé l’accès. Le fournisseur n’accepte plus l’accord enregistré. Reconnecte la destination.	Voir la section « Déconnectée et reconnecter ».
Le compte a refusé l’accès. Le fournisseur n’a pas accepté l’accès. Si cela persiste, reconnecte la destination.	Dropbox a refusé l’accès, par exemple parce qu’il a expiré. Teste une nouvelle fois. Si le message persiste, reconnecte la destination.
Le compte n’autorise pas cette requête. L’accord enregistré ne couvre pas cette requête. Reconnecte la destination.	Il manque une autorisation à l’accord. Ouvre la destination pour la modifier et clique sur Reconnecter avec Dropbox.
Le compte n’autorise pas cette requête.	Si aucune raison ne figure en dessous, Dropbox n’autorise pas la requête, par exemple parce que Dropbox a bloqué le compte ou qu’une règle du compte l’interdit. La destination n’est alors pas considérée comme déconnectée, et reconnecter n’aide pas. Éclaircis la cause dans ton compte Dropbox ou avec Dropbox. Ce que Dropbox en dit figure dans la ligne Message de la destination : …
Le service de connexion n’a pas fourni de nouvel accès. Le service de connexion est injoignable.	L’extension n’a pas pu obtenir de nouvel accès. Teste à nouveau plus tard.
La destination a demandé une pause : elle est occupée ou a reçu trop de requêtes.	Teste à nouveau plus tard. Pendant une sauvegarde, l’extension attend elle-même aussi longtemps que Dropbox l’indique, puis réessaie.
Un envoi n’est pas arrivé avant la fin du temps d’une étape : la connexion à la destination est trop lente pour cela. Pour ce service, l’extension découpe un envoi en sections d’au moins 256 Kio, et une telle section doit arriver en une étape.	La connexion entre ton serveur web et Dropbox est trop lente pour la plus petite section.

Déconnectée et reconnecter

Dropbox n’accepte plus un accord si tu as déconnecté l’application dans les réglages de ton compte Dropbox. L’extension marque alors immédiatement la destination comme déconnectée. Les sauvegardes l’ignorent jusqu’à ce que tu la reconnectes.

1. La tuile d’état nomme la destination déconnectée, la cause et la prochaine étape.
2. Reconnecter ouvre le formulaire de la destination déconnectée.
3. Déconnecté figure dans la liste sur la destination. Le point devant est jaune.

Comme cause, la tuile d’état indique : Le fournisseur n’accepte plus l’accord enregistré : il a été retiré ou a expiré. En dessous figure la prochaine étape : Prochaine étape : reconnecte « … ». D’ici là, les sauvegardes ignorent cette destination. Clique sur Reconnecter.

1. Le compte connecté est l’adresse du compte Dropbox dans lequel se trouvent les sauvegardes.
2. La cause figure en jaune : Dropbox n’accepte plus l’accord enregistré.
3. Le bouton Reconnecter avec Dropbox lance la connexion.

Clique sur Reconnecter avec Dropbox et donne ton accord chez Dropbox comme lors de la configuration. La destination, son nom et ses sauvegardes sont conservés.

Lors de la reconnexion, l’extension retire chez Dropbox l’accès que la destination avait jusque-là. Cela vaut aussi si tu reconnectes une destination qui n’est pas déconnectée. Plus de détails dans la section suivante.

Quand l’extension retire l’accès chez Dropbox

L’extension demande à Dropbox de retirer l’accès que détient une destination :

• quand tu retires la destination, sur la page Destinations ou avec WP-CLI,
• quand tu reconnectes la destination : alors l’accès que la destination avait jusque-là, jamais le nouveau,
• quand tu supprimes l’extension dans WordPress et que l’interrupteur de la tuile Désinstallation sur la page Réglages est activé. L’extension retire alors d’abord l’accès de chaque destination de type Dropbox, puis supprime les réglages, les destinations et les journaux. Si l’interrupteur est désactivé, l’extension ne retire rien : les destinations restent dans la base de données pour une nouvelle installation.

Les sauvegardes restent dans tous les cas dans ta Dropbox. Les autres sites que tu as connectés avec le même compte Dropbox ont leur propre accès et restent connectés.

Le retrait ne réussit pas toujours :

• L’extension ne peut pas l’envoyer si elle ne peut plus lire les identifiants enregistrés, par exemple après un changement du mot de passe de la base de données, si la destination était déjà retirée ou si cURL manque.
• Il peut échouer, par exemple si Dropbox ou le service de connexion est injoignable à ce moment-là. L’extension a besoin du service de connexion si l’accès a expiré : elle en obtient alors un nouveau au préalable.
• Lors de la suppression de l’extension, un retrait ne commence que tant que dix secondes ne se sont pas écoulées depuis le premier. Une destination dont le tour viendrait après garde son accès.

La destination est malgré tout retirée ou reconnectée, et la suppression de l’extension se poursuit. L’accès reste alors valable chez Dropbox jusqu’à ce que tu déconnectes l’application dans ton compte Dropbox.

Bon à savoir

• Retirer la destination retire chez Dropbox l’accès que la destination avait. Les sauvegardes restent dans ta Dropbox. Les cas où le retrait n’a pas lieu ou échoue sont décrits dans la section « Quand l’extension retire l’accès chez Dropbox ».
• Espace libre. Dropbox indique l’espace du compte et ce qui en est occupé. Si une sauvegarde n’y tient pas, elle ignore cette destination et va vers les autres destinations du plan. Elle se termine « avec avertissements » et nomme la destination, l’espace nécessaire et l’espace libre. S’il ne reste alors aucune destination à la sauvegarde, la tâche se termine avant d’écrire quoi que ce soit. Dropbox ne compte un envoi qu’une fois terminé : si le compte se remplit entre-temps, l’envoi échoue à sa fin.
• Envois. L’extension choisit la taille d’une section selon le débit d’envoi mesuré, au moins 256 KiB. Un fichier n’apparaît dans Dropbox qu’à la fin de l’envoi, d’un seul coup. S’il y a déjà un fichier de ce nom, la finalisation le remplace ; rien n’est supprimé auparavant. Chaque section porte une somme de contrôle, et Dropbox refuse une section qui arrive altérée. Après l’envoi, l’extension compare la taille et la somme de contrôle chez Dropbox avec le fichier local.
• Étapes courtes. S’il reste moins de 6 secondes dans une étape qui a déjà travaillé, elle ne commence plus de requête vers Dropbox. L’étape suivante continue avec tout son temps.
• Limites de Dropbox. Une requête porte au plus 150 MiB ; l’extension reste bien en dessous. Un envoi qui n’est jamais terminé expire chez Dropbox après sept jours.
• Un dossier n’est retiré par l’extension que si Dropbox le liste comme vide. Sinon, elle ne supprime que des fichiers.
• Pas de téléchargement via l’extension. Les sauvegardes qui ne se trouvent que dans Dropbox, tu les récupères dans Dropbox. La restauration, la vérification et la recherche lisent directement depuis Dropbox.
• L’extension utilise aussi pour ce type de destination un proxy défini dans wp-config.php. Elle ne suit jamais une redirection.
• Sous le choix des types de destination figure la mention : Les noms et logos de tiers appartiennent à leurs propriétaires respectifs. Cela n’implique aucune affiliation ni aucun partenariat.

Voir aussi

• Quelle destination te convient ?
• La page « Destinations »
• Renouveler les identifiants d’une destination
• Stocker les sauvegardes dans Google Drive
• Supprimer une destination
• Vérifier les sauvegardes d’une destination et nettoyer les restes
• Désinstaller l’extension

Sur la ligne de commande

WP-CLI pas encore installé ? Voici comment installer WP-CLI.

Une destination de type Dropbox se crée dans le navigateur, sur la page Destinations : c’est là que tu donnes ton accord chez Dropbox. Reconnecter ne fonctionne aussi que dans le navigateur. Tester, vérifier et retirer fonctionnent aussi avec WP-CLI :

# Afficher les destinations avec identifiant et état
wp cloneworx-backup target list

# Tester la connexion
wp cloneworx-backup target test dropbox-1

# Vérifier les sauvegardes de cette destination
wp cloneworx-backup target check dropbox-1

# Retirer la destination ; les sauvegardes restent dans Dropbox
wp cloneworx-backup target remove dropbox-1