Hyvä CSP-migratie
Maak je Hyvä-thema, checkout en modules CSP-compliant, zonder je checkout te breken
Hyvä CSP-migratie, uitgevoerd en getest
Sinds Magento 2.4.7 draait de Content Security Policy op de checkout standaard in restrict mode, en PCI DSS 4.0 vraagt een strikte policy op betaalpagina's. Hyvä Checkout ondersteunt strikte CSP standaard, en Hyvä biedt een CSP-versie van het thema. Het probleem zit in je eigen code: inline JavaScript die jarenlang werkte wordt nu door de browser geblokkeerd, en een betaalmethode, verzendkeuze of eigen component stopt stilletjes met werken op de belangrijkste pagina van je webshop.
Wij migreren Hyvä-thema's, Hyvä Checkout-aanpassingen en Magento-modules naar strikte CSP. We bouwen en onderhouden dagelijks betaal- en verzendintegraties voor Hyvä Checkout, dus we weten waar CSP dingen breekt en hoe je dat oplost zonder functionaliteit te verliezen.
Waarom CSP niet meer optioneel is
PCI DSS 4.0: eisen 6.4.3 en 11.6.1 verplichten je om elk script op betaalpagina's te beheren en te monitoren. Dit is verplicht sinds april 2025.
Magento 2.4.7+: de checkout draait standaard CSP in restrict mode. Onbekende inline scripts en unsafe-eval zijn niet toegestaan.
Hyvä: Hyvä Checkout ondersteunt strikte CSP standaard, en Hyvä biedt een CSP-versie van het thema op basis van de CSP-build van Alpine.js, die geen inline expressies uitvoert. Welke route past hangt af van je webshop: strikte CSP alleen op de checkout, of het hele thema. Maatwerk en modules van derden moeten in beide gevallen gemigreerd worden.
Wat er breekt bij een Hyvä CSP-migratie
Inline Alpine-expressies zoals
x-data="{ open: false }"en@click="open = !open"Inline
<script>-blokken die niet geregistreerd zijn met$hyvaCsp->registerInlineScript()Betaal-SDK's en iframes die laden vanaf domeinen die ontbreken in
csp_whitelist.xmlModules van derden die JavaScript in de checkout injecteren, vaak in code die je niet direct kunt aanpassen
Magewire-componenten in Hyvä Checkout die afhankelijk zijn van inline JavaScript-callbacks
Een typische aanpassing ziet er zo uit. Elke inline expressie wordt een geregistreerd component:
<!-- Before: inline expressions, blocked under strict CSP -->
<div x-data="{ open: false }">
<button @click="open = !open">Toggle</button>
</div>
<!-- After: a registered component, CSP compliant -->
<div x-data="initToggle">
<button @click="toggle">Toggle</button>
</div>
<script>
function initToggle() {
return {
open: false,
toggle() { this.open = !this.open; }
};
}
window.addEventListener('alpine:init', () => Alpine.data('initToggle', initToggle), {once: true});
</script>
<?php $hyvaCsp->registerInlineScript() ?>Hoe wij migreren
1. Inventarisatie: we scannen je thema en modules op inline scripts, inline Alpine-expressies en externe bronnen, en zetten alles wat aangepast moet worden op een rij, gesorteerd op risico.
2. Automatische migratie: we draaien de officiële CSP-migratietool van Hyvä voor de repetitieve aanpassingen.
3. Handmatige fixes: de tool vangt niet alles af. Complexe componenten, Magewire-callbacks, betaal-SDK's en modules van derden lossen we met de hand op, met patches of compatibiliteitsmodules waar de leverancier nog niet zo ver is.
4. Strakke whitelist: we voegen alleen de bronnen toe die je echt nodig hebt, per Magento-area (frontend, admin), in plaats van de policy ruimer te maken.
5. Gecontroleerd met end-to-end tests: we draaien Playwright-tests door de complete checkout met CSP in restrict mode, en laten ze falen op elke CSP-overtreding in de browserconsole. Zo weet je dat het werkt, in plaats van dat je het hoopt.
Waarom Control Alt Delete
Een migratietool draaien kan elk bureau. Wat wij toevoegen is diepgaande checkoutkennis en testen. We bouwen Hyvä Checkout-integraties sinds de lancering in 2023, voor betaalproviders en vervoerders die door duizenden webshops gebruikt worden. Die modules moeten onder strikte CSP werken in elke webshop die ze installeert, dus CSP-compliance is ons dagelijks werk, geen eenmalig project.
En omdat we gespecialiseerd zijn in end-to-end testen, krijg je niet alleen gemigreerde code. Je krijgt een testsuite die je checkout CSP-compliant houdt na elke update. Bekijk ook onze Hyvä Checkout-diensten.
Veelgestelde vragen
Het herschrijven van de JavaScript in je Hyvä-thema, Hyvä Checkout en Magento-modules zodat alles werkt onder een strikte Content Security Policy. Dat betekent vooral inline Alpine.js-expressies vervangen door geregistreerde componenten, inline scripts registreren met de CSP-helper van Hyvä, en alleen de externe bronnen whitelisten die je nodig hebt.
Die doet een groot deel van het repetitieve werk, maar niet alles. Complexe componenten, Magewire-callbacks, betaal-SDK's en modules van derden hebben meestal handmatige fixes nodig. En na de tool moet je nog steeds controleren of de checkout echt werkt.
Dat hangt af van de hoeveelheid maatwerk en modules van derden in je checkout. Na de inventarisatie krijg je een duidelijke lijst van wat er moet veranderen en een inschatting, voordat we beginnen.
PCI DSS 4.0-eisen 6.4.3 en 11.6.1 verplichten je om alle scripts op betaalpagina's te autoriseren, te inventariseren en te monitoren. Een strikte CSP is voor een Magento-webshop de meest praktische manier om daaraan te voldoen.
Ja. Dat doen we voor betaal- en verzendmodules die in veel webshops geïnstalleerd zijn, inclusief compatibiliteit met Luma en Hyvä Checkout, met tests die bij elke release draaien.
Niet altijd. Hyvä ondersteunt drie routes: strikte CSP alleen op de checkout, strikte CSP op de checkout plus betaalknoppen elders die via een redirect werken, of een volledig CSP-compatibel thema met de CSP-build van Alpine.js. Strikte CSP alleen op de checkout is vaak genoeg en vraagt de minste aanpassingen. Heb je buiten de checkout betaalknoppen zoals PayPal Express of Apple Pay, of wil je maximale bescherming, dan is een grotere migratie zinvol. We helpen je de juiste route te kiezen voordat er iets herschreven wordt.
Je Hyvä-webshop of module CSP-compliant maken?
Vertel ons wat er in je checkout draait. Wij inventariseren, migreren en bewijzen met end-to-end tests dat het werkt.
Hyvä Checkout-cases
Briqpay
Hyvä Checkout-compatibiliteitsmodule voor de Zweedse betaalprovider Briqpay: bestaande Magento-betaalflow native naar Hyvä Checkout gebracht, open source in de repository van Briqpay, met end-to-end tests via GitHub Actions.
Colissimo
Open source Magento 2-module die Hyvä Checkout integreert met Colissimo-afhaalpunten. Zoeken via kaart of lijst, Google Places-autocomplete, geolocatie en een hoge kwaliteitslat.
Correos
Integratie van Correos‑afhaalpuntselectie in Hyvä Checkout, met geolocatie en handmatige adresinvoer, inclusief lijst‑ en kaartweergave.
Elorn/P3
Maatwerk Elorn/P3‑creditcardintegratie voor Growlobby en Hyvä Checkout, zonder redirects dankzij iframe‑betalingen met 3D Secure‑authenticatie en tokenization. Gebouwd met minimale documentatie.