Webshop traag? Zie je shop op Hyvä →

Magento-staging inrichten: veilig en bruikbaar

Haimanti Dekker
Haimanti Dekker
20 november 20268 min

Een Magento-staging-omgeving is een kopie van je productieshop waarop je wijzigingen test voordat ze live gaan. Veilig en bruikbaar is die kopie als drie dingen kloppen: de data is actueel genoeg maar bevat geen herkenbare klantgegevens, koppelingen met betaalprovider, ERP en vervoerder staan in testmodus, en zoekmachines en toevallige bezoekers komen er niet in. Hoe die kopie tot stand komt, maakt daarvoor weinig uit. Het kan een kant-en-klare voorziening van je hoster zijn, zoals Hypernode Brancher, dat een tijdelijke exacte kopie van je productieserver maakt op basis van de laatste back-up (hooguit 24 uur oud), of een eigen tweede server naast productie.

Dezelfde instellingen als productie

Magento kan in drie standen draaien, de zogeheten deploy-modes: developer, default en production. Je developer stelt die in met bin/magento deploy:mode:set (Adobe Experience League, CLI-referentie). In developer-mode toont Magento uitgebreide foutmeldingen, handig om een probleem op te sporen; in production-mode is de shop geoptimaliseerd voor snelheid en verbergt hij die details, zoals je live site hoort te draaien. Wil je op staging zien wat er straks live gebeurt, laat hem dan in dezelfde stand draaien als productie. Fouten opsporen doet je developer op een eigen ontwikkelomgeving. Welke hosting een Magento-shop nodig heeft, productie en staging samen, staat in Magento hosting: eisen, soorten en checklist.

Een lege staging zegt bijna niets

Een staging met data van een jaar geleden, zonder actuele voorraad of prijzen, test in feite een andere shop dan die je bezoekers zien. Waarom dat zo is en welke flows je voor elke livegang doorloopt, staat al in Magento testen: wat loont voor een mkb-webshop?. Dit artikel gaat over de omgeving zelf: hoe houd je staging representatief zonder dat er risico’s bijkomen.

Klantdata anonimiseren voordat die naar staging gaat

Testen met echte klantgegevens, bestelhistorie en adressen mag onder de AVG niet zomaar. ICTrecht schrijft dat de wet dit niet letterlijk verbiedt, maar dat de Autoriteit Persoonsgegevens adviseert alleen te testen met fictieve data of gegevens die weinig risico opleveren, en dat echte productiedata in de meeste gevallen niet noodzakelijk is voor een goede test (ICTrecht, Testen met persoonsgegevens, mag dit eigenlijk wel?). Anonimiseren (gegevens onherkenbaar maken) of pseudonimiseren (echte namen en adressen vervangen door verzonnen) is dus geen extraatje, maar de normale manier om staging te vullen.

Technisch is dat met Magento goed te doen. De beheertool n98-magerun2, die veel Magento-developers gebruiken, heeft een db:dump-commando met een --strip-optie. Met de groep @development blijven onder meer klant-, order- en logtabellen leeg in de kopie:

n98-magerun2 db:dump --strip="@development"

Dat levert een werkende database op zonder de meest gevoelige inhoud (n98-magerun2, db:dump-documentatie). Blijven er in andere tabellen nog namen of adressen staan, bijvoorbeeld in een maatwerkmodule, dan is een aanvullende anonimiseringsstap nodig, maar deze strip is een goed startpunt.

Koppelingen: uit, of in testmodus

Een staging die gewoon doorpraat met externe systemen is waar het het vaakst misgaat: een testbestelling die bij een echte koerier terechtkomt, een orderbevestiging in de mailbox van een klant, of een ERP-koppeling die testvoorraad doorzet naar productie.

Bij een betaalprovider zoals Mollie regel je dit met een test-API-key. Een API-key is de sleutel waarmee je shop zich bij de betaalprovider aanmeldt; met de testsleutel komen betalingen in een aparte testomgeving terecht die volledig los staat van de live data, zodat een proefbetaling nooit de echte boekhouding raakt (Mollie, Testing). Welke betaalproviders geschikt zijn voor jouw shop staat in Magento betaalproviders. Een ERP-koppeling zet je bij voorkeur op een testadministratie, of je schakelt de synchronisatie uit zolang je op staging werkt. Verzendkoppelingen zet je in sandbox-modus (de testomgeving van de vervoerder), of je zorgt dat er geen echte verzendlabels worden aangemaakt.

Transactiemail, zoals orderbevestigingen en wachtwoordmails, zet je uit via Stores > Configuration > Advanced > System > Mail Sending Settings > Disable Email Communications (Adobe Experience League, e-mailcommunicatie). Vergeet daarbij de cron niet: dat is de ingebouwde klok van Magento die op vaste tijden taken uitvoert, zoals mail versturen en wachtrijen verwerken. Draait die op staging, dan doet hij precies wat hij op productie ook doet. Hoe cron en message queues samenwerken staat in Magento cron en message queues: als er niets gebeurt.

Koppeling Wat je op staging doet Waar je het regelt
Betaalprovider (bijv. Mollie) Test-API-key gebruiken, los van live transacties Instellingen van de betaalmodule, API-key veld
ERP of voorraadsysteem Koppelen aan een testadministratie, of de sync uitzetten Extensie-configuratie of de bijbehorende cron-taak
Transactiemail Mailverzending uitschakelen Stores > Configuration > Advanced > System > Mail Sending Settings
Verzending en labels Vervoerder in sandbox-modus, of labels niet daadwerkelijk aanmaken Instellingen van de verzendmodule

