Back-ups opslaan in Dropbox – cloneworx Hulp

Zo stel je jouw Dropbox in als doel voor je back-ups. Een wachtwoord vul je daarbij niet in: je meldt je aan bij Dropbox, geeft daar toestemming en komt terug op de pagina “Doelen”.

Dit heb je nodig

een Dropbox-account met genoeg vrije ruimte voor je back-ups,
een website waarvan het beheer via https:// bereikbaar is,
de PHP-extensie cURL met https op de webserver.

Ontbreekt cURL op de webserver, dan is Dropbox in de keuze van de doeltypen grijs en draagt het label Niet beschikbaar op deze server.

Stap 1: doeltype kiezen

Open de pagina Doelen en klik op Doel toevoegen. Kies Dropbox.

Formulier voor een doel van het type Dropbox vóór het verbinden

Naam is vrij te kiezen. De plugin stelt “Dropbox 1” voor; elke naam werkt die nog niet in gebruik is.
De opmerking over de aanmelding zegt dat je naar Dropbox wordt doorgestuurd en daarna op deze pagina terugkomt, en dat de dienst auth.cloneworx.de de aanmelding bemiddelt.
De opmerking van het doeltype zegt dat de plugin in jouw Dropbox een eigen map onder “Apps” krijgt en verder niets ziet, en dat verwijderde back-ups in Dropbox nog een tijd lang kunnen worden hersteld.
De knop Verbinden met Dropbox begint de aanmelding.

Het formulier heeft geen veld voor een wachtwoord, geen veld voor een map en geen knop Verbinding testen: een doel van het type Dropbox ontstaat pas met de aanmelding, en zijn locatie is de map die Dropbox voor de app bijhoudt.

Stap 2: verbinden met Dropbox

Klik op Verbinden met Dropbox. Je browser verlaat de pagina Doelen:

Meld je aan bij Dropbox en geef toestemming.
Daarna toont de dienst auth.cloneworx.de een pagina die de website noemt waaraan de toegang wordt overgedragen. Ga alleen verder als dat jouw website is.
Je browser komt terug op de pagina Doelen. Daar staat kort Aanmelding wordt afgerond …

De plugin slaat het doel op, test de verbinding meteen en meldt het resultaat: “…” opgeslagen en verbonden. Opslaan hoef je niet meer.

De pagina Doelen na de terugkeer van Dropbox met het nieuwe doel

Alle doelen zijn verbonden.
De melding noemt het doel: opgeslagen en verbonden.
Het nieuwe doel staat in de lijst. De groene stip betekent: verbonden.
De locatie van het doel is het adres van het verbonden Dropbox-account.

Een begonnen aanmelding is 15 minuten geldig. Plannen en back-ups gebruiken een doel pas na een geslaagde verbindingstest.

Vindt de plugin in jouw Dropbox back-ups die niet in jouw lijst staan, dan verschijnt de tegel Back-ups gevonden op „…”. Meer daarover: Back-ups terugvinden na totaal verlies.

Stap 3: het doel in het back-upplan kiezen

Je eerste doel: de plugin maakt het plan “Dagelijkse back-up” aan: dagelijks op een willekeurig tijdstip, alles, dit doel, Max. back-ups 7. Het plan is gepauzeerd tot je het inschakelt.
Een verder doel: kies het op de pagina Back-up in de tegel Back-upplannen in een plan. De gratis versie staat twee plannen en één doel per plan toe.

Meer daarover: Back-ups automatisch inplannen.

Als de aanmelding niet lukt

Kom je zonder toegang van Dropbox terug, dan ontstaat er geen doel. De pagina Doelen meldt de reden, en het formulier opent zich weer met jouw gegevens.

De pagina Doelen na de terugkeer van Dropbox zonder toegang

De melding zegt: Dropbox meldt dat de toegang niet is verleend. Er is niets verbonden.
Het formulier is weer open, met jouw gegevens.
De knop Verbinden met Dropbox begint de aanmelding opnieuw.

