proxyman-certificates-recovery

Proxyman の証明書と復旧

証明書の役割、信頼、診断、リセットの対象範囲は分けて扱います。これらの操作により、macOS の信頼ストアが変更されたり、秘密鍵の情報が開示されたり、進行中の TLS 接続が中断されたり、Proxyman のデータが削除されたりする可能性があります。

該当するリファレンスを選択する

• 生成された Proxyman CA、自動／手動の信頼設定、カスタムルートのインポート、置換、削除、MCP、CLI の適用範囲については、ルート証明書を参照してください。
• TLS クライアント向け証明書、mTLS クライアント ID、PEM／DER／P12 のインポート、ホスト／ポートの照合、置換、CLI による自動化については、カスタムサーバー証明書とクライアント証明書を参照してください。
• Copy Debug Info、Debug Mode、Reset Network Proxy、データ／バックアップフォルダー、Factory Reset については、診断と復旧を参照してください。

タスクが複数の適用範囲にまたがる場合に限り、複数のリファレンスを参照してください。

現在の動作を確認する

1. インストール済みの Proxyman のバージョンと配布元を確認し、タスクが GUI、MCP、CLI のどれを使うものか特定します。
2. 現在の動作が重要な場合は、https://docs.proxyman.com/llms.txt を取得してから、選択した公式 .md ページを取得し、その公開 URL を引用します。
3. 正確なインターフェースの情報源として、インストール済みの UI、実行中の MCP スキーマ、またはインストール済みの proxyman-cli --help を使用します。同梱のリファレンスは、レビュー済みの macOS スナップショットです。
4. Debug Mode または Factory Reset に対応する専用の公開ページがない場合は、その旨を伝え、インストール済みのヘルプメニューと、このスキルに基づく動作を使用します。

この macOS の信頼／Keychain のワークフローを Windows、Linux、モバイルデバイス、シミュレーター、Java、Firefox、コンテナーに一般化しないでください。対象固有の信頼設定については、proxyman-https-capture に案内してください。

操作前に分類する

• 生成された Proxyman ルート CA： Proxyman は通常の HTTPS インターセプトに使用する署名 ID を生成します。現在の Mac にインストールして信頼する必要があります。
• カスタムルート CA： Proxyman 内の生成された署名 ID を置き換えるもので、秘密鍵を含める必要があります。
• カスタムサーバー証明書： Proxyman は証明書の名前に基づいて、一致するクライアントにこの証明書を提示します。これは上流の mTLS ID ではありません。
• カスタムクライアント証明書： Proxyman は相互 TLS 用に、設定された上流のホストとポートにこの証明書を提示します。
• Debug Mode： 本番コンソールの診断情報を増やす機能です。リセットではなく、サポートバンドルをエクスポートする機能でもありません。
• Factory Reset： 証明書と環境設定を削除します。また、ルールやバックアップを含む、アプリが管理するデータをさらに広範囲に削除するオプションもあります。

ユーザーが「証明書を追加して」とだけ言った場合は、TLS の方向と目的を確認してください。誤った役割を選ぶと、ハンドシェイクが失敗したり、必要以上に信頼範囲が広がったりする可能性があります。

安全な操作手順

1. 現在の証明書、ステータス、ルールの状態を調べ、変更する項目を正確に記録します。
2. カスタム証明書を変更する前に、重要なキャプチャを一時停止するか完了させます。レビュー済みのアプリでは、カスタム証明書の状態が変わると、進行中の接続が閉じられます。
3. 復旧可能な入力データを Proxyman の管理フォルダー以外に保管します。元の証明書／鍵ファイル、ユーザーが承認したシークレットストア内のパスワード、関連するデバッグルールのエクスポート、必要なログ／バックアップを保管してください。
4. 信頼設定、ルーティング、シークレット、中断、削除にどのような影響があるかを正確に説明します。
5. 特権を必要とする信頼ストアの変更、証明書／秘密鍵のインポートまたは削除、Reset Network Proxy、Factory Reset の直前に確認を取ります。Debug Mode では、有効化の明示的な依頼があれば十分です。アプリをターミナルから起動したり出力を共有したりする前に、再現手順とログ共有の範囲について合意してください。
6. 対象を絞った変更を一つ行います。パスワード、sudo、Keychain のエラーが発生しても繰り返し試さず、まず変更後の部分的な状態を調べてください。
7. 独立したステータス確認と、新しい制御された TLS 接続、または再起動後の状態を使って検証します。
8. 要求された結果を取得した後、以前の証明書／設定に戻すか、診断機能を無効にします。

インターフェースの境界

• 生成した証明書およびカスタム証明書、デバッグモード、工場出荷時設定へのリセットについて、レビュー済みの完全なインターフェースは GUI です。
• MCP では、現在のルート証明書の状態を確認し、デフォルトの Proxyman CA を生成してインストールし、現在管理されているルート証明書を削除できます。カスタムのルート／サーバー／クライアント証明書のインポートや CRUD、デバッグモード／工場出荷時設定へのリセットの実行はできません。
• proxyman-cli install-root-cert はカスタム P12 ルート証明書をインポートし、custom-cert は P12 サーバー／クライアント証明書を管理します。コマンドを組み立てる前に、バージョンに合ったヘルプを確認してください。
• レビュー済みの GUI では、サーバー／クライアント証明書に、対応する秘密鍵と PEM／DER 証明書、または P12 を使用できます。レビュー済みの CLI でサポートされているのは P12 のみです。
• 工場出荷時設定へのリセットとデバッグモードは GUI でのみ利用できます。Application Support や Keychain の内容を再帰的に削除して、工場出荷時設定へのリセットを模倣しないでください。
• proxyman-cli export がバックアップするのはデバッグツールのルールのみです。App Settings、証明書／秘密鍵、キャプチャしたセッション、ライセンスの状態、Proxyman のバックアップフォルダーはバックアップしません。

通常の Settings タブに関する質問は proxyman-app-settings に、別のターゲットでのキャプチャ／信頼に関する質問は proxyman-https-capture に、CLI の正確な実行方法に関する質問は proxyman-cli に案内してください。

機密データの取り扱いルール

• ユーザーが具体的な情報の公開を明示的に承認していない限り、秘密鍵、P12 の内容、パスフレーズ、sudo パスワード、Keychain トークン、キャプチャした TLS シークレット、またはコンソールログ全体を読み取ったり、貼り付けたり、保持したりしないでください。
• GUI のパスワードプロンプトを優先してください。レビュー済みの CLI では証明書のパスワードを引数として指定するため、シェル履歴やプロセスの調査を通じて漏えいする可能性があります。実際のシークレットを受け取らず、ユーザーが実行するコマンドにはプレースホルダーを記載してください。
• ユーザーが所有している、または使用を許可されている証明書のみをインポートしてください。カスタムサーバー証明書を使用しても、サードパーティーの本番アプリで証明書のピンニングを回避する権限は得られません。
• デバッグ情報やコンソールログは、サポートにコピーまたは共有する前に内容を確認してください。