Guide de ligne de commande

App Trust Preview inclut une interface en ligne de commande pour ouvrir des analyses dans de nouvelles fenêtres de l’app et exporter des rapports depuis l’automatisation, des scripts shell, des processus de revue de sécurité et des agents IA. Elle analyse les fichiers pris en charge localement sur votre Mac.

Commencez par l’aide

Exécutez directement depuis Terminal le binaire de l’app installée. Mettez le chemin entre guillemets, car le nom de l’app contient des espaces.

'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --help

La sortie d’aide liste les options actuelles, les formats d’exportation pris en charge, le filtrage des analyses et les commandes de découverte de tests.

Ouvrir une fenêtre d’analyse

Utilisez --open pour demander à App Trust Preview d’analyser une cible et d’afficher le rapport dans l’app.

'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --open "/Volumes/Stats/Stats.app"

La commande ouvre l’analyse dans une nouvelle fenêtre, même si l’app principale est déjà en cours d’exécution. Elle convient donc à l’automatisation, par exemple pour afficher une analyse chaque fois qu’une nouvelle app est ajoutée à un dossier surveillé.

N’utilisez aucune des formes Launch Services suivantes.

open -b com.apptrustpreview.app /Volumes/Stats/Stats.app

La transmission directe de la cible à open -b est bloquée par une boîte de dialogue de confidentialité de macOS.

open -b com.apptrustpreview.app --args /Volumes/Stats/Stats.app

L’utilisation de --args ne transmet la cible que lorsque l’app principale n’est pas déjà en cours d’exécution. Utilisez le binaire App Trust Preview avec --open pour éviter ces deux problèmes.

Si la version Mac App Store ne peut pas transmettre la cible, installez ou mettez à jour le script d'inspection facultatif depuis l'app principale, puis réessayez.

Démarrer avec les détails du rapport dépliés

Lancez l'app avec --expand-details pour afficher les rapports avec les sections de détails dépliées. Utilisez cette option dans une commande de lancement distincte. --open accepte uniquement le chemin de sa cible.

'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --expand-details

Cibles prises en charge

La CLI accepte les mêmes types de fichiers pratiques que l’app.

  • Bundles .app
  • Paquets installateurs .pkg
  • Images disque .dmg
  • Exécutables binaires
  • Scripts exécutables

Exporter des rapports

Utilisez --export json lorsqu’un autre outil ou agent IA doit analyser le rapport. Utilisez --export txt lorsqu’une personne doit le lire.

'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --export json --target "/Applications/Example.app" --output "$HOME/Desktop/example-report.json"
'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --export txt --target "$HOME/Downloads/Example.pkg"

Omettez --output pour écrire JSON ou texte sur la sortie standard. Ces rapports incluent les découvertes de sécurité, les vérifications de livraison des mises à jour, les détails de compatibilité, l’historique des téléchargements et les métadonnées de fichiers. L’interface de l’app peut aussi exporter des rapports PDF et image PNG pour les archives et notes d’assistance.

Choisir le niveau de détail des preuves JSON

Les exports JSON utilisent --evidence summary par défaut. Ajoutez --evidence full pour inclure la sortie brute des commandes dans le rapport JSON.

'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --export json --target "/Applications/Example.app" --evidence full

Vérifiez les rapports avant de les partager. Les URL réseau sont exportées sans modification et peuvent contenir des valeurs de requête ou des fragments privés.

Valider un rapport JSON enregistré

Utilisez --validate-report pour vérifier la structure et la cohérence interne d'un rapport JSON enregistré sans analyser à nouveau la cible. Un rapport valide ne prouve pas que le logiciel inspecté est sûr.

'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --validate-report "$HOME/Desktop/example-report.json"
'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --validate-report "$HOME/Desktop/example-report.json" --json

Ajoutez --json pour obtenir valid, issueCount et issues au format JSON. Cette option est prise en charge pour la validation des rapports et la découverte des tests. Pour exporter un rapport, utilisez --export json.

Enregistrer une app au format APP, ZIP ou DMG

Utilisez --save-app pour enregistrer le paquet de l'app lui-même. Choisissez app, zip ou dmg et indiquez --target et --output.

'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --save-app zip --target "/Applications/Example.app" --output "$HOME/Desktop/Example.zip"

