Naar de inhoud
maarten.
Magazijnmedewerker controleert verzendingen met pakketten op planken in een logistiek magazijn.
Alle stories

Bestandsuploads beveiligen: validatie

Maarten Soetens 13 min lezen

Een bestandsupload brengt data van buiten je applicatie binnen en maakt die data onderdeel van je systeem. Lees hoe je bestandstype, grootte en inhoud controleert, opslag kiest en risico’s zoals malware, padmanipulatie en onveilige verwerking beperkt.

Denk vanaf het begin na over risico’s bij bestandsuploads

Voordat je een uploadmogelijkheid voor bestanden bouwt, is het slim om te bepalen wie eigenlijk bestanden mag aanbieden, welke soorten bestanden daarvoor echt nodig zijn, en wat je applicatie vervolgens met die bestanden van plan is. Het uploaden van een profielfoto brengt minder gevaar mee dan een document dat automatisch verwerkt wordt of openbaar kan worden gemaakt. Kijk dus niet alleen naar het uploadscherm, maar besteed net zo veel aandacht aan alles wat daarna gebeurt: het opslaan, het maken van een preview, indexeren, downloaden en eventueel versturen naar andere systemen. Elk van die stappen is een apart aanknopingspunt voor risico’s.

Wees erop voorbereid dat iemand bewust een schadelijk bestand aanbiedt. Dat kan zelfs een gebruiker met een normaal account zijn. Je kunt bijvoorbeeld een bestand tegenkomen dat een parser omver probeert te krijgen, verborgen inhoud heeft of handig gebruikmaakt van het vertrouwen dat gebruikers onderling kunnen stellen in elkaars bestanden. Vraag jezelf af welke data gevoelig is, wie uploads kan bekijken, en of sommige bestanden voor iedereen beschikbaar moeten zijn. Sta alleen bestandstypen toe die je ook écht nodig hebt. Een uploadfunctie die alles accepteert, vergroot de kans op problemen en maakt het ingewikkeld om scherp te controleren.

Schrijf technische eisen duidelijk op. Denk aan maximale grootte, toegestane types, hoe lang je iets bewaart, toegangsregels, en hoe je omgaat met verdachte bestanden. Zo bouw je aan een systeem dat logisch in elkaar zit, in plaats van een boel losstaande controles. Het risicoprofiel verandert direct als een bestand bijvoorbeeld via een achtergrondtaak geopend wordt of naar een externe dienst gaat. Neem zulke koppelingen meteen mee in je plan. Voor de technische uitwerking kun je een PHP-developer inschakelen.

Controleer nauwkeurig op extensie, MIME-type en bestandsignatuur

Vertrouw nooit blind op de bestandsnaam of het bijbehorende extensie. Een bestand rapport.pdf hoeft geen PDF te zijn. Het MIME-type dat een browser of app meestuurt is evenmin een zekerheid, want ook dat kan aangepast worden door wie uploadt. Combineer controles: zet alleen op je allowlist wat daadwerkelijk nodig is, check wat het MIME-type zou moeten zijn en kijk naar de inhoud, dus de zogeheten magic bytes of bestandsignatuur.

En geen van deze checks is waterdicht op zichzelf. Magic bytes kun je namaken, sommige formaten bestaan uit meerdere varianten of implementaties. Laat daarom ook een parser (bijvoorbeeld voor afbeeldingen een speciale imaging-bibliotheek) het bestand openen en kijk of dat zonder fouten werkt. Stel je parser zo in dat hij direct breekt op rare dingen en niets accepteert dat buiten de norm valt. Sommige formaten met ingebouwde scripts of macro’s zijn zelfs bij kloppende structuur risicovol. Houd je daarom aan bekende types, vermijd vage of zelden gebruikte alternatieven.

Vergelijk altijd genormaliseerde extensies, dus hoofdletters en variaties gelijk trekken, maar maak het niet je enige vangnet. Controleer alles server-side (dus niet vertrouwen op JavaScriptvalidatie). Leg afkeuringen vast, mét reden, maar gooi het bestand of gevoelige inhoud niet zomaar in gewone logbestanden. Zo kun je achteraf uitzoeken waar het misging zonder direct privacy of veiligheid te schaden. Een maatwerk WordPress-plug-in kan zulke controles onderdeel maken van je uploadproces.

