コマンドラインガイド

App Trust Preview には、新しいアプリウィンドウで解析を開き、自動化、シェルスクリプト、セキュリティレビューのワークフロー、AI エージェントからレポートを書き出すためのコマンドラインインターフェイスがあります。対応ファイルは Mac 上でローカルに解析されます。

ヘルプから始める

インストール済みアプリのバイナリを Terminal から直接実行します。アプリ名にスペースが含まれるため、パスを引用符で囲みます。

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

ヘルプ出力には、現在のオプション、対応する書き出し形式、スキャンフィルタ、テスト検出コマンドが表示されます。

解析ウィンドウを開く

App Trust Preview で対象を解析し、アプリ内にレポートを表示する場合は --open を使います。

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

このコマンドは、メインアプリがすでに実行中でも解析を新しいウィンドウで開きます。監視対象フォルダに新しいアプリが追加されるたびに解析を表示するなど、自動化にも適しています。

以下の Launch Services 形式は使用しないでください。

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

対象を open -b に直接渡す方法は、macOS のプライバシーダイアログによってブロックされます。

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

--args で対象が渡されるのは、メインアプリがまだ実行されていない場合だけです。両方の問題を避けるには、App Trust Preview バイナリで --open を使ってください。

対応対象

CLI はアプリと同じ実用的なファイルタイプを受け取ります。

  • .app バンドル
  • .pkg インストーラパッケージ
  • .dmg ディスクイメージ
  • バイナリ実行ファイル
  • 実行可能スクリプト

レポートを書き出す

別のツールまたは AI エージェントがレポートを解析する場合は --export json を使います。人が読む場合は --export txt を使います。

'/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"

--output を省略すると、JSON またはテキストが標準出力に書き出されます。アプリ画面からは、記録やサポートメモ用に PDF と PNG 画像レポートも書き出せます。

スキャンフィルタ

既定では CLI は利用可能なすべてのスキャンを実行します。より速い自動化が必要な場合、テストキーを検出して小さなセットを要求できます。

'/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

特別な値 all はすべてのスキャンを要求します。識別情報は常に含まれ、App Trust Preview は必要な依存スキャンを自動で追加します。

許可パス

標準のアプリフォルダ以外で自動化を使う前に、App Trust Preview の設定を開いて許可パスを選択します。対象が存在する可能性のあるフォルダを読み取りアクセス付きで追加します。/Applications はすでに読み取り専用でアクセスできます。

  • ダウンロードしたアプリ、インストーラ、ディスクイメージ、バイナリ、スクリプトがそこに保存される場合は ~/Downloads を追加します。
  • ユーザーごとのアプリをそこに保存している場合は ~/Applications を追加します。
  • 自動化がファイルを保存する必要がある場合は、読み書きアクセスを持つレポート出力フォルダを追加します。

対象または出力パスにアクセスできない場合、CLI は同じ設定パネルへ案内する説明を出力します。

AI エージェントで使う

App Trust Preview は、検査対象ソフトウェアを第三者へアップロードせずに AI エージェントへローカル証拠を提供できます。最も確実な手順は、エージェントに --help で現在の CLI を学習させ、書き出しフラグを推測させるのではなく標準出力からレポートを読ませることです。

  1. App Trust Preview の設定を開き、許可パスを選択します。
  2. インストール済みアプリ用に /Applications を残します。これはすでに読み取り専用で利用できます。
  3. ~/Downloads または ~/Applications に対象がある場合、それらのフォルダを読み取りアクセス付きで追加します。
  4. エージェントにファイルを保存させる場合だけ、読み書きアクセスを持つレポートフォルダを追加します。
  5. エージェントに '/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --help を実行させ、オプション選択の前に stdout のヘルプテキストを読ませます。
  6. 具体的な対象を検査し、stdout からレポートを読むよう依頼します。--json 引数は、書き込み許可が必要な書き出しパスへ CLI を進める可能性があるため使わないよう伝えます。
  7. JSON またはテキストファイルを保存したい場合は、明示的に書き込み可能な出力フォルダを与え、--help に記載された書き出しオプションを使うよう伝えます。
まず '/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --help を実行し、stdout を読んでください。
そこに記載されたオプションだけを使ってください。
レポート出力は stdout を優先してください。
レポート書き出しに --json を使わないでください。
書き込み可能な出力フォルダを私が指定しない限り、レポートファイルを書き込まないでください。

有用な AI への指示は、フォルダ内の各対象について、識別情報、署名、公証、サンドボックス、プライバシー要求、保存済みのアクセス許可状況、パッケージ内容、ヘルパーの安全性、ネットワークアクセス、実行ファイルハッシュ、VirusTotal レポートリンク、通常と異なる技術指標を確認するよう依頼するものです。