n8n-security: checklist voor credentials, data en omgevingen

n8n veilig gebruiken vraagt meer dan TLS inschakelen en sterke wachtwoorden kiezen. Je moet ook bepalen welke data een workflow mag verwerken, wie credentials beheert, welke nodes uitvoerbaar zijn, hoe omgevingen zijn gescheiden en welk bewijs je bewaart. Deze checklist vertaalt die onderwerpen naar concrete controles, eigenaren en stopcriteria.

Nieuw met n8n? Op onze n8n-pagina lees je wat het platform is, wat het kost en waarom Flowstate er dagelijks mee bouwt.

Meer over het platform zelf lees je op onze pagina over n8n.

Begin bij data, niet bij instellingen

Een beveiligingscheck begint met de vraag welke informatie door een workflow stroomt. Een proces met openbare productdata heeft een ander risicoprofiel dan een proces met personeelsgegevens, financiële informatie of toegangstokens. Maak daarom per workflow een eenvoudige datakaart: bron, doel, categorieën gegevens, bewaartermijn, ontvangers en eigenaar.

Neem alleen data op die nodig is voor het proces. Sla geen volledige payload op wanneer enkele velden voldoende zijn. Controleer daarnaast wat n8n in uitvoeringsgegevens, foutmeldingen en logs bewaart. Een workflow kan functioneel correct zijn en toch onnodig gevoelige informatie achterlaten in de historie.

Leg voor ieder dataveld een antwoord vast op drie vragen:

• Waarom is dit veld nodig voor de uitvoering?
• Wie mag het tijdens beheer en foutanalyse zien?
• Wanneer wordt het verwijderd of geanonimiseerd?

Kun je deze vragen niet beantwoorden, dan is de workflow nog niet klaar voor productie. Bij persoonsgegevens blijven de normale AVG-verplichtingen gelden. Een beveiligingsfunctie van n8n maakt een verwerking niet automatisch rechtmatig of passend ingericht.

De n8n-securitychecklist

Gebruik de volgende acht controledomeinen bij een nieuwe workflow, een wijziging met verhoogd risico en een periodieke platformreview. De kolom ‘bewijs’ voorkomt dat veiligheid alleen een mondelinge afspraak blijft.

1. Beperk het aanvalsoppervlak

Niet ieder onderdeel van een n8n-instance hoeft vanaf internet bereikbaar te zijn. Breng publieke webhooks, de editor, de REST API en beheerinterfaces afzonderlijk in kaart. Een webhook die publiek moet zijn, geeft nog geen reden om ook de editor publiek open te zetten.

De officiële n8n-securitydocumentatie noemt onder meer SSL, het uitschakelen van een ongebruikte publieke API, het blokkeren van nodes en bescherming tegen server-side request forgery. SSRF-bescherming is een nuttige applicatielaag, maar vervangt geen netwerksegmentatie, firewallregels of egress-controle.

Controleer ook oude testwebhooks en tijdelijke endpoints. Wat niet meer nodig is, verwijder je. Wat wel publiek blijft, krijgt authenticatie waar mogelijk, invoervalidatie, een limiet op payloads en monitoring op misbruik.

2. Geef mensen en systemen minimale toegang

Gebruik persoonlijke accounts voor beheerders en bouwers. Daarmee blijft herleidbaar wie een workflow, credential of instelling heeft gewijzigd. Schakel tweefactorauthenticatie in en gebruik centrale login waar het risicoprofiel en het n8n-abonnement dat toelaten.

Rollen zijn pas nuttig als ze aansluiten op verantwoordelijkheden. Een proceseigenaar hoeft niet automatisch instancebeheerder te zijn. Een ontwikkelaar hoeft niet alle productiecredentials te kunnen lezen of gebruiken. Plan minimaal ieder kwartaal een review op gebruikers, rollen, projecten en inactieve accounts.

Voor keuzes over projectstructuur, rollen en organisatorische governance verwijst deze checklist naar het afzonderlijke artikel over n8n Enterprise-architectuur en governance. Dat artikel is de eigenaar van de bredere enterprise-intentie; hier staat de praktische beveiligingscontrole centraal.

3. Beheer credentials als bedrijfsmiddelen

Zet API-sleutels, tokens en wachtwoorden nooit in een Code-node, expressie, notitie of voorbeeldpayload. Gebruik n8n-credentials en wijs per credential een technische eigenaar, zakelijke eigenaar en rotatiemoment aan. Maak bovendien zichtbaar voor welke workflows en omgevingen een secret bedoeld is.

n8n bewaart credentials versleuteld in de database. Voor organisaties met aanvullende eisen ondersteunt n8n ook externe secret stores; de actuele beschikbaarheid hangt af van editie en configuratie. Een kluis lost echter geen eigenaarschapsprobleem op. Zonder intrekkingsprocedure en periodieke rotatie blijft een oud token bruikbaar.

Bescherm en back-up de encryptiesleutel volgens de officiële procedure. Het roteren van encryptiesleutels vraagt voorbereiding en een herstelbaar back-upmoment. Voer zo’n wijziging niet ad hoc tijdens een incident uit.

4. Blokkeer risiconodes die je niet gebruikt

