Ga naar inhoud

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.xml

  • Modules 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

Wat is een Hyvä CSP-migratie?

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.

Is de officiële migratietool van Hyvä genoeg?

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.

Hoe lang duurt een Hyvä CSP-migratie?

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.

Hebben we CSP nodig voor PCI DSS 4.0?

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.

Kunnen jullie onze eigen Magento-module CSP-compliant maken?

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.

Moet ik mijn hele Hyvä-thema CSP-compatibel maken?

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.

Wat je krijgt

Een CSP-compliant checkout die dat ook blijft.

Duidelijke inventarisatie

Elk inline script, elke Alpine-expressie en externe bron, gesorteerd op risico.

Strikte CSP, geen omwegen

Geen unsafe-inline of unsafe-eval. Alleen de bronnen die je echt nodig hebt.

Geteste checkout

End-to-end tests die falen op elke CSP-overtreding, bij elke update.

Missing anything?
What are you missing? X
Thank you for your feedback!