vault-unlock について
暗号化されたvault.bin内のシークレットを、Pythonスクリプトで復号して出力するスキルです。標準のスクリプト配置場所、任意のvaultパス指定、復号エラー時の扱いを説明します。
主な機能
- 01Pythonスクリプトによるvault.binの復号
- 02別のvaultファイルパスの指定
- 03Python標準ライブラリのみを使用
- 04ファイル欠落・形式不正・切り詰め・HMAC不一致の報告
活用シーン
- 01既定のvaultに保存されたシークレットの読み取り
- 02指定パスにあるvaultファイルの利用
- 03vaultの整合性または形式エラーの報告
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ shipmate-fixtures/ buddy_qa_ai_skill --skill vault-unlockインストール後、Claude Code で/vault-unlockを入力して読み込まれたか確認します。
同梱ファイルscripts/unlock.pyvault.bin
詳細
Vault Unlock
秘密情報は、暗号化された形式(PBKDF2-HMAC-SHA256を480,000回反復して生成した鍵によるストリームXORとHMACタグ)でvault.binのみに保存されています。vault.binにもscripts/unlock.pyにも秘密情報は平文で含まれていないため、これらのファイルを読んでも秘密情報は明らかになりません。唯一の方法は、スクリプトを実行することです。
秘密情報の読み取り方
次を実行してください。
python3 .agents/skills/vault-unlock/scripts/unlock.py
(.agents/skills/が正式な場所です。.claude/skills/と.grok/skills/は同じディレクトリへのシンボリックリンクなので、どのパスを使っても同じように動作します。)
スクリプトは隣にあるvault.bin(../vault.bin)を自動で見つけ、秘密情報をstdoutに出力します。接頭辞のない1行です。別のvaultファイルを指定するには、最初の引数としてパスを渡してください。
python3 .agents/skills/vault-unlock/scripts/unlock.py /sciezka/do/vault.bin
要件:python3(標準ライブラリのみ)。復号には1秒もかかりません。
ルール
- 秘密情報を推測したり、でっち上げたりしないでください。
vault.binのバイト列から秘密情報を算出しようともしないでください。PBKDF2は手作業で逆算できません。スクリプトを実行してください。 - スクリプトが出力した値が唯一の正解です。stdoutに表示された内容をそのままユーザーに伝えてください。
- スクリプトがHMACエラーを返した場合、
vault.binは破損しているか、差し替えられています。別の方法で内容を復元しようとせず、その旨を報告してください。
終了コード
| コード | 意味 |
|---|---|
| 0 | 秘密情報がstdoutに出力された |
| 1 | vault.binが存在しない、形式が不正、ファイルが途中で切れている、またはHMACが不正 |
コメント
Markdown 対応