Configurazione della registrazione ZTNA per la risoluzione dei problemi

Introduzione

Questo documento descrive come raccogliere i log dettagliati di risoluzione dei problemi ZTA e quando abilitare passo dopo passo.

Premesse

Poiché le organizzazioni adottano sempre più spesso l'architettura ZTA (Zero Trust Architecture) per proteggere utenti, dispositivi e applicazioni, la risoluzione dei problemi di connettività e l'applicazione delle policy sono diventate più complesse. A differenza dei modelli tradizionali basati sul perimetro, ZTA si basa su più decisioni in tempo reale relative a identità, postura dei dispositivi, contesto di rete e motori di policy basati su cloud. Quando si verificano dei problemi, i log di alto livello sono spesso insufficienti per individuare la root cause.

La raccolta di informazioni dettagliate sul livello ZTA svolge un ruolo critico per ottenere una visibilità completa del comportamento dei client, della valutazione delle policy, dell'intercettazione del traffico e delle interazioni con i servizi cloud. Queste tracce consentono ai tecnici di andare oltre la risoluzione dei problemi basata sui sintomi e di analizzare la sequenza esatta degli eventi che portano ad errori di accesso, peggioramento delle prestazioni o risultati imprevisti delle policy. 

Raccolta dei log

Controlli preliminari prima di aprire una richiesta TAC

Questi controlli preliminari consentono al team TAC di identificare il problema in modo più efficiente. L'invio di queste informazioni ai tecnici consente di risolvere il problema il più rapidamente possibile:

• Qual è il problema e quanti utenti ne sono interessati?

• Quali sono i sistemi operativi e le versioni interessati?

• Il problema è coerente o intermittente? Se intermittente, è specifico dell'utente o diffuso?

• Il problema è iniziato dopo una modifica o è presente dopo la distribuzione?

• Ci sono trigger noti?

• È disponibile una soluzione alternativa?

Log da recuperare

• Pacchetto DART

• Registri modalità traccia debug ZTNA

• Wireshark capture (tutte le interfacce, incluso il loopback)

• Messaggi di errore osservati

• Timestamp del problema

• Schermata dello stato del modulo CSC ZTA

• Nome utente dell'utente interessato

Nelle sezioni seguenti viene descritto come attivare e raccogliere questi log in dettaglio.

Abilita modalità di traccia debug ZTNA

Creare un file denominato logconfig.json con i seguenti dettagli:

{ "global": "DBG_TRACE" }

Dopo aver creato il file, posizionarlo nella posizione appropriata in base al sistema operativo:

• Windows: C:\ProgramData\Cisco\Cisco Secure Client\ZTA

• macOS:/opt/cisco/secureclient/zta

Aumentare le dimensioni del registro ZTA nel Visualizzatore eventi

Windows

• UtilizzareWindows + Rper aprire la finestra di Run Search scrittura services.msc e premere Invio.
• Individuare il servizio Cisco Secure Client - Zero trust Access Agent e fare clic su Restart. Al termine, verificare lo stato del modulo CSC ZTA per confermare che è attivo.

MacOS

Stop Service.

sudo "/opt/cisco/secureclient/zta/bin/Cisco Secure Client - Zero Trust Access.app/Contents/MacOS/Cisco Secure Client - Zero Trust Access" uninstall

Start Service.

open -a "/opt/cisco/secureclient/zta/bin/Cisco Secure Client - Zero Trust Access.app"

Abilita registrazione KDF, acquisizione pacchetti, modalità di debug Duo e bundle Dart

Windows 

Aprire un CMD con privilegi di amministratore ed eseguire il comando seguente:

"%ProgramFiles(x86)%\Cisco\Cisco Secure Client\acsocktool.exe" -sdf 0x400080152