Let op: instellingen die per omgeving verschillen, zoals een API-key, horen niet in de code die ook naar productie gaat. Je developer zet zulke waarden vast met bin/magento config:set --lock-env; dat schrijft de waarde naar app/etc/env.php, een bestand dat buiten versiebeheer blijft en dus per omgeving anders kan zijn. Gebruikt hij in plaats daarvan --lock-config, dan komt de waarde in app/etc/config.php terecht, en dat bestand reist wél met de code mee naar elke omgeving, ook productie (Adobe Experience League, configuratiewaarden instellen). Een test-API-key die zo per ongeluk op de live shop terechtkomt, betekent dat echte klanten niet kunnen betalen.

Houd Google buiten de deur

Een staging die vrij bereikbaar is op een eigen subdomein, kan door Google worden gecrawld en geïndexeerd. Dan staat er een kopie van je shop in de zoekresultaten die concurreert met de echte site. De gebruikelijke reflex is een noindex-tag, een regel in de pagina die zoekmachines vraagt de pagina niet op te nemen. Dat is geen afdoende oplossing. Google moet een pagina eerst kunnen crawlen om die tag te lezen; staat tegelijk in robots.txt dat Google niet mag crawlen, een combinatie die op staging vaak voorkomt, dan ziet Google de noindex-regel nooit en kan de pagina alsnog in de zoekresultaten verschijnen (Google Search Central, pagina’s blokkeren voor indexering). Bovendien houdt een noindex-tag alleen zoekmachines tegen, niet een concurrent of een klant die het adres raadt.

Een wachtwoord op de hele omgeving (basic auth) of een IP-allowlist, waarbij alleen vooraf opgegeven internetadressen van jouw kantoor en je bureau toegang krijgen, werkt wel: crawlers en toevallige bezoekers komen dan simpelweg niet binnen.

Wie ververst staging, en hoe vaak?

Een staging die maanden niet is bijgewerkt, test tegen verouderde prijzen, oude voorraad en kortingsregels die op productie al lang zijn aangepast. Dat is geen ramp zolang je het weet, maar het wordt een probleem zodra je testresultaten voor waar aanneemt terwijl de omgeving achterloopt.

Spreek daarom met je bureau of hoster af wie staging verfrist en bij welke aanleiding: voor elke release, elke maand, of op aanvraag. Een voorziening zoals Hypernode Brancher maakt het verversen zelf eenvoudig, omdat je telkens een nieuwe wegwerpkopie van productie maakt. Zo’n kopie bevat wel gewoon alle klant- en orderdata van productie, dus het anonimiseren moet daarna nog gebeuren. De afspraak over wanneer dat gebeurt en wie daarbij de data anonimiseert, ligt nog steeds bij jullie samen.

Het Linted-team overlegt aan een bureau
Wie staging verfrist en hoe vaak: een vaste afspraak voorkomt dat je tegen verouderde prijzen en voorraad test.

Vragen om te stellen aan je bureau of hoster

Een paar vragen volstaan om te checken of staging goed is ingericht: wordt klantdata geanonimiseerd of gepseudonimiseerd voordat die op staging terechtkomt, staan alle externe koppelingen in test- of sandbox-modus, en is de omgeving afgeschermd met een wachtwoord of IP-allowlist in plaats van alleen een noindex-tag? Krijg je op een van deze drie geen duidelijk antwoord, dan weet je waar het gesprek over moet gaan.

Staging als vast onderdeel van onderhoud

Staging goed inrichten is geen eenmalige actie: koppelingen veranderen, API-keys verlopen en de afspraak over verversen verwatert zonder dat iemand het oppakt. Dat hoort daarom bij doorlopend Magento onderhoud. Twijfel je of je huidige staging nog klopt met wat hierboven staat, laat dat dan nakijken via een Magento code review, of neem contact op als je eerst wilt sparren over hoe staging bij jullie is geregeld.

Veelgestelde vragen

Mag ik productiedata zomaar op staging gebruiken?

Nee, in beginsel niet zonder aanpassing. Testen met onbewerkte klant- en orderdata is onder de AVG alleen verdedigbaar als dat echt noodzakelijk is, en dat is in de praktijk bijna nooit het geval. Anonimiseer of pseudonimiseer een databasekopie voordat die naar staging gaat, bijvoorbeeld met de strip-optie van n98-magerun2.

Voorkomt een noindex-tag dat Google mijn staging indexeert?

Niet gegarandeerd. Google moet een pagina kunnen crawlen om een noindex-tag te lezen; blokkeert robots.txt dat crawlen, dan ziet Google de tag nooit en kan de pagina alsnog in de zoekresultaten verschijnen. Een wachtwoord of IP-allowlist werkt wel, omdat dat zowel crawlers als bezoekers al bij de voordeur tegenhoudt.

Wat is het verschil tussen –lock-env en –lock-config?

Het verschil zit in het bestand waar de instelling in terechtkomt. --lock-env schrijft naar app/etc/env.php, dat niet in versiebeheer staat en dus per omgeving kan verschillen. --lock-config schrijft naar app/etc/config.php, dat wel meegaat met de code naar elke omgeving, productie inclusief. Omgevingsspecifieke waarden zoals een API-key horen daarom bij --lock-env.

Hoe vaak moet staging worden bijgewerkt met nieuwe productiedata?

Dat hangt af van de afspraak met je bureau of hoster, maar zonder afspraak loop je het risico om tegen verouderde prijzen, voorraad en regels te testen. Leg vast wie staging verfrist en bij welke aanleiding, bijvoorbeeld voor elke release, zodat niemand een verouderde staging voor representatief aanneemt.

Meer lezen?

Bekijk al onze artikelen over e-commerce en development.