Zet grenzen op grootte en gebruik van resources

Denk niet dat je met alleen een bestandsgrens klaar bent. Grote bestanden slokken makkelijk je schijf, je geheugen en je netwerk op. Stel dus limieten in meerdere lagen: webserver of proxy, framework, applicatie. Als je alleen in de applicatie controleert, is de schade soms al geleden nog voor je een upload kunt afwijzen. Stem deze limieten op elkaar af, en test ook wat er gebeurt als iemand ze overschrijdt, niet alle infrastructuur reageert zoals je misschien denkt.

Een limiet per bestand voorkomt niet dat iemand honderden kleine bestanden binnenhaalt. Kijk waar het logisch is ook per gebruiker, per sessie, per verzoek grenzen te stellen aan aantal, totaalvolume of uploadsnelheid. Meerdere uploads tegelijk zijn normaal, maar kunnen je systeem ook onverwacht belasten. Streaming van uploads helpt om niet alles in het geheugen te houden, maar dan moet je wel goed omgaan met half afgeronde uploads en bestanden die blijven hangen als iets misgaat. Ruim die rommel op zodra je doorhebt dat het proces onderbroken is.

Het gecomprimeerde formaat zegt weinig over wat verwerking kost. Een .zip van een kilobyte kan na uitpakken gigabytes ruimte nodig hebben, en een .jpeg kan qua geheugen onverwachte pieken geven. Beperk daarom niet alleen het originele bestand, maar ook uitgepakte grootte, aantal bestanden binnen een archief, pixelafmetingen, verwerkingstijd. Stop meteen als de parser buiten die limieten komt. Baseer je limieten op wat je echt nodig hebt, niet op het allergrootste extreme bestand dat het protocol technisch aankan. Open eindes in limieten nodigen uit tot misbruik en onverwachte belasting, zeker als veel gebruikers tegelijk de grens opzoeken.

Inspecteer inhoud zelf en gebruik extra controle zoals malwarescan

Na de basale extensie en groottecontrole moet je het bestand echt uitlezen. Gebruik actuele bibliotheken voor bijvoorbeeld afbeeldingen, PDF’s, archieven. Parsers herkennen structurele problemen waar je zonder die diepere check makkelijk overheen kijkt. Accepteer fouten van zo’n parser als normaal: niet verwerken, bestand afkeuren of in quarantaine. En laat nooit een bestand met fouten zomaar door naar een taak als thumbnailgeneratie.

Een malwarescanner kan helpen om extra risico’s te beperken, maar denk niet dat je bestand daarmee automatisch veilig is, scanners missen nieuwe of onverwachte bedreigingen, en zijn zelf afhankelijk van invoer die expres lastig kan zijn. Voer een scanner uit met afgeschermde rechten, werk met actuele definities, en bepaal bewust wat je doet als het scannen tijdelijk niet lukt. Soms is het wijs om een bestand niet beschikbaar te maken voor het echt gescand is. Bij een fout of een time-out: geef het bestand geen goedkeuring aan de rest van het systeem.

Bepaalde typen bestanden zijn veiliger als je ze na het uploaden omzet naar een gecontroleerd formaat. Een afbeelding opnieuw wegschrijven als strakke PNG of JPEG kan verborgen data, metadata of scripts verwijderen. Test vooraf wat dat betekent voor kwaliteit en bruikbaarheid. Archieven moet je apart controleren op geneste inhoud, concurrentieproblemen bij dezelfde naam, en onnauwkeurige padinformatie. Bewaar het origineel apart zolang nodig, en geef pas toegang tot een resultaatbestand nadat alle controles zonder problemen zijn verlopen.

Voorkom dat bestandsnamen of paden worden misbruikt

