Ga naar inhoud

Test: Troubleshooting (Logica & Aanpak)

Project: SASE Proof of Concept
Datum: 31-05-2026
Rubriekcriterium: Troubleshooting — logica en aanpak bij problemen
Verantwoordelijke: Hennie

Dit document beschrijft de troubleshooting-methodiek die tijdens de PoC is gehanteerd. Het toont aan dat het team systematisch problemen heeft geïdentificeerd, geïsoleerd en opgelost (of gedocumenteerd als bekende beperking). Elk voorbeeld verwijst naar een reëel probleem dat tijdens de implementatie is opgetreden.


Troubleshooting-aanpak

Bij elk probleem is de volgende systematiek gehanteerd:

  1. Symptoom vaststellen — wat faalt precies, voor wie, wanneer?
  2. Laag isoleren — op welke laag zit het probleem (DNS, tunnel, proxy, ICAP, firewall)?
  3. Hypothese formuleren — wat is de meest waarschijnlijke oorzaak?
  4. Verificatie — toetsen via logs, tcpdump, packet captures, of configuratie-inspectie
  5. Oplossing of documentatie — fixen indien mogelijk, anders documenteren als bekende beperking

TS-01. Transparante proxy werkt niet voor Netbird-tunnelverkeer

Symptoom: HTTPS-verkeer van Netbird-clients werd niet geïnspecteerd door Squid, ondanks correcte NAT-redirection en actieve proxy-listener.

Isolatie:

Stap Tool Bevinding
NAT-redirect actief? tcpdump op OPNsense Ja — verkeer van 100.116.198.151 wordt geredirect naar 192.168.50.1:3128
Proxy ontvangt verkeer? sockstat op OPNsense Ja — actieve sockets van Netbird-client naar poort 3128
Squid logt het verkeer? access.log Nee — geen entries voor geredirect verkeer

Hypothese: het verkeer bereikt Squid's socket maar wordt niet correct verwerkt als transparant proxy-verkeer (verschil in interface: wt0 vs. vtnet1).

Geteste oplossingen:

  • PF-redirect op verschillende interfaces (LAN, NetBird, OPT1, WAN)
  • Verschillende source-netwerken (100.116.0.0/16, 192.168.50.0/24)
  • Redirect-target variaties (127.0.0.1 vs. 192.168.50.1)

Uitkomst: niet opgelost binnen de PoC-scope. Het probleem situeert zich vermoedelijk in hoe Squid omgaat met verkeer dat via een overlay-interface binnenkomt. Workaround: handmatige proxy-instelling in Firefox.

Referentie: ZTNA Configuratie sectie 12.1


TS-02. Student-peer bereikt toch interne hosts ondanks ontbrekende route

Symptoom: ping 192.168.50.12 slaagde vanaf een Student-peer, terwijl netbird networks list geen route naar dat subnet toonde.

Isolatie:

Stap Tool Bevinding
Route aanwezig op client? sudo netbird networks list Nee — alleen 0.0.0.0/0
Verkeer bereikt OPNsense? tcpdump op wt0 Ja — pakket matcht de default route
OPNsense routeert door? packet capture LAN Ja — OPNsense is gateway van 192.168.50.0/24

Root cause: de exit-node route (0.0.0.0/0) vangt al het verkeer op, inclusief pakketten naar 192.168.50.x. Omdat OPNsense zowel exit-node als interne gateway is, routeert het deze pakketten gewoon door naar het LAN.

Oplossing: aanvullende firewall-regels op OPNsense die verkeer van 100.116.0.0/16 (students) naar 192.168.50.0/24 blokkeren. Route-distributie + firewall samen = defense-in-depth.

Referentie: ZTNA Configuratie sectie 11.2, ZT-T03/T04


TS-03. Groepen blijven GUID's in Netbird-dashboard

Symptoom: na het koppelen van Entra ID verschijnen groepen als aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee in plaats van hun leesbare Entra-naam.

Isolatie:

Stap Tool Bevinding
Entra-koppeling actief? Netbird Settings → IdP Ja — users synchroniseren correct
Groups claim in token? Token configuration in Entra Ja — Security groups, Group ID
Probleem Netbird ontvangt Object-ID, niet displayName Netbird kent alleen de GUID

Root cause: Netbird synchroniseert group-claims als GUID. Er is geen ingebouwde functie om de displayName op te halen via Microsoft Graph.

Oplossing: zelfgebouwd sync-script (sync-groups.sh) dat elke 2 minuten draait en GUID-groepen omzet naar leesbare namen via de Microsoft Graph API.

Referentie: ZTNA Configuratie sectie 6


TS-04. Local breakout niet volledig geblokkeerd

Symptoom: na het uitschakelen van de proxy-instelling in Firefox kan de Rocky Linux client nog steeds direct surfen.

Isolatie:

Stap Tool Bevinding
Netbird-tunnel actief? netbird status Ja — Connected
Exit-node route actief? ip route Ja — 0.0.0.0/0 via wt0
Directe curl werkt? curl --noproxy '*' https://example.com Ja — pagina laadt

Root cause: de exit-node route stuurt al het verkeer via OPNsense, maar OPNsense NAT'd het naar het internet zonder dat het door Squid gaat (Squid ontvangt alleen verkeer dat expliciet naar poort 3128 is gericht, of via transparante redirect — zie TS-01).

Uitkomst: bekende beperking van de PoC. Mitigatie in productie: OS-level firewallregel op de client die al het uitgaande verkeer behalve via wt0 blokkeert, of strikte Netbird ACL.

Referentie: TR-T03


TS-05. Relay-only verbindingen (geen directe P2P)

Symptoom: alle Netbird-peers communiceren via de relay-server in plaats van directe WireGuard P2P-verbindingen.

Isolatie:

Stap Tool Bevinding
Peer-verbinding type? netbird status -d Relay
STUN werkt? UDP 3478 check Geblokkeerd op schoolnetwerk
Direct UDP 51820? netbird status -d Niet bereikbaar peer-to-peer

Root cause: het schoolnetwerk (of de Proxmox-host) blokkeert UDP 51820 inbound, waardoor ICE/STUN geen directe P2P-verbinding kan opzetten.

Uitkomst: functioneel geen impact — relay-verbindingen werken correct, alleen met hogere latency. Geaccepteerd als beperking van de PoC-omgeving.

Referentie: ZTNA Configuratie sectie 12 — bekende beperkingen


Samenvatting

ID Probleem Status Oplossing/Workaround
TS-01 Transparante proxy voor tunnel-verkeer Bekende beperking Handmatige proxy in Firefox
TS-02 Student bereikt interne hosts via exit-route Opgelost OPNsense firewallregels
TS-03 Groepen als GUID in dashboard Opgelost sync-groups.sh (cron elke 2 min)
TS-04 Local breakout niet geblokkeerd Bekende beperking Productie: OS-level firewall op client
TS-05 Relay-only verbindingen Geaccepteerd Geen impact op functionaliteit