Maximale foutopsporingslogboekregistratie inschakelen voor SWG-module

Inleiding

In dit document wordt beschreven hoe u een maximale foutopsporingslogboekregistratie kunt inschakelen voor de Secure Web Gateway (SWG)-module voor AnyConnect en Cisco Secure Client (CSC).

Use Cases voor het inschakelen van maximale debuglogging

Maximale foutopsporingslogboekregistratie in de SWG-module inschakelen bij het oplossen van problemen, zoals:

• Hotspotproblemen via Captive Portal
• Lijst met omleidingen voor externe domeinen is niet van toepassing
• Intermitterende DNS- of webprestatieproblemen

Maximale foutopsporingsaanmelding inschakelen bij AnyConnect 4.10 MR7, CSC 5.0 MR2 of ouder

Als u AnyConnect 4.10 MR7, CSC 5.0 MR2 of een oudere versie gebruikt, voert u deze stappen uit. Standaard is maximale debug-logging niet ingeschakeld en is configuratie niet mogelijk via het Umbrella-dashboard of ASA. U moet handmatig toevoegen aan "logLevel": "1" het orgConfig object in het SWGConfig.json bestand. Als u de nieuwste versie van AnyConnect of Cisco Secure Client gebruikt, slaat u deze sectie over.

Locatie van SWGConfig.json

• Windows (AnyConnect):
  

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

• Windows (beveiligde client):
  

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

• macOS (AnyConnect):
  

  /opt/cisco/anyconnect/umbrella/swg/

• macOS (beveiligde client):
  

  /opt/cisco/secureclient/umbrella/swg/

Foutopsporingslogboekregistratie permanent maken

Het gewijzigde SWGConfig.json bestand blijft alleen behouden tot de volgende API-synchronisatie door de Cisco AnyConnect Umbrella-module. Als u deze configuratie wilt behouden en wilt voorkomen dat deze wordt overschreven door API-synchronisatie, implementeert u een bestand swg_org_config.flag in de map Umbrella/data.