De naam die een gebruiker uploadt, is onbetrouwbare invoer. Padonderdelen als ../, absolute paden, backslashes, gekke tekens, zomaar gebruikt, proberen ze buiten je bedoelde map iets te schrijven. Dubbele extensies en Unicode-trucs om validatie te omzeilen zijn bekend. Plak daarom nooit simpelweg een gebruikersnaam aan een directory vast voor opslag.

Beter is het om op de server een willekeurige, unieke naam (gewoon een sleutel of UUID) te maken en die fysiek te gebruiken. De originele naam kun je kwijt als metadata, eventueel genormaliseerd en ingekort. Komt die origineel terug in een webpagina of download, codeer die dan voor die locatie. Padnormalisatie op de server helpt: kijk waar je bestand echt terechtkomt, en check of dat nog binnen je gewenste pad valt. Maar zie dit als extra controle, geen hoofdmethode.

Let op overschrijven en racecondities. Een voorspelbare of hergebruikte naam kan bestaande bestanden vervangen, of bij meerdere uploads tegelijk tot botsingen leiden. Gebruik opslagmethoden die unieke namen of atomaire creatie garanderen. Log foutgevallen apart. Archiefbestanden moeten ook vóór het uitpakken gecontroleerd worden op interne paden en padmanipulatie; alleen een veilig uploadpad is geen garantie tijdens extractie. Geef in foutmeldingen geen interne paden of configuraties prijs, dat is informatie die je niet wilt delen met buitenstaanders.

Maak een bewuste keuze tussen lokale opslag en object storage

Lokale opslag is soms handig, bijvoorbeeld als je applicatie en bestanden op dezelfde server werken en alles overzichtelijk is. Je moet dan zelf directories, rechten, back-ups, en capaciteit bijhouden. In een omgeving waar je meerdere servers gebruikt, ontstaan meteen vragen: wie beheert het bestand, hoe krijg je het beschikbaar voor andere servers? Lokale opslag kan vollopen, verloren gaan bij een serverwissel, of per ongeluk publiek beschikbaar zijn via je webserver. Hang lokale opslag daarom nooit aan een map die direct publiek is.

Object storage zet bestanden los van je servers, en geeft je schaalbare opslag met rechten op bucket- of objectniveau. Dat voorkomt dat bestanden op een plek staan waar je er niet bij kunt, en maakt het makkelijker om ze buiten je webomgeving te houden. Daarvoor komt wat meer bij kijken: wie kan bij je buckets, welke sleutels, settings, regio’s, netwerken, en tijdelijke downloadlinks je gebruikt. Een verkeerd ingestelde, publieke bucket betekent dat alle uploads te benaderen zijn. Loop standaardinstellingen na en geef alleen dringend benodigde rechten aan je applicatie-identiteiten.

Wat het beste uitpakt ligt ook aan hoe je bestanden verwerkt en beschikbaar wilt hebben. Object storage werkt soepel met taken die op de achtergrond draaien, maar brengt soms vertraging en asynchrone statusupdates mee. Lokale opslag is makkelijk bij korte processen, maar vereist een plan voor gedeeld gebruik en herstel als er iets misgaat. Bewaar metadata, zoals eigenaar, status, opslaglocatie, in je database; maak een bestandsnaam nooit de enige koppeling. En bij beide varianten: vergeet encryptie, back-up, definitief verwijderen en foutafhandeling bij tijdelijk niet bereikbare opslag niet. Voor een WordPress-site kan ik opslag en uploadcontroles op maat inrichten.

Verwerk uploads apart en houd ze uit de webroot

Geüploade bestanden mogen nooit vanzelf uitvoerbaar of direct benaderbaar zijn. Sla ze op buiten de webroot of in een afgeschermde object storage-bucket. Lever het bestand alleen uit aan de gebruiker via een route die jij controleert. Zo zorg je dat uploads nooit per ongeluk als script draaien, en niemand zomaar door raden van een bestandsnaam toegang krijgt. Gebruik, waar mogelijk, een opslaglocatie of serveraccount met beperkte lees- en schrijfrechten voor uploads.

