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:
- Symptoom vaststellen — wat faalt precies, voor wie, wanneer?
- Laag isoleren — op welke laag zit het probleem (DNS, tunnel, proxy, ICAP, firewall)?
- Hypothese formuleren — wat is de meest waarschijnlijke oorzaak?
- Verificatie — toetsen via logs, tcpdump, packet captures, of configuratie-inspectie
- 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 |