Melding	Wat te doen
Verbinden vereist https: het adres van het beheer van deze website begint niet met https.	De melding staat in het formulier, voordat de browser de pagina verlaat. De aanmeldservice draagt een toegang alleen over aan een website waarvan het beheer via https:// bereikbaar is. Zet de website over op https.
De aanmelding is geannuleerd. Er is niets verbonden.	Dat is een mededeling, geen fout. Klik nog een keer op Verbinden met Dropbox als je het doel wilt instellen.
… meldt dat de toegang niet is verleend. Er is niets verbonden.	Begin de aanmelding opnieuw en geef bij Dropbox toestemming.
… heeft niet alle rechten verleend die de back-up nodig heeft. Er is niets verbonden.	De plugin heeft alle vier de rechten nodig, zie de paragraaf “Wat de plugin in Dropbox mag zien”. Begin de aanmelding opnieuw.
Deze aanmelding is onbekend of verlopen. Verbind opnieuw.	Het formulier opent zich hier niet opnieuw. Klik op Doel toevoegen en begin opnieuw.
De aanmelding duurde te lang of is al gebruikt. Verbind opnieuw.	Begin de aanmelding opnieuw.
De aanmeldservice is op dit moment niet bereikbaar. Probeer het later opnieuw.	Probeer het later opnieuw. Onder de melding leidt Logboek tonen naar het algemene logboek.
… is op dit moment niet bereikbaar of meldt een fout. Probeer het later opnieuw.	De melding noemt Dropbox. Probeer het later opnieuw. Ook hier leidt Logboek tonen naar het algemene logboek.
De aanmelding is gelukt, maar de eerste toegang tot het account is mislukt: …	Achter de dubbele punt staat de reden. Begin de aanmelding opnieuw als die is verholpen.

Wat de plugin in Dropbox mag zien

De app heeft bij Dropbox het toegangstype “App folder”: de plugin ziet in jouw Dropbox zijn eigen map onder “Apps” en verder niets. De naam van die map bepaalt Dropbox. Elk ander bestand in jouw Dropbox ziet de plugin niet.

De plugin vraagt Dropbox om vier rechten:

Recht	Waarvoor
`account_info.read`	het adres en de ruimte van het account lezen
`files.metadata.read`	de bestanden in zijn map weergeven
`files.content.read`	de bestanden in zijn map lezen
`files.content.write`	bestanden in zijn map schrijven

De back-ups staan in jouw Dropbox onder Apps/<naam van de app>/cloneworx-backup-<code>/<back-up>/. Opbouw en bestanden van een back-up zijn dezelfde als op elk ander doel.

De aanmeldservice auth.cloneworx.de

Dropbox vereist voor de aanmelding een geheim. Een geheim kan niet in een plugin staan waarvan iedereen de code kan lezen. Het ligt daarom bij een kleine dienst van cloneworx, auth.cloneworx.de, die de aanmelding bemiddelt.

Wie verstuurt	Wat de dienst te weten komt
Je browser, als je op Verbinden met Dropbox klikt	het adres van de beheerpagina van je website, een willekeurige waarde en de taal
Je webserver, na de terugkeer	de code van de aanmelding. De dienst geeft de aanmelding door aan Dropbox.
Je webserver, zolang het doel wordt gebruikt	de opgeslagen duurzame toegang, telkens als een nieuwe toegang nodig is: om de paar uur

Daar komen, zoals bij elk verzoek, de IP-adressen van browser en webserver bij. De dienst slaat niets op. Hij ontvangt nooit een back-up, nooit een bestand en nooit het adres van jouw Dropbox-account.

Bij het doel staan twee waarden, versleuteld zoals elk wachtwoord van een doel: de duurzame toegang en de toegang die enkele uren geldig is. Het adres van het verbonden Dropbox-account staat zichtbaar bij het doel. In het logboek en in het supportrapport staat het nooit.

De velden van de weergave Uitgebreid

Formulier voor Dropbox in de weergave Uitgebreid

