Quick reference
| Layer | Inspect | Typical lead |
|---|---|---|
| Peer transport | Reachability / UDP 500 and 4500 | NAT traversal / filtering |
| IKE | Identity, proposal, authentication | Mismatch or failed authentication |
| IPsec child SA | Transforms and traffic selectors | Proxy IDs / subnet mismatch |
| Routing | Destination through tunnel | Wrong VR or missing route |
| Policy / NAT | Intended flow permitted | Unexpected translation / deny |
| Traffic | Counters in both directions | Return routing / MTU / peer issue |
What to understand first
IKE establishes authenticated keying state. IPsec SAs protect selected traffic; an established IKE SA alone does not prove a useful child SA exists.
IKEv1 proxy IDs and IKEv2 traffic selectors describe protected traffic, with negotiation differences between versions and peers. Compare local and remote definitions from both viewpoints.
NAT traversal commonly carries IPsec over UDP 4500. Without NAT traversal, ESP uses IP protocol 50, not TCP/UDP port 50. Confirm the negotiated mode before checking filters.
Tunnel-interface state, route selection, security policy and reverse path are independent. Overlapping networks or extra encapsulation can create failures despite healthy negotiation.
Commands and interpretation
Inspection commands are read-only unless explicitly labeled otherwise. Capture commands start collection; configuration-mode commits change device state.
PAN-OS
Read-only operational
show vpn ike-sa
show vpn ipsec-sa
show vpn flowInspect: Compare gateway/tunnel identity, SA state and counter changes during one controlled attempt.
PAN-OS session inspection
Read-only operational
show session all filter source 198.51.100.10 destination 192.0.2.10
show session id <SESSION_ID>Inspect: Check actual zones, rule, tunnel egress and translations. Use the correct vsys and routing engine context.
Worked example · Illustrative, not a device capture
Illustrative one-direction VPN traffic
IKE SA: established
IPsec SA: installed
During client attempt:
Local encrypted packets: increasing
Local decrypted packets: unchangedThis narrows the investigation toward the remote path or missing return traffic; it does not prove the peer is at fault.
Correlate peer counters, selectors, remote policy and application replies with the same timestamp and tuple.
Troubleshooting sequence
- Identify the exact client/server subnets, application tuple and peer/tunnel names.
- Check peer transport and IKE state without restarting negotiations.
- Compare child-SA selectors and proposals at both ends.
- Verify tunnel route, policy/NAT and return route for that flow.
- Compare timed encrypted/decrypted counters; if transfers stall, investigate MTU and permitted ICMP feedback.
Common mistakes
- Treating a green tunnel indicator as end-to-end success.
- Bouncing every tunnel before collecting failure evidence.
- Opening ESP by port number or assuming all traffic uses NAT traversal.
Acceptance checks
- Required subnets and applications pass in both directions.
- Counters and session evidence identify the intended tunnel.
- Rekey, recovery and MTU behavior satisfy the approved acceptance plan.
Primary references
Vendor documentation and protocol specifications support this guide. The diagrams, scenarios and troubleshooting sequences are Wolex-authored.
