Justflows 0.4.1: zichtbaarheid van content, back-ups die je terugzet en een sterkere beveiligingsbasis
Beperk content tot rollen, gebruikers of pluginregels, maak een back-up van elke site of subsite en zet die terug, en krijg een Security Center dat ondertekende advisories controleert, back-ups aantoont en je waarschuwt bij belangrijke gebeurtenissen. Plus Stripe in Shop, lichtere pagina's en nieuwe SDK-hooks.

Justflows 0.4.1 is uit. Drie thema's lopen erdoorheen: bepalen wie welke content mag zien, van een site iets maken waarvan je een back-up maakt en die je ook echt terugzet, en de beveiligingsbasis van het hele project omhoog brengen. Daarnaast kreeg Shop volledige Stripe-ondersteuning, werden openbare pagina's en de admin flink lichter, en kregen pluginontwikkelaars een reeks nieuwe SDK-hooks.
Zichtbaarheid van content: bepaal wie wat ziet
Een contenttype kan nu een standaardregel voor zichtbaarheid hebben, en een item kan die voor al zijn vertalingen overschrijven. Een regel staat toe of weigert op rol, op specifieke gebruiker of op een regel die een plugin registreert. Met Toegang controleren zie je welke regel voor een bezoeker de doorslag gaf.
Een verborgen item is overal tegelijk verborgen: het antwoordt met 404 en staat niet in lijsten, totalen, zoekresultaten, menu's, sitemaps, feeds en exports. Pagina's met een regel worden nooit gecachet of statisch geëxporteerd. Ontbreekt een regel, faalt hij of geeft hij een ongeldig antwoord, dan is het antwoord nee. Let op: bestanden in een verborgen item blijven bereikbaar via hun directe URL.
We schreven een apart bericht over hoe dit werkt, inclusief content alleen voor abonnees met Shop: Zichtbaarheid van content: content alleen voor leden en abonnees in Justflows.
Back-ups die je ook terugzet
Via Admin → Tools maak, valideer en herstel je nu een draagbare back-up van je site. De back-up draait als taak met voortgang die je kunt annuleren, en levert database-onafhankelijke JSON op met een geversioneerd manifest en een SHA-256-integriteitscontrole. Erin zitten je content en ontwerpinstellingen, de lijst met plugins en thema's, en de originele media uit lokale of S3-opslag. Ontbreekt er media, dan stopt het maken in plaats van dat je een onvolledige back-up krijgt.
- Veilig terugzetten. Herstellen gebeurt in een schone doelsite, houdt de beheerder en geheimen van die site, en draait database- en bestandswijzigingen terug als er iets misgaat.
- Elke site apart. De hoofdinstallatie maakt een back-up van de hoofdsite, of een apart bestand voor elke subsite in de workspace, elk gelezen via de eigen database zonder grenzen tussen tenants te overschrijden. Een bestand zet je terug in de gekozen site zonder de andere aan te raken.
- Buiten de deur bewaren. Back-uptaken sturen archieven naar FTP/FTPS, e-mail of een externe S3-compatibele bucket. Inloggegevens voor die bestemmingen worden versleuteld opgeslagen, nooit naar de browser teruggestuurd en nooit in een archief opgenomen. E-mailbijlagen zijn beperkt tot 10 MB; grotere back-ups gaan via download, FTP of S3.
- Bewijs, geen vinkje. De back-upcontrole in het Security Center kijkt nu naar de automatische back-ups en waarschuwt bij een mislukt of vastgelopen schema. Alleen een gemaakte back-up telt nooit als geslaagd.
Een sterkere beveiligingsbasis
Deze release pakt beveiliging aan van dreigingsmodel tot releaseproces.
- Plugin-updates krijgen niet stilletjes meer rechten. Voegt een update rechten toe, dan tonen uploaden, installeren via de Marketplace en handmatig updaten die nieuwe rechten en stoppen ze tot een beheerder akkoord geeft. Goedkeuringen komen in het auditlog, en automatische updates wachten op een handmatige update.
- Geen stille downgrades. Handmatige en automatische Marketplace-updates weigeren een gelijke of oudere versie voordat er iets wordt gedownload.
- Ondertekende security advisories. Het Security Center controleert je geïnstalleerde versies tegen een advisoryfeed die wordt geverifieerd met de vastgepinde releasesleutel. Een gemanipuleerde, herhaalde, verlopen of onbereikbare feed toont als onbekend, nooit als in orde, en een teruggetrokken versie toont als fout met een herstelpad dat je data behoudt.
- Beveiligingsgebeurtenissen waar je iets mee kunt. Een gericht overzicht van gebeurtenissen rond inloggen, MFA, sessies, API-sleutels, rechten, extensies, updates en configuratie; optionele, geanonimiseerde e-mailmeldingen (hooguit tien per site per uur); en exporteren, bewaartermijnen en verwijderen met begrensde opslag per site.
- Sitegrenzen houden stand. Een gebruiker van een andere site lezen, wijzigen of verwijderen geeft 'niet gevonden', en het Security Center van een subsite toont alleen controles die bij die site horen.
- Proxy's vertrouwen op naam, niet op positie.
TRUST_PROXYaccepteertfalse, benoemde bereiken of expliciete adressen en subnetten. Onder Upgraden lees je wat er met bestaande waarden gebeurt. - Een manifest van corebestanden in elke ondertekende release. Het archief somt de bestanden op die een update vervangt, zodat een update ze na het kopiëren kan controleren.
- CI bewaakt de release. Beveiligingstests draaien tegen echte PostgreSQL- en MySQL-databases, een gecommit wachtwoord of sleutel laat de build falen, en het verpakken stopt als de SBOM ontbreekt, een andere versie beschrijft of een directe afhankelijkheid mist.
De documentatie groeide mee: een dreigingsmodel, een handleiding voor incidentrespons, een runbook voor beveiligingsreleases, een referentie voor vertrouwen in extensies en reviewvereisten, beveiligingsrichtlijnen voor zelf hosten met Docker, nginx, Apache/LiteSpeed, Passenger en kale Node, en een leverancier-neutrale handleiding voor een CDN of WAF voor Justflows.
SECURITY.md noemt nu de ondersteunde versies en hoe meldingen worden behandeld.Stripe in Shop
Shop ondersteunt Stripe nu volledig: Payment Element of gehoste en ingebedde Stripe Checkout, Payment Links, Apple Pay, Google Pay en Link, regionale en uitgestelde methoden zoals SEPA-incasso, opgeslagen betaalmethoden, abonnementen via Stripe Billing, en terugbetalingen, chargebacks en Radar-signalen. Shop registreert en beheert de webhook-endpoints zelf, en mislukte leveringen speel je opnieuw af vanuit de admin.
De volledige rondleiding staat in Stripe in Justflows Shop: afrekenen, wallets, abonnementen en chargebacks.
Lichtere pagina's en een snellere admin
- Openbare pagina's laden alleen de scripts die ze gebruiken. Scripts voor menu, meldingen, inloggen, animaties en interactieve blokken laden alleen als een pagina die markup bevat, dus een gewone pagina laadt 1 KB corescript in plaats van 8 KB. De menu- en meldingsscripts houden de eerste weergave niet meer op.
- Browsers bewaren wat ze downloadden. Corescripts,
theme.cssentheme.jsgebruiken URL's met een inhoudsversie, dus een herhaald bezoek doet daarvoor geen controleverzoeken.theme.jsvalt weg als een thema geen scripts heeft. - De admin laadt per scherm. Het dashboard openen downloadt nu ongeveer 154 KB gecomprimeerd JavaScript in plaats van 546 KB, in 5 verzoeken in plaats van 10. De paginabouwer, wiskundige formules en animaties laden alleen met de schermen die ze gebruiken.
Plugin-SDK: wat pluginontwikkelaars krijgen
SDK 0.1.8 voegt toe:
- Zichtbaarheidsregels.
ctx.visibility.registerRulevoegt je eigen regeltype toe naast rollen en gebruikers. - Assets per blok.
assets.blockskoppelt je bloktypen aan scripts en stylesheets die alleen laden op pagina's die dat blok tonen, enassets.markupdoet hetzelfde voor pagina's met bepaalde markup. Thema's krijgenassets.blocksvoor elk bloktype injustflows-theme.json. - Een eigen sectie in de zijbalk. Menu-items met
domain: "plugin"krijgen een sectie voor je plugin, met naam en icoon viaadminSection. - Meer plekken voor je admin-app.
workspacePanelsvoegt een kaart toe aan Platform → Workspace, eeneditorPanels-item metappsluit een scherm in de contenteditor in, enbridge.setLayout("fill")geeft je scherm het hele contentgebied. - Netwerkfuncties. Een websiteflag
<plugin-id>.enabledgeeft je plugin een aan/uit-schakelaar in de lijst Functies van een website, enctx.network.mainSiteSecretslaat een subsite de verbinding lezen (niet schrijven) die de hoofdsite opsloeg. - Een
comments.created-actie voor nieuwe reacties die in afwachting of goedgekeurd zijn, met alleen id's en status.
Een eigen zichtbaarheidsregel ziet er zo uit (uit de voorbeeldplugin hello-world):
ctx.visibility.registerRule({
id: "team-member",
label: "Team members",
scope: "viewer",
fields: [{ name: "team", label: "Team", type: "select", required: true, options: [/* … */] }],
evaluate({ viewer, params }) {
if (!viewer.authenticated) return { effect: "deny", reason: "sign_in_required" };
return viewer.roles.includes(String(params.team))
? { effect: "allow", reason: "team_member" }
: { effect: "deny", reason: "not_on_team" };
},
});
De core zette ook weer een stap terug uit pluginterrein: de zijbalkgroepen Helpdesk en Gedeelde bestanden zitten niet meer in de core, een plugin brengt nu zijn eigen sectie mee. Een menudomein dat de host niet kent, valt terug op Extensies in plaats van de activatie te stoppen.
Fixes die je wilt kennen
- Plugins installeren en updaten werkt weer op een release-installatie. De gebundelde server vond zijn archiefworker niet, waardoor elke
.jfpkg-installatie of -update stopte met "Archive processing failed". - Vertalingen houden de datums van hun item. Elke taal van een item toont nu dezelfde aanmaak- en publicatiedatum in lijsten, feeds en op de pagina.
- Instellingen voor platformaanmeldingen houden de aparte database. Opslaan in Admin → Platform kon nieuwe aanmeldingen naar de installatiedatabase verplaatsen.
- Een nieuwe Stripe-poging hergebruikt de mislukte bestelling in plaats van een dubbele aan te maken.
Upgraden
- Eén databasemigratie:
0052_translation_group_datesgeeft bestaande vertalingen de datums van hun groep en laatupdated_atongemoeid. Ze draait automatisch. TRUST_PROXY: een site die nog optrueof een aantal hops staat, start oploopback, logt een waarschuwing en blijft draaien, dus de update haalt hem nooit offline. Draait je reverse proxy op een andere machine, stel dan het adres in, anders lijkt elke bezoeker die proxy.- Plugin-updates die rechten toevoegen wachten nu op je akkoord, ook automatische.
- Shop: de Stripe-functies komen met Shop 0.3.2 uit de Marketplace.
De release-zip heeft een SHA-256-checksum, een handtekening en een CycloneDX-SBOM, allemaal bijgevoegd bij de release 0.4.1 op GitHub. Sites op 0.2.7 of later controleren de handtekening voordat ze een update installeren.
Lees de volledige changelog✌️
Thanks for reading!
Find more posts on the blog or star Justflows on GitHub.