Abilitazione della registrazione massima del debug sul modulo SWG di AnyConnect

Introduzione

Questo documento descrive come abilitare la registrazione massima del debug sul modulo Secure Web Gateway (SWG) per AnyConnect e Cisco Secure Client (CSC).

Casi di utilizzo per l'abilitazione della registrazione di massimo debug

Abilitare la registrazione di debug massima sul modulo SWG durante la risoluzione di problemi quali:

• Problemi di hotspot tramite Captive Portal
• L'elenco di esclusione del dominio esterno non viene applicato
• Problemi intermittenti di prestazioni DNS o Web

Abilitazione della registrazione di debug massima su AnyConnect 4.10 MR7, CSC 5.0 MR2 o versioni precedenti

Se si usa AnyConnect 4.10 MR7, CSC 5.0 MR2 o una versione precedente, attenersi alla seguente procedura. Per impostazione predefinita, la registrazione massima del debug non è abilitata e la configurazione non è consentita tramite il dashboard Umbrella o l'ASA. È necessario aggiungere manualmente"logLevel": "1"allorgConfig'oggetto nelSWGConfig.jsonfile. Se si usa la versione più recente di AnyConnect o Cisco Secure Client, saltare questa sezione.

Posizione di SWGConfig.json

• Windows (AnyConnect):
  

  C:\ProgramData\Cisco\Cisco AnyConnect Secure Mobility Client\Umbrella\SWG\

• Windows (Secure Client):
  

  C:\ProgramData\Cisco\Cisco Secure Client\Umbrella\SWG\

• macOS (AnyConnect):
  

  /opt/cisco/anyconnect/umbrella/swg/

• macOS (client protetto):
  

  /opt/cisco/secureclient/umbrella/swg/

Rendi permanente la registrazione di debug

Il file modificatoSWGConfig.jsonrimane solo fino alla successiva sincronizzazione API da parte del modulo Cisco AnyConnect Umbrella. Per rendere persistente la configurazione e impedire che venga sovrascritta dalla sincronizzazione API, distribuire unswg_org_config.flagfile nellaUmbrella/datacartella.

1. Creazione del file dei flag

   • Creare un nuovo file denominatoswg_org_config.flagnella cartella Dati ombrello. L'estensione del file deve essere .flag.



   • Windows (AnyConnect):

   • C:\ProgramData\Cisco\Cisco AnyConnect Secure Mobility Client\Umbrella\data\swg_org_config.flag

   • Windows (Secure Client):

   • C:\ProgramData\Cisco\Cisco Secure Client\Umbrella\data\swg_org_config.flag

   • macOS (AnyConnect):

   • /opt/cisco/anyconnect/umbrella/data/swg_org_config.flag

   • macOS (client protetto):

   • /opt/cisco/secureclient/umbrella/data/swg_org_config.flag