1. Het vlaggenbestand maken

   • Maak een nieuw bestand met de naam swg_org_config.flag in de map Paraplugegevens. De bestandsextensie moet .flag.



   • Windows (AnyConnect):

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

   • Windows (beveiligde 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 (beveiligde client):

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

2. Inhoud kopiëren en wijzigen

   • Kopieer de inhoud van het orgConfig object van het SWGConfig.json bestand naar het swg_org_config.flag bestand.

   • Toevoegen met "logLevel": "1"tekst.

   • Voorbeeld:

     {
     "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"
     }

   • Zorg ervoor dat het vlaggenbestand begint met { "exceptionList": [...] en eindigt met "SWGEchoService": "http://www.msftconecttest.com/connecttest.txt"}.

   • Vermijd het kopiëren van extra regels voor of na het object.

   • Het onjuist kopiëren van regels zoals identity, deviceIdof kan SWG-functionaliteitadUserIDverbreken.
     
     

   Onjuist voorbeeld: het vlagbestand bevat sleutels zoals identity, deviceIdof dUserID voorafgaand aan de
   

   Correct voorbeeld: het vlagbestand begint met { "exceptionList":
   14970100184724

3. Service opnieuw starten

   • Start de Cisco AnyConnect Secure Mobility Agent/Secure Client-service opnieuw op, start het systeem opnieuw op of maak verbinding en verbreek de VPN-verbinding.
     
     

4. De configuratie verifiëren

   • Nadat u de VPN-verbinding opnieuw hebt gestart of hebt verbroken, opent u het SWGConfig.json bestand om te bevestigen dat het SWG max-foutopsporingslogniveau is ingesteld. Wanneer deze optie is geconfigureerd, wordt deze vermelding in het bestand weergegeven:

     "logLevel": "1"

Verificatie en maximaal aantal debuglogs opgeven

Windows-verificatie

1. Open Windows Event Viewer.

2. Kijk voor log lijnen vergelijkbaar met deze voorbeelden. Dit geeft aan dat de Max Debug-logboekregistratie is ingeschakeld.
   
   Voorbeeld 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'

   Voorbeeld 2: Elk webverzoek dat wordt benaderd, wordt geregistreerd. Webverzoeken waarbij AnyConnect SWG wordt omzeild volgens de lijst met interne/externe domeinen, worden niet geregistreerd.

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

3. Gebruik de opdracht PowerShell om max. foutopsporingslogboeken (.evtx) om te zetten in txt:

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

macOS-verificatie

Op Mac OSX kan de foutopsporingslogboekregistratie worden bekeken met deze opdracht (u kunt ze greppen of in txt schrijven).

1. Voer de opdracht uit:

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

   • Voorbeeld van uitvoer wanneer u op purple.com bladert terwijl Max Debug-logboekregistratie is ingeschakeld:

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

2. De AnyConnect DART-bundel bevat logs voor maximaal foutopsporing. Nadat u de activering hebt gecontroleerd, maakt u het probleem opnieuw, registreert u de tijdstempel, gebruikerservaring en het betreffende domein en verstrekt u deze informatie samen met de DART-bundel ter ondersteuning.

Aanvullende opmerkingen

• Maximale foutopsporingslogboekregistratie genereert uitgebreide logboeken. Configureer de grootte van het logboek van de Umbrella Roaming Security Module in Windows Event Viewer voor grote logboeken, vooral voor intermitterende problemen.
  360056784112
• Verwijder of wijzig de naam van het swg_org_config.flag bestand om de Max Debug-logboekregistratie uit te schakelen wanneer de probleemoplossing is voltooid.

Maximale foutopsporingsregistratie inschakelen op CSC 5.0 MR3 en AC 4.10 MR8 of hoger

Overzicht

Beginnend met CSC 5.0 MR3 en AC 4.10 MR8, maakt debug logging gebruik van een eenvoudiger proces.

Wijzigingen

• Kopieer het SWGConfigOverride.json bestand (met statische inhoud) naar de SWG-map om foutopsporingslogboekregistratie in te schakelen.
• Het is niet nodig om het formulier orgConfig te kopiëren of te wijzigen van SWGConfig.json. De inhoud van dit bestand verandert org niet in org.
• Geen afhankelijkheid van de DNS-module voor het uitvoeren van config-synchronisatie of lezen van het vlaggenbestand. Het bestand SWGConfig.json blijft onaangetast.

Debug-logboekregistratie inschakelen

De config-waarde in SWGConfigOverride.json heeft voorrang op de waarde (indien aanwezig) in SWGConfig.json. The SWGConfigOverride.json kan slechts twee configuraties bevatten en overschrijven: logLevel (om debug-logging in te schakelen/uit te schakelen) en autotuning (om de automatische afstemming van de verzendbuffer in/uit te schakelen).

1. Als u foutopsporingslogboekregistratie wilt inschakelen, kopieert uSWGConfigOverride.jsonmet de inhoud:

   {"logLevel": "1"}

   • Om zowel debug logging als autotuning in te schakelen, gebruikt u:

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

2. Plaats SWGConfigOverride.json in de map SWG:
   
   

• Windows (AnyConnect):

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

• Windows (beveiligde client):

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

• macOS (AnyConnect):

  /opt/cisco/anyconnect/umbrella/swg/

• macOS (beveiligde client):

  /opt/cisco/secureclient/umbrella/swg/

3. Start de SWG- of Umbrella-service opnieuw op of start het systeem opnieuw op.

• macOS: Stop en start de AnyConnect- of Secure Client-agent.
• Windows: Start of stop/start de Secure Web Gateway (een agent in 4.10.x bouwt /csc_sagent in 5.x bouwt) service via de MMC Services snap-in (Start > Uitvoeren > Services.msc).
  
  

Opmerking: De oudere methode voor het inschakelen van debug-logging wordt nog steeds ondersteund en kan nog steeds worden gevolgd en is de enige optie voor clients ouder dan 5.0 MR3 of 4.10 MR8.

Configuratie en operationele notities

• Het SWGConfig.json bestand is hoofdlettergevoelig. Gebruik dubbele "logLevel": "1" quotes.
• DelogLevelwaarde is een string 1, geen geheel getal, daarom moet het "1" zijn met dubbele aanhalingstekens.
• Het swg_org_config.flag bestand moet een .flag extensie hebben, niet .txtalleen.
• De max debug logging genereert extreem gedetailleerde logs. Maximale foutopsporingslogboekregistratie alleen inschakelen als een Umbrella Support-engineer daarom vraagt.
• Hetswg_org_config.flagbestand bevat een statische lijst van omzeilde domeinen en wordt niet gesynchroniseerd met externe domeinen die worden vermeld in Dashboard > Implementaties > Domeinbeheer.

Gerelateerde informatie

• Cisco Technical Support en downloads
• Cisco Secure Access Help Center
• Cisco SASE-ontwerphandleiding