PersonalSOC 操作マニュアル

この端末のログと防御の状況を、ボタン1つで読み取り専用に集めて、ひと目で分かるレポートにするアプリの使い方です。画面の操作を順番に説明し、コマンドラインは後ろの章にまとめています。

1. PersonalSOC とは

PersonalSOC は、この端末のログと防御の状況を集めて、検出事項と報告書にまとめるアプリです。専任の担当者がいない個人が、自分の端末で何が起きているかを根拠つきで知り、次にやることを決められるように作られています。

読み取り専用なので、設定を変えたり、ファイルを消したり、通信を遮断したりはしません。ログの解析は、LLM もネットワークも使わない決まった手順の解析器が行います。LLM 連携は任意で、最初はオフです。

できないこと

• 動かしている端末1台のための道具です。複数の端末をまとめて見る機能はありません。
• 権限は上げません。root でないと読めないログは「読めない」と表示し、sudo は使いません。
• 「検出なし」は安全の証明ではありません。総合リスクも、0 から 100 の目安で、確率ではありません。
• 読むものは決まった収集元だけです。画面から、読むファイルやコマンドを指定することはできません。

2. 入れ方と起動のしかた

PersonalSOC は、RoamSwitch とは別のアプリです。独自のアイコンを持ち、RoamSwitch の配布物に同梱されています。RoamSwitch のメニューに入口はなく、アプリとして単独で開きます。

3. はじめての状況確認

「状況を確認する」を押したときだけ、固定の収集元を読みます。読ませたくない収集元は、設定で外せます。

操作手順

1. アプリを開き、右上の「設定」を押します。
2. その下に、この OS で読む収集元が並びます。読ませたくないものがあれば、チェックを外します。
3. 「保存」を押し、「← 戻る」でホームに戻ります。
4. 「状況を確認する」を押します。進み具合のバーが出て、終わると結果のタブが並びます。

終わると「確認が終わりました。検出 3 件 / IOC 2 件」のように件数が出ます。タブの見かたは次の章です。

4. 結果の見かた

5. 設定と定期実行

ホーム右上の「設定」を開くと、機能ごとのタブに分かれています。変えたあとは「保存」を押し、「← 戻る」でホームに戻ります。

表示言語 「自動(OS の設定に従う)」のほか、日本語、English、Deutsch、Español、Français、Italiano、한국어、Português (Portugal)、简体中文、繁體中文から選べます。

定期実行(任意)

「定期的に自動確認する」にチェックを入れて保存すると、Mac は launchd のユーザーエージェント、Linux は systemd のユーザータイマーに登録されます。間隔は 15 分から 24 時間までの 7 段階で選び、最初は 1 時間です。

動くのは personalsoc scan --notify だけで、root は使いません。前回になかった検出があるときだけ通知し、本文は件数だけです(Linux では notify-send が要ります)。「前回になかった検出があるときだけ通知する」で通知を切ることもできます。

チェックを外して保存すると、登録が解除されます。

6. LLM 連携(任意)

LLM 連携は任意で、最初はオフです。有効にすると、状況確認のあとに、選んだ LLM のコマンドが追加の調査をして、監査官として報告書を書きます。使えるのは、opencode、claude、codex、agy のコマンドです。

操作手順

1. 「LLM 連携を有効にする」にチェックを入れます。
2. 「使う LLM」を選びます。「(未導入)」と出るものは、この端末にコマンドがありません。
3. 必要なら、モデルとタイムアウト(秒)を変えます。モデルを空欄にすると、その LLM の既定が使われます。
4. 「保存」を押してホームに戻り、「状況を確認する」を押します。確認のあと、続けて LLM の調査が走ります。

LLM に渡るもの

• 渡すのは、検出の内容、根拠のログの行、MCP の返り値の文字列、収集元の備考です。状況を正確に調べるために、これらは渡します。
• 渡す前に、鍵・トークン・パスワードなどの秘密を伏せ字にし、不可視文字を取り除きます。
• PersonalSOC は、LLM にシェルもファイルも渡しません。LLM は「調べたいこと」を要求するだけで、PersonalSOC が許可した読み取り専用のツールを実行して結果を返します。調べる回数は最大 6 回です。
• LLM の出力は信頼せず、報告書では引用として扱います。LLM は検知を過剰に深刻に読むことがあるので、結論は必ず「検出事項」で確認してください。

道具の制限について

• 設定の表の「状態」の欄に、opencode と claude は「道具を制限して起動」と出ます。claude は内蔵の道具、MCP サーバー、スキルを止め、利用者の設定も読み込ませずに起動します。opencode は、すべての権限を拒否にして起動します。
• codex と agy は、この方法では止められないため、「道具を制限できません」と出ます。

7. コマンドラインで使う

コマンドは personalsoc です。Linux では /usr/bin/personalsoc にあり、Mac では PersonalSOC.app/Contents/MacOS/ の中にあります。

8. 保存場所とアップデート

保存されるもの

PersonalSOC は、報告書や集めたログをファイルに保存しません。残したいときは、画面の「Markdown をコピー」か、コマンドラインの出力を使ってください。LLM を増やしたいときは、設定ファイルの profiles を手で編集します。画面からは変えられません。

アップデート

Mac は、設定の「アップデート」で更新します。「アップデートを確認」を押したときだけ lafine.net に接続し、最新版の情報(公開の JSON)を受け取ります。この端末やログの情報は送りません。新しい版があれば「ダウンロードしてインストール」を押します。ダウンロードしたファイルは、アプリに埋め込んだ公開鍵で署名を検証し、失敗したら何も入れません。終わるとアプリが再起動します。

Mac では、RoamSwitch 本体のアップデートでは PersonalSOC は更新されません。Linux にはアップデート機能がなく、RoamSwitch のパッケージの更新に含まれます。

9. こんなときは