La source doit être un paquet .app. Utilisez une nouvelle destination avec l'extension correspondante .app, .zip ou .dmg dans un dossier existant accessible en écriture. La destination ne peut pas se trouver dans l'app source ni dans le paquet App Trust Preview en cours d'exécution.

Dans la version Mac App Store, installez ou mettez à jour l'assistant facultatif AppTrustPreviewInspect depuis l'app principale avant d'enregistrer des apps. La version Setapp utilise son assistant intégré.

Filtrage des analyses

Par défaut, la CLI exécute toutes les analyses disponibles. Vous pouvez découvrir les clés de tests et demander un ensemble plus petit quand une automatisation plus rapide est nécessaire.

'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --list-tests
'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --list-tests --json
'/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --export json --target "/Applications/Example.app" --tests signature,notarization,privacyAccesses

La valeur spéciale all demande toutes les analyses. L’identité est toujours incluse et App Trust Preview ajoute automatiquement les analyses dépendantes requises.

Chemins autorisés

Ouvrez Réglages App Trust Preview et choisissez Chemins autorisés avant d’utiliser l’automatisation hors des dossiers d’apps par défaut. Ajoutez les dossiers où les cibles peuvent se trouver avec un accès en lecture. /Applications dispose déjà d’un accès en lecture seule.

  • Ajoutez ~/Downloads si les apps, installateurs, images disque, binaires ou scripts téléchargés y sont stockés.
  • Ajoutez ~/Applications si vous y conservez des apps utilisateur.
  • Ajoutez un dossier de sortie de rapports avec accès en lecture et écriture si l’automatisation doit y enregistrer des fichiers.

Si une cible ou un chemin de sortie est inaccessible, la CLI imprime une aide qui renvoie au même panneau de Réglages.

Gérer les sorties et les codes de sortie

Lisez les rapports et les résultats de validation depuis stdout, et les messages d'erreur depuis stderr. Pour l'exportation, la validation, l'enregistrement d'apps et l'ouverture d'une cible, le code de sortie 0 indique la réussite de la commande, 1 indique l'échec d'une opération ou des problèmes de validation, et 2 indique des arguments non valides ou un rapport illisible ou mal formé. Une exportation réussie ne signifie pas que le logiciel est sûr.

Utiliser avec des agents IA

App Trust Preview peut fournir des preuves locales à un agent IA sans téléverser le logiciel inspecté vers un tiers. Le processus le plus fiable consiste à faire découvrir la CLI actuelle à l’agent avec --help, puis à lui faire lire la sortie du rapport depuis la sortie standard au lieu de deviner les options d’exportation.

  1. Ouvrez Réglages dans App Trust Preview et choisissez Chemins autorisés.
  2. Conservez /Applications pour les apps installées. Il est déjà disponible en lecture seule.
  3. Ajoutez ~/Downloads ou ~/Applications avec accès en lecture lorsque ces dossiers contiennent des cibles.
  4. Ajoutez un dossier de rapports avec accès en lecture et écriture uniquement lorsque l’agent doit y enregistrer des fichiers.
  5. Dites à l’agent d’exécuter '/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --help et de lire le texte d’aide depuis stdout avant de choisir des options.
  6. Demandez à l'agent d'inspecter des cibles précises avec --export json --target <path> et de lire le rapport depuis stdout. Omettez --output sauf si un fichier enregistré est nécessaire.
  7. Si vous voulez vraiment des fichiers JSON ou texte enregistrés, donnez à l’agent un dossier de sortie explicitement accessible en écriture et dites-lui d’utiliser l’option d’exportation documentée dans --help.
Exécute d’abord '/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --help et lis stdout.
Utilise uniquement les options qui y sont documentées.
Préfère la sortie du rapport dans stdout.
N’utilise pas --json pour exporter le rapport.
N’écris pas de fichiers de rapport sauf si je fournis un dossier de sortie avec accès en écriture.

Une instruction utile pour l’IA consiste à demander l’identité, la validité de la signature et de l’horodatage, la notarisation, la sécurité de livraison des mises à jour, le sandbox, les demandes de confidentialité, les décisions d’autorisation enregistrées, la compatibilité de l’app et de ses composants, la taille logique et sur disque, la provenance du téléchargement, le contenu des paquets, la sécurité des assistants, l’accès réseau, les hachages d’exécutables, les liens de rapports VirusTotal et les indicateurs techniques inhabituels pour chaque cible d’un dossier.