N8N Credentials Beheer: API Keys, OAuth2 & Encryptie Veilig Configureren

Een gemiddelde n8n productie-instance bevat credentials voor 10-30 externe services. Elk credential is een potentieel beveiligingsrisico. In deze gids leer je hoe n8n credentials beschermt, hoe je ze veilig beheert, en welke best practices je moet volgen om je automatisering waterdicht te houden.

Hoe n8n Credentials Opslaat

n8n slaat credentials niet als platte tekst op. Elke credential wordt versleuteld voordat het in de database terechtkomt.

De N8N_ENCRYPTION_KEY

Dit is de belangrijkste secret van je hele n8n installatie. Zonder deze key zijn alle opgeslagen credentials onleesbaar. Raak je hem kwijt, dan moet je alle credentials opnieuw invoeren.

# Docker Compose voorbeeld
services:
  n8n:
    image: n8nio/n8n
    environment:
      # KRITIEK: Genereer een sterke, unieke key
      - N8N_ENCRYPTION_KEY=jouw-supersterke-key-minimaal-32-karakters
      
      # NOOIT:
      # - Hard-coden in Dockerfiles
      # - Committen naar Git
      # - Dezelfde key voor dev en productie gebruiken
      
      # WEL:
      # - Bewaar in een secret manager (AWS Secrets, Vault)
      # - Of in een .env file (niet in Git!)
      # - Maak een backup op een veilige plek

# Sterke key genereren:
# openssl rand -hex 32
# Output: a1b2c3d4e5f6...  (64 hex karakters)

Authenticatie Methoden

n8n ondersteunt meerdere authenticatiemethoden. De juiste keuze hangt af van de service die je verbindt.

OAuth2 vs API Keys: De Afweging

Credentials Delen in Teams

In teamomgevingen moeten meerdere mensen dezelfde credentials gebruiken — zonder de daadwerkelijke keys te zien.

// n8n Credential Sharing (Cloud & Enterprise)

// Scenario: Marketing team moet Mailchimp credential gebruiken
// maar mag de API key niet zien.

// 1. Admin maakt credential aan:
//    Settings → Credentials → Add → Mailchimp
//    Name: "Mailchimp - Marketing Team"
//    API Key: mc_xxxxxxxxxxxx

// 2. Admin deelt met gebruikers/projecten:
//    Credential → Sharing → Add Users
//    → Selecteer teamleden
//    → Permission: "Can use" (NIET "Can manage")

// 3. Teamleden zien:
//    - De credential naam in hun dropdown
//    - Kunnen het selecteren in Mailchimp nodes
//    - Zien NIET de daadwerkelijke API key
//    - Kunnen de credential NIET bewerken of exporteren

// Resultaat: Veilig gedeeld zonder key exposure

Best Practices: De Security Checklist

Credential Audit Workflow Bouwen

Automatiseer je security audits met een n8n workflow die je credentials monitort:

// Maandelijkse Credential Audit Workflow

Schedule Trigger (1e van elke maand, 09:00)
  ↓
HTTP Request → n8n Internal API
  GET /api/v1/credentials
  Headers: { "X-N8N-API-KEY": "{{ $env.N8N_API_KEY }}" }
  ↓
Code Node (analyseer credentials)
  const creds = items;
  const report = {
    total: creds.length,
    byType: {},
    unused: [],  // Credentials niet gekoppeld aan actieve workflows
    oldOAuth: [] // OAuth tokens ouder dan 90 dagen
  };
  
  creds.forEach(c => {
    const type = c.json.type;
    report.byType[type] = (report.byType[type] || 0) + 1;
    
    if (!c.json.nodesAccess?.length) {
      report.unused.push(c.json.name);
    }
  });
  
  return { json: report };
  ↓
Slack Node (#security-audit)
  "🔐 *Maandelijkse Credential Audit*
   Totaal: {{ $json.total }} credentials
   Ongebruikt: {{ $json.unused.length }}
   {{ $json.unused.length > 0 
      ? '⚠️ Overweeg om ongebruikte credentials te verwijderen:\n' + 
        $json.unused.join('\n') 
      : '✅ Geen ongebruikte credentials' }}"

Relatie met Environment Variables en Secrets

n8n heeft twee manieren om gevoelige data op te slaan:

Lees meer over environment variables in onze Workflow Variables & Secrets gids — dit is een van onze best gelezen artikelen met meer dan 19.000 impressies per maand.

Veelgemaakte Fouten

Conclusie

Credential management is geen bijzaak — het is de fundering van veilige automatisering. n8n biedt sterke encryptie en redaction uit de doos, maar de verantwoordelijkheid voor key rotation, least privilege, en audit ligt bij jou.

Gerelateerde Artikelen

• n8n Security Best Practices
• n8n Workflow Variables & Secrets Management
• n8n Self-Hosted: Complete Gids
• n8n Docker Installatie
• n8n Backup & Disaster Recovery