Guía de SWG bar CLI

SWG bar incluye una herramienta nativa de línea de comandos (swgbar) dentro de /Applications/SWGBar.app. Proporciona las mismas funciones que la aplicación de la barra de menús de macOS, lo que le permite auditar certificados TLS, evaluar la interceptación HTTPS y gestionar el bypass de SWG directamente desde Terminal o mediante scripts.

Configuración de la CLI

Tras instalar SWG bar, el ejecutable se encuentra dentro del paquete de la aplicación. Puede ejecutarlo directamente, definir un alias en su archivo de configuración de shell (~/.zshrc o ~/.bashrc), o crear un enlace simbólico en su PATH:

# Opción 1: Ejecutar directamente desde el paquete de la aplicación
/Applications/SWGBar.app/Contents/MacOS/swgbar --help

# Opción 2: Añadir un alias al perfil de la shell (~/.zshrc o ~/.bashrc)
alias swgbar="/Applications/SWGBar.app/Contents/MacOS/swgbar"

# Opción 3: Crear un enlace simbólico en /usr/local/bin (recomendado para acceso global)
sudo ln -s /Applications/SWGBar.app/Contents/MacOS/swgbar /usr/local/bin/swgbar

# Verificar la instalación y la versión
swgbar version

Añada --json a cualquier comando para obtener salidas estructuradas en formato JSON, idóneo para su procesamiento con jq o en flujos de automatización.

Métricas generales, dominios y certificados

Consulte los mismos datos en tiempo real y evidencias de certificados que se muestran en la barra de menús:

# Ver el porcentaje global de inspección HTTPS, desglose por estado y principales certificados
swgbar overview

# Listar dominios observados con filtrado opcional y paginación
swgbar domains list
swgbar domains list --status confirmed --page 1 --page-size 20
swgbar domains list --search <keyword> --bypass active

# Ver evidencias detalladas de conexión TLS y certificados para un dominio
swgbar domains detail <domain>

# Listar agrupaciones de certificados y consultar detalles de un certificado específico
swgbar certificates list
swgbar certificates list --status suspected
swgbar certificates detail "<certificate-name>"

Sondeo de dominios y gestión del bypass de SWG

Realice evaluaciones TLS en tiempo real para cualquier nombre de host o gestione las reglas de bypass de SWG por dominio:

# Sondear un dominio bajo demanda para evaluar la confianza del certificado y la inspección TLS
swgbar probe <domain>

# Consultar el estado actual del bypass de SWG y las reglas activas
swgbar bypass status

# Activar, alternar, desactivar o borrar las reglas de bypass de un dominio
swgbar bypass enable <domain>
swgbar bypass toggle <domain>
swgbar bypass disable <domain>
swgbar bypass clear

Extensión del navegador y preferencias de la aplicación

Compruebe la conectividad de la extensión del navegador, pause o reanude la monitorización en segundo plano y configure las preferencias:

# Comprobar el estado de conexión de la extensión complementaria de Chrome
swgbar plugins status
swgbar plugins check

# Comprobar, pausar o reanudar la monitorización en segundo plano
swgbar monitoring status
swgbar monitoring pause
swgbar monitoring resume

# Gestionar el estado de la licencia, buscar actualizaciones y cambiar idioma o apariencia
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>

Comandos frecuentes

Comando	Descripción
swgbar overview	Muestra el porcentaje de inspección HTTPS, estadísticas de estado y principales certificados interceptores
swgbar domains list	Lista los dominios observados con filtros para --search, --status, --bypass, --page y --page-size
swgbar domains detail <domain>	Muestra metadatos de conexión, evidencias de la cadena de certificados y estado de bypass
swgbar certificates list	Lista agrupaciones de certificados con filtros de --search y --status
swgbar certificates detail "<certificate-name>"	Muestra información del emisor, período de validez, huella digital SHA-256 y dominios asociados
swgbar bypass <status|enable|disable|toggle|clear>	Consulta o gestiona las reglas de bypass de SWG por dominio
swgbar probe <domain>	Realiza un sondeo TLS bajo demanda y evaluación de certificados para un dominio
swgbar plugins <status|check>	Comprueba la conectividad con la extensión complementaria del navegador
swgbar monitoring <status|pause|resume>	Consulta, pausa o reanuda la monitorización de red en segundo plano
swgbar license <status|activate|deactivate>	Consulta o gestiona el estado de activación de la licencia
swgbar updates check	Busca actualizaciones de la aplicación
swgbar language <get|set>	Consulta o cambia el idioma de la interfaz (en, zh-Hans, zh-Hant, ja, ko)
swgbar appearance <get|set>	Consulta o cambia el tema visual (system, light, dark)

Para integrar SWG bar con clientes de IA, consulte la guía de MCP. Para comprender cómo se evalúan las evidencias de certificados, lea cómo funciona SWG bar.