Ook achtergrondverwerking is een scheidslijn voor risico’s. Een thumbnailgenerator, converter of antivirusprogramma verwerkt onbetrouwbare input en draait mogelijk met rechten die te ruim zijn. Laat dit soort taken uitvoeren met minimale bevoegdheden, afgeschermd netwerk, en liefst vaste limieten voor CPU, geheugen en uitvoeringstijd. Houd tijdelijke werkbestanden gescheiden van opslag, en ruim die altijd op: bij succes of bij storing. Als een proces vastloopt, mag dit niet eindeloos geheugen of schijf blijven gebruikten. Ook bij achtergrondtaken zijn logging en foutafhandeling belangrijk.

Zorg dat de status van het bestand altijd expliciet is: denk aan ontvangen, in verwerking, goedgekeurd, afgewezen. Toegang tot een bestand hangt af van die status; maak een upload pas beschikbaar als noodzakelijke checks zijn doorlopen. Bij downloads is er geen standaard: de applicatie bepaalt wie toegang krijgt, en stelt zelf headers in. Voor actieve types is aanbieden als download veiliger dan inline tonen. In sommige gevallen helpt het om downloads via een apart domein af te handelen, buiten je hoofdapplicatiecontext om. Welke keuze werkt, hangt af van type en gebruik, maar direct uitvoeren in je applicatieomgeving is nooit vanzelfsprekend veilig.

Zorg dat rechten, bewaartermijnen en auditen goed geregeld zijn

Beveiliging van opslag is meer dan een map afschermen. Je moet duidelijk vastleggen wie bestanden mag uploaden, inzien, aanpassen of verwijderen. Check die rechten elke keer wanneer iemand een bestand opvraagt; het is niet genoeg als een URL niet makkelijk te raden is. Laat gebruikers niet bij bestanden van anderen komen door een ID in de link te wijzigen. Ook achtergrondprocessen en beheerinterfaces mogen alleen doen wat strikt nodig is.

Tijdelijke ondertekende downloadlinks zijn handig, maar let erop dat iedereen met de link toegang heeft zolang deze geldig blijft. Beperk de levensduur, geef niet meer rechten dan nodig, en voorkom dat links per ongeluk in logbestanden of refererende headers verschijnen. Trek links actief in waar je platform dat ondersteunt. Laat je applicatie downloads zelf afhandelen? Zorg dan voor goed streamen van grote bestanden en dat alle toegangscontrole ook hier geldt. Caching is een valkuil: een gedeelde cache mag privébestanden niet aan anderen tonen.

Bewaar uploads zo kort als nuttig is voor je functie. Stel regels op voor het verwijderen van originelen, afgeleiden, tijdelijke bestanden en back-ups. Anders blijven verwijderde bestanden alsnog ergens aanwezig. Houd in auditlogs bij wie wat heeft gedaan met een bestand, maar log geen inhoud, geheime tokens of onnodige persoonsgegevens. Zorg dat toegang tot logs beperkt is, en let op afwijkend gedrag zoals herhaalde mislukte uploads of onverwacht veel downloads. Zo zijn logs bruikbaar bij onderzoek zonder zelf een risico te vormen.

Veelgestelde vragen

Hoe beveilig ik een uploadformulier tegen CSRF-aanvallen?

Je beveiligt een uploadformulier tegen CSRF door server-side te controleren of het verzoek echt van de bedoelde gebruiker komt, en niet zomaar van een derde. Want een aanvaller kan zelf een verzoek aanmaken waardoor je, zonder het door te hebben, een bestand uploadt.

  • Gebruik een CSRF-token dat is gebonden aan de sessie van de gebruiker.
  • Check afhankelijk van de situatie de Origin- of Referer-header als extra hulpmiddel.
  • Zorg dat alleen bevoegde gebruikers mogen uploaden en vraag bij gevoelige acties om extra bevestiging.
  • Test dat een upload zonder geldig CSRF-token altijd faalt.

Hoe richt ik directe uploads naar object storage veilig in?

