Guida a SWG bar CLI

SWG bar include uno strumento nativo da riga di comando (swgbar) integrato all’interno di /Applications/SWGBar.app. Offre le stesse funzionalità di monitoraggio e ispezione in tempo reale dell’app per la barra dei menu di macOS, consentendoti di esaminare i certificati TLS, rilevare l’intercettazione HTTPS e gestire il bypass SWG direttamente da Terminale o tramite script.

Configurazione della CLI

Dopo aver installato SWG bar, il file binario si trova all’interno del pacchetto dell’applicazione. Puoi eseguirlo direttamente, aggiungere un alias alla configurazione della tua shell (~/.zshrc o ~/.bashrc), oppure creare un collegamento simbolico nel tuo PATH:

# Opzione 1: Esegui direttamente dal pacchetto dell'applicazione
/Applications/SWGBar.app/Contents/MacOS/swgbar --help

# Opzione 2: Aggiungi un alias al profilo della shell (~/.zshrc o ~/.bashrc)
alias swgbar="/Applications/SWGBar.app/Contents/MacOS/swgbar"

# Opzione 3: Crea un collegamento simbolico in /usr/local/bin (consigliato per l'accesso globale)
sudo ln -s /Applications/SWGBar.app/Contents/MacOS/swgbar /usr/local/bin/swgbar

# Verifica l'installazione e la versione
swgbar version

Aggiungi --json a qualsiasi comando per ottenere un output strutturato in formato JSON, ideale per l’elaborazione con jq o in flussi di automazione.

Metriche generali, domini e certificati

Visualizza i dati in tempo reale e le evidenze dei certificati identici a quelli mostrati nella barra dei menu:

# Mostra la percentuale globale di ispezione HTTPS, la suddivisione per stato e i certificati principali
swgbar overview

# Elenca i domini osservati con filtri opzionali e paginazione
swgbar domains list
swgbar domains list --status confirmed --page 1 --page-size 20
swgbar domains list --search <keyword> --bypass active

# Visualizza i dettagli di connessione TLS e certificati per uno specifico dominio
swgbar domains detail <domain>

# Elenca i cluster di certificati e visualizza i dettagli per un certificato specifico
swgbar certificates list
swgbar certificates list --status suspected
swgbar certificates detail "<certificate-name>"

Verifica dei domini e gestione del bypass SWG

Esegui verifiche TLS in tempo reale su qualsiasi hostname o gestisci le regole di bypass SWG a livello di dominio:

# Verifica un dominio su richiesta per valutare l'attendibilità del certificato e l'ispezione TLS
swgbar probe <domain>

# Controlla lo stato corrente del bypass SWG e le regole attive
swgbar bypass status

# Attiva, alterna, disattiva o azzera il bypass SWG per un dominio
swgbar bypass enable <domain>
swgbar bypass toggle <domain>
swgbar bypass disable <domain>
swgbar bypass clear

Estensione browser e preferenze dell’app

Verifica la connettività dell’estensione del browser, sospendi o riprendi il monitoraggio in background e configura le impostazioni dell’app:

# Verifica lo stato di connessione dell'estensione Chrome
swgbar plugins status
swgbar plugins check

# Controlla, sospendi o riprendi il monitoraggio in background
swgbar monitoring status
swgbar monitoring pause
swgbar monitoring resume

# Controlla lo stato della licenza, verifica aggiornamenti e modifica lingua o aspetto
swgbar license status
swgbar updates check
swgbar language get
swgbar language set <en|zh-Hans|zh-Hant|ja|ko>
swgbar appearance get
swgbar appearance set <system|light|dark>

Comandi principali

Comando	Descrizione
swgbar overview	Mostra la percentuale di ispezione HTTPS, le statistiche per stato e i certificati di intercettazione
swgbar domains list	Elenca i domini osservati con filtri per --search, --status, --bypass, --page e --page-size
swgbar domains detail <domain>	Mostra metadati di connessione, evidenze della catena di certificati e stato di bypass
swgbar certificates list	Elenca i cluster di certificati con opzioni di filtro --search e --status
swgbar certificates detail "<certificate-name>"	Mostra emittente, periodo di validità, impronta digitale SHA-256 e domini associati
swgbar bypass <status|enable|disable|toggle|clear>	Visualizza o gestisce le regole di bypass SWG per dominio
swgbar probe <domain>	Esegue una verifica TLS su richiesta e la valutazione del certificato per un dominio
swgbar plugins <status|check>	Verifica la connettività con l’estensione associata del browser
swgbar monitoring <status|pause|resume>	Controlla, sospende o riprende il monitoraggio di rete in background
swgbar license <status|activate|deactivate>	Visualizza o gestisce lo stato di attivazione della licenza
swgbar updates check	Controlla la disponibilità di aggiornamenti software
swgbar language <get|set>	Visualizza o imposta la lingua dell’interfaccia (en, zh-Hans, zh-Hant, ja, ko)
swgbar appearance <get|set>	Visualizza o imposta il tema visivo (system, light, dark)

Per integrare SWG bar con assistenti IA, consulta la guida a MCP. Per comprendere come vengono valutate le evidenze dei certificati, leggi come funziona SWG bar.