Guide de SWG bar CLI

SWG bar intègre un outil natif en ligne de commande (swgbar) directement au sein de /Applications/SWGBar.app. Il propose les mêmes fonctionnalités de surveillance et d’inspection en temps réel que l’application pour la barre des menus de macOS, vous permettant d’auditer les certificats TLS, d’évaluer l’interception HTTPS et de gérer le contournement SWG directement depuis Terminal ou via des scripts.

Configurer la CLI

Après avoir installé SWG bar, l’exécutable se situe à l’intérieur du paquet de l’application. Vous pouvez le lancer directement, définir un alias dans votre configuration de shell (~/.zshrc ou ~/.bashrc), ou créer un lien symbolique dans votre PATH :

# Option 1 : Exécuter directement depuis le paquet de l'application
/Applications/SWGBar.app/Contents/MacOS/swgbar --help

# Option 2 : Ajouter un alias dans votre profil de shell (~/.zshrc ou ~/.bashrc)
alias swgbar="/Applications/SWGBar.app/Contents/MacOS/swgbar"

# Option 3 : Créer un lien symbolique dans /usr/local/bin (recommandé pour un accès global)
sudo ln -s /Applications/SWGBar.app/Contents/MacOS/swgbar /usr/local/bin/swgbar

# Vérifier l'installation et la version
swgbar version

Ajoutez --json à n’importe quelle commande pour obtenir une sortie structurée en JSON, idéale pour le traitement avec jq ou l’automatisation.

Métriques générales, domaines et certificats

Consultez les données en temps réel et les preuves de certificats identiques à celles de l’application de la barre des menus :

# Afficher le taux global d'inspection HTTPS, la répartition par statut et les principaux certificats
swgbar overview

# Lister les domaines observés avec filtrage et pagination facultatifs
swgbar domains list
swgbar domains list --status confirmed --page 1 --page-size 20
swgbar domains list --search <keyword> --bypass active

# Afficher les preuves détaillées de connexion TLS et de certificat pour un domaine spécifique
swgbar domains detail <domain>

# Lister les groupes de certificats et consulter les détails d'un certificat donné
swgbar certificates list
swgbar certificates list --status suspected
swgbar certificates detail "<certificate-name>"

Analyser des domaines et gérer le contournement SWG

Effectuez des analyses TLS en temps réel pour n’importe quel nom d’hôte ou gérez les règles de contournement SWG par domaine :

# Analyser un domaine à la demande pour vérifier la confiance du certificat et l'inspection TLS
swgbar probe <domain>

# Consulter l'état actuel du contournement SWG et les règles actives
swgbar bypass status

# Activer, basculer, désactiver ou effacer le contournement SWG pour un domaine
swgbar bypass enable <domain>
swgbar bypass toggle <domain>
swgbar bypass disable <domain>
swgbar bypass clear

Extension de navigateur et préférences de l’application

Vérifiez la connectivité de l’extension de navigateur, suspendez ou reprenez la surveillance en arrière-plan, et configurez les préférences de l’application :

# Vérifier l'état de connexion de l'extension Chrome associée
swgbar plugins status
swgbar plugins check

# Vérifier, suspendre ou reprendre la surveillance en arrière-plan
swgbar monitoring status
swgbar monitoring pause
swgbar monitoring resume

# Consulter la licence, rechercher des mises à jour et modifier la langue ou l'apparence
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>

Commandes courantes

Commande	Description
swgbar overview	Affiche le pourcentage global d’inspection HTTPS, les statistiques de statut et les principaux certificats intercepteurs
swgbar domains list	Liste les domaines observés avec filtres --search, --status, --bypass, --page et --page-size
swgbar domains detail <domain>	Affiche les métadonnées de connexion, les preuves de la chaîne de certificats et l’état de contournement
swgbar certificates list	Liste les groupes de certificats avec filtres --search et --status
swgbar certificates detail "<certificate-name>"	Affiche l’émetteur, la période de validité, l’empreinte SHA-256 et les domaines associés
swgbar bypass <status|enable|disable|toggle|clear>	Interroge ou gère les règles de contournement SWG par domaine
swgbar probe <domain>	Effectue une analyse TLS à la demande et l’évaluation du certificat pour un domaine
swgbar plugins <status|check>	Vérifie la connectivité avec l’extension de navigateur associée
swgbar monitoring <status|pause|resume>	Vérifie, suspend ou reprend la surveillance réseau en arrière-plan
swgbar license <status|activate|deactivate>	Consulte ou gère l’état d’activation de la licence
swgbar updates check	Recherche les mises à jour logicielles disponibles
swgbar language <get|set>	Affiche ou définit la langue de l’interface (en, zh-Hans, zh-Hant, ja, ko)
swgbar appearance <get|set>	Affiche ou définit le thème d’apparence (system, light, dark)

Pour intégrer SWG bar avec des clients d’IA, consultez le guide MCP. Pour comprendre comment les preuves de certificats sont évaluées, lisez fonctionnement de SWG bar.