コマンドラインガイド

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 を使ってください。

Mac App Store 版で対象を引き渡せない場合は、メインアプリから任意の検査スクリプトをインストールまたは更新して、もう一度お試しください。

レポートの詳細を展開して起動する

--expand-details を指定してアプリを起動すると、詳細セクションを展開した状態でレポートを表示できます。これは独立した起動コマンドとして使用してください。--open は対象のパスだけを受け付けます。

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

対応対象

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 画像レポートも書き出せます。

JSON の証拠情報の詳しさを選ぶ

JSON の書き出しでは、既定で --evidence summary が使用されます。--evidence full を追加すると、コマンドの生の出力を JSON レポートに含められます。

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

共有前にレポートを確認してください。ネットワーク URL は変更せずに書き出されるため、クエリ値やフラグメントに非公開情報が含まれる場合があります。

保存済みの JSON レポートを検証する

--validate-report を使うと、対象を再スキャンせずに、保存済み JSON レポートの構造と内部の整合性を確認できます。レポートが有効であっても、検査したソフトウェアが安全であることの証明にはなりません。

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

--json を追加すると、valid、issueCount、issues が JSON で返されます。このフラグはレポートの検証とテストの一覧取得に対応しています。レポートの書き出しには --export json を使用してください。

アプリを APP、ZIP、DMG として保存する

--save-app を使うと、アプリバンドル自体を保存できます。app、zip、dmg のいずれかを選び、--target と --output を指定してください。

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

保存元は .app バンドルである必要があります。既存の書き込み可能なフォルダ内に、形式に合った .app、.zip、.dmg 拡張子を持つ新しい保存先を指定してください。保存元のアプリ内や実行中の App Trust Preview バンドル内には保存できません。

Mac App Store 版では、アプリを保存する前にメインアプリから任意の AppTrustPreviewInspect ヘルパーをインストールまたは更新してください。Setapp 版は同梱のヘルパーを使用します。

スキャンフィルタ

既定では 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 は同じ設定パネルへ案内する説明を出力します。

出力と終了コードを処理する

レポートと検証結果は stdout から、エラーメッセージは stderr から読み取ってください。書き出し、検証、アプリの保存、対象を開く操作では、終了コード 0 はコマンドの成功、1 は操作の失敗または検証での問題検出、2 は無効な引数、読み取れないレポート、または不正な形式のレポートを示します。書き出しの成功はソフトウェアの安全性を意味しません。

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. エージェントに --export json --target <path> で特定の対象を検査し、stdout からレポートを読むよう依頼します。ファイルを保存する必要がなければ、--output は省略してください。
  7. JSON またはテキストファイルを保存したい場合は、明示的に書き込み可能な出力フォルダを与え、--help に記載された書き出しオプションを使うよう伝えます。
まず '/Applications/App Trust Preview.app/Contents/MacOS/App Trust Preview' --help を実行し、stdout を読んでください。
そこに記載されたオプションだけを使ってください。
レポート出力は stdout を優先してください。
レポート書き出しに --json を使わないでください。
書き込み可能な出力フォルダを私が指定しない限り、レポートファイルを書き込まないでください。

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