Laat de server een uploadautorisatie genereren die tijdelijk geldig is en alleen gebruikt kan worden voor één upload met de juiste eigenschappen. Zo hoeft de browser geen directe toegang tot je opslagplatform te hebben. De server bepaalt wie mag uploaden, waar het bestand terechtkomt en hoe groot die upload mag zijn.

  • Beperk de autorisatie tot het specifieke object en aanmaken (niet lezen, niet wissen).
  • Gebruik een willekeurig gekozen objectnaam, door de server uitgegeven.
  • Stel een korte geldigheidsduur in en beperk de maximale uploadgrootte.
  • Wacht met verdere verwerking tot de applicatie of backend gecontroleerd heeft dat de upload ook echt gelukt is en binnen alle regels valt.
  • Laat je client niet bladeren in buckets, en geef geen lees- of delete-rechten via deze autorisatie.

Welke HTTP-headers zijn belangrijk bij het aanbieden van geüploade bestanden?

Zet headers waarmee je voorkomt dat een bestand ongewenst als actief script of iets vergelijkbaars wordt verwerkt, of ingeladen wordt in een context die je niet voor ogen had. Baseer de headers altijd op wat de server na validatie heeft vastgesteld, niet op de naam of het type dat de gebruiker invult.

  • Gebruik voor onbekende of risicovolle types liefst Content-Disposition: attachment.
  • Zet X-Content-Type-Options: nosniff om te voorkomen dat de browser het type anders gaat interpreteren.
  • Kies het juiste Content-Type op basis van server-side validatie.
  • Voor inline downloads: overweeg een apart domein zonder cookies uit de applicatie.
  • Codeer bestandsnamen veilig wanneer ze in downloadheaders worden aangeboden.

Hoe test ik de beveiliging van een bestandsuploadfunctie?

Test niet alleen de standaarduploads, maar ook afwijkende scenario’s: zo weet je of je server ook bij rare, opzettelijk foutieve pogingen goed blijft controleren. Het testen van alleen het formulier is onvoldoende; ook het deel na de upload telt mee.

  • Upload bestanden met rare of misleidende extensies, verkeerd MIME-type, en opzettelijk foute inhoud.
  • Test limieten met enorme bestanden, veel simultane uploads en afgebroken uploads.
  • Controleer dat gebruikers niet aan bestanden van anderen kunnen komen, en elkaar niet kunnen overrulen bij verwijderen of downloaden.
  • Probeer archiefbestanden met geneste bestanden of lastige paden in een geïsoleerde omgeving.
  • Houd regressietests bij voor fouten die je eerder vond, en let op versies van gebruikte bibliotheken.

Hoe verwijder ik geüploade bestanden betrouwbaar uit alle opslaglagen?

Zorg dat je niet alleen een verwijzing verwijdert, maar het bestand zelf, inclusief alle afgeleiden, temporaries en bijlagen. Wissen uit je database haalt het bestand niet per definitie van disk of uit je afgeleide opslag.

  • Maak inzichtelijk welke bestanden, previews, en werkbestanden horen bij één upload.
  • Laat zo’n verwijderactie indien nodig uitvoeren door een achtergrondtaak die kan herhalen en mislukkingen logt.
  • Maak duidelijk of en hoe verwijderingen uiteindelijk uit back-ups en oude versies verdwijnen.
  • Check na verwijderen of oude downloadlinks niet per ongeluk nog werken.
  • Zorg dat bewaartermijnen passen bij het doel van het bestand, én privacywetgeving of interne afspraken.

Foto: Tima Miroshnichenko

Portret van Maarten

Maarten

Freelance developer in Nijmegen

Even kennismaken?

Vertel kort wat er speelt. Dan hoor je wat er kan, wat ik anders zou doen en waar AI bij jou wél en niet iets toevoegt. Vrijblijvend.

Het kantoor in Nijmegen
© 2026 maarten.online Sitemap Privacy Algemene voorwaarden
Het kantoor in Nijmegen

Maarten.

Freelance developer in Nijmegen. Liever direct contact? Dat kan ook.

Kennismaken

Laat je gegevens achter, dan kijken we of het klikt. Vrijblijvend en zonder verkooppraat.

Maarten

Stuur een bericht via WhatsApp

Hoi! Waar kan ik je mee helpen?

nu