2. Copia e modifica del contenuto

   • Copiare il contenuto dellorgConfig'oggetto dalSWGConfig.jsonfile alswg_org_config.flagfile.

   • Aggiungi con"logLevel": "1".

   • Ad esempio:

     {
     "exceptionList": [
     "www.example.com",
     "smh.com.au",
     "*.smh.com.au",
     "www.blue.com",
     "*.www.blue.com",
     "146.112.133.72"
     // ...additional entries...
     ],
     "failOpen": 1,
     "logLevel": "1",
     "swgAnycast": "146.112.255.50",
     "swgDomain": "swg-url-proxy-https.sigproxy.qq.opendns.com",
     "swgEchoService": "http://www.msftconnecttest.com/connecttest.txt"
     }

   • Assicurarsi che il file di flag inizi con{ "exceptionList": [...]e termini con "SWGEchoService": "http://www.msftconecttest.com/connecttest.txt"}.

   • Evitare di copiare righe in eccesso prima o dopo l'oggetto.

   • La copia non corretta di linee qualiidentity,deviceIdo adUserIDpuò compromettere la funzionalità SWG.
     
     

   Esempio non corretto: Il file di contrassegno contiene chiavi qualiidentity,deviceIdo dUserID precedenti
   

   Esempio corretto: Il file di contrassegno inizia con { "exceptionList":
   14970100184724

3. Riavvia servizio

   • Riavviare il servizio Cisco AnyConnect Secure Mobility Agent/Secure Client, riavviare il computer o connettere e disconnettere la VPN.
     
     

4. Verifica della configurazione

   • Dopo il riavvio o la connessione/disconnessione VPN, aprire il file perSWGConfig.jsonconfermare l'impostazione del livello massimo del registro di debug SWG. Una volta configurata, questa voce viene visualizzata nel file:

     "logLevel": "1"

Verifica e fornitura del numero massimo di log di debug

Verifica di Windows

1. Aprire il Visualizzatore eventi di Windows.

2. Cercare righe di registro simili a quelle illustrate negli esempi seguenti. Ciò indica che la registrazione di Max Debug è stata abilitata.
   
   Esempio 1:
   

   BRIDGE | Thread 1d18 | Connection : Resolved IP from 'swg-url-proxy-https.sigproxy.qq.opendns.com' is 146.112.57.199
   THREAD | Thread 1d18 | SetGUID '959bfe4d6fba87a65b433321c6748d761d9492cb'

   Esempio 2: Tutte le richieste Web in fase di inoltro vengono registrate. Le richieste Web che ignorano AnyConnect SWG in base all'elenco dei domini interni/esterni non vengono registrate.

   LISTEN | Thread 1d18 | Connection : Hostnames from KDF are login.live.com

3. Utilizzare il comando PowerShell per convertire il numero massimo di registri eventi di debug (.evtx) in txt:

   Get-WinEvent -Path C:\Desktop\Umbrella.evtx | Format-Table -AutoSize | Out-File C:\Desktop\Umbrella.txt -append -width 750

Verifica macOS

In Mac OSX, la registrazione di debug può essere visualizzata con questo comando (è possibile utilizzare il comando grep o scriverlo in txt).

1. Eseguire il comando:

   >log show --predicate 'subsystem contains "com.cisco.anyconnect.swg" || senderImagePath endswith "acswgagent"' --debug --info --last 2d | grep -i purple

   • Output di esempio durante l'esplorazione di purple.com mentre è attivata la registrazione di Max Debug:

     2022-09-19 10:51:15.627229+1000 0x16b121 Default 0x0 98970 0 acswgagent: Connection : Hostnames from KDF are purple.com.

2. Il bundle DART di AnyConnect include il numero massimo di log di debug. Dopo aver verificato l'abilitazione, ricreare il problema, registrare l'indicatore orario, l'esperienza utente e il dominio in questione e fornire queste informazioni insieme al pacchetto DART da supportare.

Note aggiuntive

• La registrazione di debug massima genera registri dettagliati. Configurare le dimensioni del registro del modulo di sicurezza Umbrella Roaming nel Visualizzatore eventi di Windows in modo da contenere registri di grandi dimensioni, in particolare per problemi intermittenti.
  360056784112
• Rimuovere o rinominare il file perswg_org_config.flagdisattivare la registrazione di Max Debug al termine della risoluzione dei problemi.

Abilita registrazione di debug massima su CSC 5.0 MR3 e AC 4.10 MR8 o versioni successive

Panoramica

A partire da CSC 5.0 MR3 e AC 4.10 MR8, l'abilitazione della registrazione del debug utilizza un processo più semplice.

Modifiche

• Copiare il file (con contenuto statico) nellaSWGConfigOverride.jsoncartella SWG per abilitare la registrazione di debug.
• Non è necessario copiare o modificare l'orgConfigdaSWGConfig.json. Il contenuto di questo file non cambierà org in org.
• Nessuna dipendenza dal modulo DNS per eseguire la sincronizzazione della configurazione o la lettura dal file di flag. Il file nonSWGConfig.jsonviene modificato.

Abilita registrazione debug

Il valore config in SWGConfigOverride.json ha la precedenza sul valore (se presente) inSWGConfig.json. The SWGConfigOverride.json può contenere ed eseguire l'override solo di due configurazioni: logLevel (per abilitare/disabilitare il log di debug) e autotuning (per abilitare/disabilitare l'autotuning del buffer di invio).

1. Per abilitare la registrazione del debug, copiareSWGConfigOverride.jsonil contenuto:

   {"logLevel": "1"}

   • Per abilitare sia il log di debug che il tuning automatico, utilizzare:

     {"logLevel": "1", "autotuning": "1"}

2. Posizionate SWGConfigOverride.json nella cartella SWG:
   
   

• Windows (AnyConnect):

  C:\ProgramData\Cisco\Cisco AnyConnect Secure Mobility Client\Umbrella\SWG\

• Windows (Secure Client):

  C:\ProgramData\Cisco\Cisco Secure Client\Umbrella\SWG\

• macOS (AnyConnect):

  /opt/cisco/anyconnect/umbrella/swg/

• macOS (client protetto):

  /opt/cisco/secureclient/umbrella/swg/

3. Riavviare il servizio SWG o Umbrella oppure riavviare il sistema.

• macOS: Arrestare e avviare l'agente AnyConnect o Secure Client.
• Windows: Riavviare, arrestare o avviare il servizio Gateway Web sicuro (acswgagent in 4.10.x build /csc_swgagent in 5.x build) tramite lo snap-in MMC Servizi (Start > Esegui > Servizi.msc).
  
  
  

  Nota: Il metodo precedente per l'abilitazione della registrazione del debug è ancora supportato e può ancora essere seguito ed è l'unica opzione disponibile per i client con più di 5.0 MR3 o 4.10 MR8.

Note operative e di configurazione

• Nel fileSWGConfig.jsonviene fatta distinzione tra maiuscole e minuscole. Utilizzare"logLevel": "1"tra virgolette.
• IllogLevelvalore è una stringa 1, non un intero, quindi deve essere "1" con virgolette doppie.
• Il fileswg_org_config.flagdeve avere un'.flagestensione, non .txtun'estensione.
• Il log di debug massimo genera log estremamente dettagliati. Abilitare la registrazione massima del debug solo se richiesto da un tecnico del supporto Umbrella.
• swg_org_config.flagIl file contiene un elenco statico dei domini ignorati e non viene sincronizzato con i domini esterni elencati in Dashboard > Distribuzioni > Gestione dominio.