How crypt0p3g/pass-the-device works
Pass-the-Device is a security-assessment toolkit paired with experimental endpoint and gateway detections. Its main workflow fingerprints a VPN gateway, then uses the identified product’s recon tool; Netskope reconnaissance starts from a tenant name instead. Cisco Profile Lens inspects or supplies posture data, while SAML Bridge is an optional lab proxy for GlobalProtect Recon. Detection rules and hunting queries form a separate blue-team capability. Relationships among tool stages follow the README; internal edges are limited to calls or behavior visible in excerpts.
Main entry points: vpn_fingerprint.py VPN Fingerprinter · gp_recon.py GlobalProtect Recon · cisco_profile_lens.py Cisco Profile Lens · saml_bridge.py SAML Bridge
Components 20
Reconnaissance
- VPN Fingerprinter
vpn_fingerprint/vpn_fingerprint.py - TLS Cert Probe
vpn_fingerprint/client_cert_probe.py - GlobalProtect Recon
gp_recon/gp_recon.py - Netskope Scout
netskope_scout/netskope_scout.py
Posture Profiles
- Cisco Profile Lens
cisco_profile_lens/cisco_profile_lens.py - Editable posture profile
cisco_profile_lens/cisco_profile_lens.py
Identity Lab
- SAML Bridge
saml_bridge/saml_bridge.py - Lab CA and leaf certs
saml_bridge/saml_bridge.py
Detection Content
- Sigma rules
detections/rules - KQL hunting queries
detections/hunting/kql - Audit SACL setup
detections/tools/Set-PtdAuditSacl.ps1
Other components
- Security assessor
- VPN gateway
- GlobalProtect portal
- Netskope tenant
- Endpoint state
- Identity provider
- Endpoint telemetry
- Gateway logs
- Defender
Connections 23
- Security assessor → VPN Fingerprinter: fingerprints
README.md - VPN Fingerprinter → TLS Cert Probe: probes certificates
vpn_fingerprint/vpn_fingerprint.py - VPN Fingerprinter → VPN gateway: probes gateway
README.md - Security assessor → GlobalProtect Recon: supplies portal
README.md - GlobalProtect Recon → GlobalProtect portal: discovers and signs in
README.md - VPN Fingerprinter → GlobalProtect Recon: guides next tool
README.md - Security assessor → Netskope Scout: supplies tenant
README.md - Netskope Scout → Netskope tenant: enumerates config
README.md - Security assessor → Cisco Profile Lens: inspects profile
README.md - Cisco Profile Lens → Editable posture profile: parses and edits
cisco_profile_lens/cisco_profile_lens.py - Cisco Profile Lens → Endpoint state: reads machine state
cisco_profile_lens/cisco_profile_lens.py - Editable posture profile → Cisco Profile Lens: supplies wrapper values
README.md - Security assessor → SAML Bridge: starts lab proxy
README.md - SAML Bridge → Lab CA and leaf certs: mints host certs
saml_bridge/saml_bridge.py - SAML Bridge → Identity provider: intercepts permitted hosts
saml_bridge/saml_bridge.py - GlobalProtect Recon → SAML Bridge: uses optional proxy
README.md - Defender → Sigma rules: deploys detections
README.md - Defender → KQL hunting queries: runs hunts
README.md - Audit SACL setup → Endpoint telemetry: enables audit events
README.md - Sigma rules → Endpoint telemetry: detects client access
README.md - KQL hunting queries → Endpoint telemetry: hunts DPAPI activity
README.md - Sigma rules → Gateway logs: detects OpenConnect defaults
README.md - Defender → Gateway logs: reviews signals
README.md