Sommige nodes kunnen commando’s uitvoeren, bestanden lezen of eigen code draaien. Dat kan functioneel nodig zijn, maar vergroot ook de impact van een fout of misbruikt account. De officiële n8n-richtlijn noemt onder andere Execute Command en Read/Write Files from Disk als voorbeelden die je kunt uitsluiten wanneer ze niet nodig zijn.

Maak voor community-nodes een toelatingsproces. Controleer herkomst, onderhoud, gevraagde rechten, updategedrag en alternatieven. Leg vast wie een nieuwe node mag installeren en hoe bestaande workflows worden beoordeeld als een dependency kwetsbaar blijkt.

5. Beperk execution data en logs

Uitvoeringsdata helpt bij foutanalyse, maar kan ook complete klantrecords of tokens bevatten. Kies per workflow welke succesvolle en mislukte uitvoeringen je bewaart en hoe lang. Gebruik testdata die geen productiepersoonsgegevens bevat. Laat foutmeldingen geen secrets of volledige payloads doorsturen naar chat- of ticketsystemen.

n8n biedt voor bepaalde Enterprise-configuraties redactie van execution data. Bekijk de actuele beperkingen van execution-dataredactie: niet ieder logpad of gegevensspoor valt daar automatisch onder. Test daarom de volledige keten, inclusief externe logging, webhookresponses en foutafhandeling.

6. Scheid ontwikkeling, test en productie

Een productieomgeving hoort geen experimenteerplek te zijn. Gebruik gescheiden omgevingen of ten minste duidelijk afgebakende projecten, credentials, datasets en wijzigingsrechten. Promoot een wijziging pas als de functionele test, beveiligingscheck, rollback en eigenaar zijn vastgelegd.

Gebruik in test geen kopie van de volledige productiedatabase wanneer synthetische of gemaskeerde data voldoende is. Controleer na promotie of webhooks, callback-URL’s en credentials naar de juiste omgeving wijzen. Een technisch geslaagde deployment met een testtoken is nog steeds een mislukte productiewijziging.

7. Maak controle aantoonbaar

n8n heeft een ingebouwde security audit die onder meer credentials, database-instellingen, nodes en instanceconfiguratie beoordeelt. Gebruik de uitkomst als signaal en actielijst, niet als certificaat. Voeg eigen controles toe voor netwerk, leveranciers, bewaartermijnen, privacy en herstel.

Een bruikbaar controleregister bevat per bevinding:

• risico en getroffen workflows;
• eigenaar en uiterste datum;
• gekozen maatregel of bewuste acceptatie;
• bewijs van uitvoering;
• datum waarop de controle opnieuw plaatsvindt.

Zo kun je bij een audit, incident of personeelswissel reconstrueren welke keuze is gemaakt. Dat is waardevoller dan een eenmalige checklist met overal een vinkje.

8. Test back-up, herstel en incidentrespons

Een back-up is pas bruikbaar als je hem kunt terugzetten. Test periodiek het herstel van database, encryptiesleutel en relevante configuratie in een afgeschermde omgeving. Meet hoe lang herstel duurt en welke gegevens sinds de laatste back-up verloren kunnen gaan.

Maak daarnaast een compacte incidentroute: wie schakelt een workflow uit, wie trekt credentials in, wie beoordeelt datalekrisico, wie communiceert met proceseigenaren en wie geeft productie weer vrij? Neem in het runbook ook de optie op om een specifieke workflow of integratie te isoleren zonder het hele platform onnodig stil te leggen.

Praktische volgorde: 48 uur, 30 dagen en ieder kwartaal

Binnen 48 uur

• Inventariseer publieke endpoints, beheerders en kritieke credentials.
• Schakel MFA in en verwijder ongebruikte accounts en webhooks.
• Controleer of back-up en encryptiesleutel afzonderlijk beschikbaar zijn.
• Blokkeer direct onnodige risiconodes en publieke API-toegang.

Binnen 30 dagen

• Maak datakaarten en retentieafspraken voor kritieke workflows.
• Richt credentialeigenaarschap, rotatie en omgevingsscheiding in.
• Voer de n8n-securityaudit uit en koppel bevindingen aan eigenaren.
• Test monitoring, rollback en één volledig herstelpad.

Ieder kwartaal

• Review accounts, rollen, nodes, endpoints en uitzonderingen.
• Installeer geplande updates en controleer relevante release-informatie.
• Herhaal de audit en een hersteloefening.
• Werk datakaarten bij na proces- of leverancierswijzigingen.

Wanneer is een workflow klaar voor productie?

Geef pas akkoord als de proceseigenaar en technische eigenaar allebei kunnen aantonen dat de datastroom klopt, toegang minimaal is, secrets beheerd zijn, uitzonderingen worden gelogd en herstel getest is. Leg een expliciet stopcriterium vast voor wijzigingen met onbekende data, onbeoordeelde code, ontbrekende rollback of credentials zonder eigenaar.

Wil je de security van bestaande n8n-workflows laten beoordelen of een gecontroleerde productie-inrichting ontwerpen? Bekijk hoe Flowstate n8n-productiehardening en implementatie aanpakt. Voor de bouwlogica zelf helpt ook de uitleg over n8n-workflows opzetten.

Veelgestelde vragen over n8n-security