Tijdslimiet voor de verbinding (seconden) neemt 3 tot 60, de standaard is 10.
Uploadsnelheid (bytes per seconde) mag leeg blijven: dan geldt wat de verbindingstest heeft gemeten. Op basis daarvan kiest de plugin de grootte van de secties van een upload.

Een veld voor een map is er ook in de weergave Uitgebreid niet.

Het doel bewerken en testen

Klik in de regel van het doel op Meer …, dan op Bewerken.

Formulier voor het bewerken van een doel van het type Dropbox

Naam is de naam van het doel in lijsten en meldingen.
Het verbonden account is het adres van het Dropbox-account waarin de back-ups staan.
Opslaan slaat je wijzigingen op.
De knop Opnieuw verbinden met Dropbox begint de aanmelding voor dit doel opnieuw.
Verbinding testen test de verbinding.

Klik op Verbinding testen. De verbindingstest schrijft een klein bestand in de Dropbox, leest het terug en verwijdert het weer. Daarnaast uploadt hij een testbestand in drie secties, meet daarbij de uploadsnelheid en controleert of Dropbox na een verloren antwoord de juiste positie noemt om voort te zetten. Tot slot vergelijkt hij grootte en controlesom. Ook dit bestand verwijdert hij weer.

Formulier voor Dropbox na een geslaagde verbindingstest

Het resultaat van de test: de verbinding werkt, een testbestand is geschreven, teruggelezen en verwijderd.
De uploadmethode en de gemeten uploadsnelheid.

Regel in het resultaat	Betekenis
De verbinding werkt: een testbestand is geschreven, teruggelezen en verwijderd.	Schrijven, teruglezen en verwijderen werken.
Uploadmethode: in secties (upload session); een upload gaat verder waar hij is gestopt.	De plugin uploadt elk bestand in secties. Gaat het antwoord op een sectie verloren, dan kost dat alleen die ene sectie.
Gemeten uploadsnelheid: … per seconde.	Op basis van de snelheid kiest de plugin de grootte van de secties: zo dat een sectie en het antwoord van Dropbox in de rest van een stap passen.

Waarschuwing na een geslaagde test

Een waarschuwing staat in geel onder het resultaat. Het doel is toch bruikbaar.

Waarschuwing	Betekenis
De dienst noemt geen controlesom voor het bestand; na een upload wordt alleen de grootte gecontroleerd.	De plugin vergelijkt na een upload de grootte, niet de controlesom.

Als de test mislukt

Een mislukte test noemt de oorzaak, bij sommige oorzaken daaronder de reden preciezer, en dan de foutmelding van Dropbox in de regel Melding van het doel: … De foutmelding is niet vertaald. Het adres van het Dropbox-account is erin vervangen door <user>.

Formulier voor Dropbox na een mislukte verbindingstest

De oorzaak in gewone taal, hier: het doel meldt dat er geen ruimte meer is.
De foutmelding van Dropbox, niet vertaald.

Melding	Wat te doen
Het doel meldt dat er geen ruimte meer is.	Maak ruimte vrij in je Dropbox-account en test opnieuw.
Het account heeft de toegang geweigerd. De aanbieder accepteert de opgeslagen toestemming niet meer. Verbind het doel opnieuw.	Zie de paragraaf “Losgekoppeld en opnieuw verbinden”.
Het account heeft de toegang geweigerd. De aanbieder heeft de toegang niet geaccepteerd. Blijft dat zo, verbind het doel dan opnieuw.	Dropbox heeft de toegang geweigerd, bijvoorbeeld omdat die is verlopen. Test nog een keer. Blijft de melding, verbind het doel dan opnieuw.
Het account staat dit verzoek niet toe. De opgeslagen toestemming dekt dit verzoek niet. Verbind het doel opnieuw.	De toestemming mist een recht. Open het doel om te bewerken en klik op Opnieuw verbinden met Dropbox.
Het account staat dit verzoek niet toe.	Staat daaronder geen reden, dan staat Dropbox het verzoek niet toe, bijvoorbeeld omdat Dropbox het account heeft geblokkeerd of een regel van het account het verbiedt. Het doel geldt daarbij niet als losgekoppeld, en opnieuw verbinden helpt niet. Zoek de oorzaak uit in je Dropbox-account of met Dropbox. Wat Dropbox erover zegt, noemt de regel Melding van het doel: …
De aanmeldservice heeft geen nieuwe toegang geleverd. De aanmeldservice is niet bereikbaar.	De plugin kon geen nieuwe toegang ophalen. Test later opnieuw.
Het doel vroeg om een pauze: het is bezet of kreeg te veel verzoeken.	Test later opnieuw. In een back-up wacht de plugin zelf zo lang als Dropbox noemt en probeert het daarna opnieuw.
Een upload kwam niet aan voordat de tijd van een stap om was: de verbinding met het doel is daarvoor te langzaam. De plugin stuurt een upload naar deze dienst in secties van minstens 256 KiB, en zo’n sectie moet binnen één stap aankomen.	De verbinding tussen jouw webserver en Dropbox is voor de kleinste sectie te langzaam.