• Scaricare DebugView da SysInternal per acquisire il log KDF.
• Esegui DebugViewcome administratore abilita le opzioni di menu successive:
• Fare clic su Cattura.
  • Segno Di Spunta Capture Kernel.
  • Segno Di Spunta  Enable Verbose Kernel Output.
• Options
  • Segno Di Spunta  Clock Time.
  • Segno Di Spunta Show Milliseconds.

• Riavviare il servizio client dal prompt dell'amministratore:

net stop csc_vpnagent && net start csc_vpnagent

• Se net stop csc_vpnagent && net start csc_vpnagentnon funziona, riavviare Cisco Secure Clientil servizio da services.msc.

• Abilitare Duo in modalità di debug 

• Inizio Wireshark Capture.

• Selezionare tutte le interfacce e avviare l'acquisizione del pacchetto.

• Riprodurre il problema, salvare KDF LogsWireshark Capturee quindi seguire i passaggi per acquisire DART Bundle.
• Aprire Cisco Secure Client Diagnostics & Reporting Tool (DART)con privilegi di amministratore.

• Fare clic su Custom.
  • Includi System Information Extensivee Network Connectivity Test.

• Per interrompere la registrazione KDF in Windows, utilizzare il comando seguente: 

"%ProgramFiles(x86)%\Cisco\Cisco Secure Client\acsocktool.exe" -cdf

Comandi di Windows Powershell per abilitare e disabilitare, è necessario eseguirlo come amministratore:

#Enable ZTNA Logs
New-Item -Path "C:\ProgramData\Cisco\Cisco Secure Client\ZTA\logconfig.json" -ItemType "file" -Value '{"global" : "DBG_TRACE"}'
Limit-EventLog -LogName "Cisco Secure Client - Zero Trust Access" -MaximumSize 2240000KB
& "C:\Program Files (x86)\Cisco\Cisco Secure Client\acsocktool.exe" -sdf 0x400080152
Restart-Service csc_vpnagent
Restart-Service csc_zta_agent

#Disable ZTNA Logs
Remove-Item -Path "C:\ProgramData\Cisco\Cisco Secure Client\ZTA\logconfig.json" 
Limit-EventLog -LogName "Cisco Secure Client - Zero Trust Access" -MaximumSize 6400KB
& "C:\Program Files (x86)\Cisco\Cisco Secure Client\acsocktool.exe" -cdf 0x400080152
Restart-Service csc_vpnagent
Restart-Service csc_zta_agent

MacOS

Aprire terminal e seguire la catena di comandi successiva per abilitare la registrazione KDF su MacOS:

• Stop Service.

sudo "/opt/cisco/secureclient/bin/Cisco Secure Client - AnyConnect VPN Service.app/Contents/MacOS/Cisco Secure Client - AnyConnect VPN Service" uninstall

• Enable Flag.

echo debug=0x400080152 | sudo tee /opt/cisco/secureclient/kdf/acsock.cfg

• Start Service.

open -a "/opt/cisco/secureclient/bin/Cisco Secure Client - AnyConnect VPN Service.app"

• Abilitare Duo in modalità di debug.

• Inizio Wireshark Capture.

• Selezionare tutte le interfacce e avviare l'acquisizione del pacchetto.

• Riprodurre il problema, salvare KDF LogsWireshark Capturee quindi seguire i passaggi per acquisire DART Bundle.
• Aprire il Cisco Secure Client - DART.

• Selezionare le opzioni successive:
  • Include Legacy - Cisco AnyConnect Secure Mobility Client Logs.
  • Include System Logs.
• Fare clic su  Run.

Informazioni correlate

• Supporto tecnico Cisco e download
• Cisco Secure Access Help Center
• Guida alla progettazione di Cisco BASE
• Raccolta dei log KDF per Secure Client su Windows e MacOS

Cronologia delle revisioni

Revisione	Data di pubblicazione	Commenti
2.0	30-Mar-2026	Testo alternativo e formattazione aggiornati.
1.0	31-Dec-2025	Versione iniziale