Losgekoppeld en opnieuw verbinden

Dropbox accepteert een toestemming niet meer als je de app in de instellingen van je Dropbox-account hebt losgekoppeld. De plugin markeert het doel dan meteen als losgekoppeld. Back-ups slaan het over tot je het opnieuw verbindt.

Statustegel en lijst van de pagina Doelen met een losgekoppeld doel van het type Dropbox

De statustegel noemt het losgekoppelde doel, de oorzaak en de volgende stap.
Opnieuw verbinden opent het formulier van het losgekoppelde doel.
Losgekoppeld staat in de lijst bij het doel. De stip ervoor is geel.

Als oorzaak noemt de statustegel: De aanbieder accepteert de opgeslagen toestemming niet meer: die is ingetrokken of verlopen. Daaronder staat de volgende stap: Volgende stap: verbind “…” opnieuw. Tot dan slaan back-ups dit doel over. Klik op Opnieuw verbinden.

Formulier van een losgekoppeld doel van het type Dropbox

Het verbonden account is het adres van het Dropbox-account waarin de back-ups staan.
De oorzaak staat in geel: Dropbox accepteert de opgeslagen toestemming niet meer.
De knop Opnieuw verbinden met Dropbox begint de aanmelding.

Klik op Opnieuw verbinden met Dropbox en geef bij Dropbox toestemming zoals bij het instellen. Het doel, zijn naam en zijn back-ups blijven bewaard.

Met het opnieuw verbinden trekt de plugin bij Dropbox de toegang in die het doel tot dan had. Dat geldt ook als je een doel opnieuw verbindt dat niet is losgekoppeld. Meer daarover in de volgende paragraaf.

Wanneer de plugin de toegang bij Dropbox intrekt

De plugin vraagt Dropbox om de toegang in te trekken die een doel heeft:

als je het doel verwijdert, op de pagina Doelen of met WP-CLI,
als je het doel opnieuw verbindt: dan de toegang die het doel tot dan had, nooit de nieuwe,
als je de plugin in WordPress verwijdert en de schakelaar in de tegel Verwijderen op de pagina Instellingen aan staat. Dan trekt de plugin eerst de toegang van elk doel van het type Dropbox in en verwijdert daarna instellingen, doelen en logboeken. Staat de schakelaar uit, dan trekt de plugin niets in: de doelen blijven voor een nieuwe installatie in de database.

De back-ups blijven in elk geval in jouw Dropbox. Andere websites die je met hetzelfde Dropbox-account hebt verbonden, hebben een eigen toegang en blijven verbonden.

Het intrekken lukt niet altijd:

De plugin kan het niet versturen als hij de opgeslagen inloggegevens niet meer kan lezen, bijvoorbeeld na een gewijzigd databasewachtwoord, als het doel al was verwijderd of als cURL ontbreekt.
Het kan mislukken, bijvoorbeeld als Dropbox of de aanmeldservice op dat moment niet bereikbaar is. De aanmeldservice heeft de plugin nodig als de toegang is verlopen: dan haalt hij vooraf een nieuwe op.
Bij het verwijderen van de plugin begint een intrekking alleen zolang er sinds de eerste geen tien seconden zijn verstreken. Een doel dat daarna nog aan de beurt zou zijn, behoudt zijn toegang.

Het doel wordt toch verwijderd of opnieuw verbonden, en het verwijderen van de plugin gaat door. De toegang blijft dan bij Dropbox geldig tot je de app in je Dropbox-account loskoppelt.

Goed om te weten

Verwijderde back-ups blijven in Dropbox een tijd lang herstelbaar

Een back-up die de plugin in Dropbox verwijdert, kan in Dropbox nog een tijd lang worden hersteld: 30 dagen of langer, afhankelijk van het abonnement van je account. Definitief verwijderen doet de plugin in Dropbox niet.

Het doel verwijderen trekt bij Dropbox de toegang in die het doel had. De back-ups blijven in jouw Dropbox. Wanneer het intrekken uitblijft of mislukt, staat in de paragraaf “Wanneer de plugin de toegang bij Dropbox intrekt”.
Vrije ruimte. Dropbox noemt de ruimte van het account en wat daarvan in gebruik is. Past een back-up daar niet in, dan slaat die dit doel over en gaat naar de andere doelen van het plan. Hij eindigt “met waarschuwingen” en noemt het doel, de benodigde en de vrije ruimte. Blijft er voor de back-up daarbij geen doel over, dan eindigt de taak voordat hij iets schrijft. Dropbox telt een upload pas mee als die is afgerond: loopt het account tussendoor vol, dan mislukt de upload aan het einde.
Uploads. De plugin kiest de grootte van een sectie op basis van de gemeten uploadsnelheid, minstens 256 KiB. Een bestand verschijnt in Dropbox pas met het afronden van de upload, in één keer. Staat daar al een bestand met die naam, dan vervangt het afronden het; vooraf wordt niets verwijderd. Elke sectie draagt een controlesom, en Dropbox weigert een sectie die gewijzigd aankomt. Na de upload vergelijkt de plugin grootte en controlesom bij Dropbox met het lokale bestand.
Korte stappen. Blijven er in een stap die al heeft gewerkt minder dan 6 seconden over, dan begint hij geen verzoek aan Dropbox meer. De volgende stap gaat met zijn volle tijd verder.
Grenzen van Dropbox. Een verzoek bevat hoogstens 150 MiB; de plugin blijft daar ruim onder. Een upload die nooit wordt afgerond, vervalt bij Dropbox na zeven dagen.
Een map verwijdert de plugin alleen als Dropbox die als leeg weergeeft. Anders verwijdert hij alleen bestanden.
Geen download via de plugin. Back-ups die alleen in Dropbox staan, haal je op in Dropbox. Herstel, controle en terugvinden lezen rechtstreeks uit Dropbox.
Een proxy uit de wp-config.php gebruikt de plugin ook voor dit doeltype. Een doorverwijzing volgt hij nooit.
Onder de keuze van de doeltypen staat de opmerking: Namen en logo’s van derden zijn eigendom van hun respectieve eigenaren. Dit impliceert geen verbondenheid of partnerschap.

Zie ook

Op de opdrachtregel

WP-CLI nog niet ingesteld? Zo installeer je WP-CLI.

Een doel van het type Dropbox maak je aan in de browser, op de pagina Doelen: de toestemming bij Dropbox geef je daar. Ook opnieuw verbinden kan alleen in de browser. Testen, controleren en verwijderen kunnen ook met WP-CLI:

# Doelen met kenmerk en status tonen
wp cloneworx-backup target list

# De verbinding testen
wp cloneworx-backup target test dropbox-1

# De back-ups op dit doel controleren
wp cloneworx-backup target check dropbox-1

# Het doel verwijderen; de back-ups in Dropbox blijven
wp cloneworx-backup target remove dropbox-1