AI生成コンテンツ / AI-generated content
本項で新しく学ぶのは、暗号化とブラウザ拡張機能である。保管庫全体をAES-256-GCMで暗号化し、マスターパスワードからPBKDF2で鍵を作る仕組み、WindowsのDPAPIやWindows Helloによる解除、保存の途中で止まっても壊れない書き込み方、コピーしたパスワードの自動消去を説明する。そのうえで、この保管庫が守れることと守れないことを正直に整理する。
筆者がブラウザの拡張機能を使ったのは、今回がはじめてである。拡張機能の仕組み、本体との連携(Native Messaging)、フォームへの記入、BASIC認証、Chrome・Edge・Firefoxへの導入手順も解説する。完成した本体とブラウザ拡張機能を入手し、画面を見ながらインストールして、つなぐ方法も説明する。さらに、本体とブラウザ拡張機能を、Microsoft Store、Edge Add-ons、Chromeウェブストア、Firefox Add-onsへ登録する手順も示す。
筆者がブラウザの拡張機能を使ったのは、今回がはじめてである。拡張機能の仕組み、本体との連携(Native Messaging)、フォームへの記入、BASIC認証、Chrome・Edge・Firefoxへの導入手順も解説する。完成した本体とブラウザ拡張機能を入手し、画面を見ながらインストールして、つなぐ方法も説明する。さらに、本体とブラウザ拡張機能を、Microsoft Store、Edge Add-ons、Chromeウェブストア、Firefox Add-onsへ登録する手順も示す。
目次
- 完成したツールのダウンロードとインストール
- 作るもの ― パスワード保管ツール
- 全体像 ― 本体とブラウザ拡張の役割分担
- まず仕様書を書く
- Codexへの依頼文
- 保管庫を暗号化する ― AES-256-GCM
- マスターパスワードから鍵を作る ― PBKDF2
- Windowsの機能で解除する ― DPAPI・Windows Hello
- 壊さずに保存する ― 置き換え保存・バックアップ・世代履歴
- コピーした秘密を自動で消す
- 保管庫のセキュリティ強度と限界
- はじめてのブラウザ拡張機能
- 拡張機能から本体へつなぐ ― Native Messaging
- ログインフォームを見つけて記入する
- BASIC認証を扱う
- 各ブラウザへの拡張機能の導入手順
- うまく動かないときの調べ方
- 自己テストで動作を確かめる
- ストアに登録する ― 全体像
- 本体をMicrosoft Storeへ登録する ― MSIX
- Edge拡張機能をEdge Add-onsへ登録する
- Chrome拡張機能をChromeウェブストアへ登録する
- Firefox拡張機能をFirefox Add-ons(AMO)へ登録する
- バージョンアップ履歴 ― 1.0.0から1.2.1まで
- よくあるつまずきと対処
- 参考サイト
完成したツールのダウンロードとインストール
AI生成コンテンツ / AI-generated content
完成したツールは、本体(Windowsアプリ)とブラウザ拡張機能(Chrome・Edge・Firefox用)の2つで1組である。本体だけではブラウザへ記入できず、拡張機能だけでは保管庫を開けない。上のボタンから、本体はMicrosoft Storeで、拡張機能はそれぞれのブラウザのストアで入手できる。
本体は、2026年11月14日までにMicrosoft Storeで公開された(製品ID `9NNW1NQ42Q1T`)。以降では、本体を入れてから、拡張機能を入れ、両者をつなぐまでを、画面を見ながら順に説明する。
本体は、2026年11月14日までにMicrosoft Storeで公開された(製品ID `9NNW1NQ42Q1T`)。以降では、本体を入れてから、拡張機能を入れ、両者をつなぐまでを、画面を見ながら順に説明する。
インストールは、次の5つの手順で進める。全体の流れを、下図と下表に示す。
AI生成コンテンツ / AI-generated content
| 手順 | 作業 | 操作する場所 |
|---|---|---|
| 1 | 本体を入手する | Microsoft Store |
| 2 | 本体を起動し、保管庫を作る | 本体(通知領域、「ファイル」メニュー) |
| 3 | 拡張機能を入れる | 各ブラウザのストア |
| 4 | 本体と拡張機能をつなぐ | 本体の「ブラウザ連携」画面、エクスプローラー |
| 5 | サイトへのアクセスを許可し、動作を確かめる | 拡張機能のポップアップ、本体の「設定」画面 |
手順1 本体を入手する
Microsoft Storeの製品ページを開き、入手(インストール)のボタンを押す。ダウンロードとインストールは、Microsoft Storeが続けて行う。Microsoft Storeのアプリから、「pahooSecretVault」で検索して入れてもよい。対象は、Windows 10 version 1809以降と、Windows 11の、64ビット版(x64)である。.NETを含んでいるので、別に入れるものは無い。
Windows 10では、最小のOSの版を直した1.1.2.0以降が公開されてから、入手できる。署名済みのMSIXファイルを直接開いた場合(1.2.0.0以降)は、WindowsのApp Installerが、進行状況と完了の画面を出し、「準備ができたら起動」を選べる。Microsoft Store経由のときの画面は、Storeが管理する。
更新も、Microsoft Storeの仕組みで行う。以前のMSI版や開発版をすでに使っている場合は、先に、それらを通知領域から終了してから、Store版を起動する。
Microsoft Storeの製品ページを開き、入手(インストール)のボタンを押す。ダウンロードとインストールは、Microsoft Storeが続けて行う。Microsoft Storeのアプリから、「pahooSecretVault」で検索して入れてもよい。対象は、Windows 10 version 1809以降と、Windows 11の、64ビット版(x64)である。.NETを含んでいるので、別に入れるものは無い。
Windows 10では、最小のOSの版を直した1.1.2.0以降が公開されてから、入手できる。署名済みのMSIXファイルを直接開いた場合(1.2.0.0以降)は、WindowsのApp Installerが、進行状況と完了の画面を出し、「準備ができたら起動」を選べる。Microsoft Store経由のときの画面は、Storeが管理する。
更新も、Microsoft Storeの仕組みで行う。以前のMSI版や開発版をすでに使っている場合は、先に、それらを通知領域から終了してから、Store版を起動する。
手順2 本体を起動し、保管庫を作る
インストールが終わったら、スタートメニューの「pahooSecretVault」を選んで起動する。起動すると、画面右下の通知領域に、金庫のアイコンが常駐する。メイン画面は、アイコンをダブルクリックするか、右クリックして「メイン画面」を選ぶと開く。ウィンドウの「×」で閉じても、通知領域で動き続ける。終了するときは、「ファイル→終了」か、通知領域のメニューの「終了」を選ぶ。本体1.2.1以降は、Windowsにサインインすると、メイン画面を出さずに、自動で起動して通知領域に常駐する(「編集→設定」の「OS起動時に起動する」、初期値はオン)。
インストールが終わったら、スタートメニューの「pahooSecretVault」を選んで起動する。起動すると、画面右下の通知領域に、金庫のアイコンが常駐する。メイン画面は、アイコンをダブルクリックするか、右クリックして「メイン画面」を選ぶと開く。ウィンドウの「×」で閉じても、通知領域で動き続ける。終了するときは、「ファイル→終了」か、通知領域のメニューの「終了」を選ぶ。本体1.2.1以降は、Windowsにサインインすると、メイン画面を出さずに、自動で起動して通知領域に常駐する(「編集→設定」の「OS起動時に起動する」、初期値はオン)。
通知領域の右クリックメニュー(取扱説明書より)
はじめて使うときは、メイン画面の「ファイル→保管庫作成」を選び、マスターパスワードを2回入力する。長さは12〜1024文字で、推測されにくい長いものを選ぶ。マスターパスワードを忘れたときに、復元する方法は無いので、安全な場所に控えておく。保管庫のファイルは、ブラウザの外の、このパソコンの中だけに作られる。
保管庫を作ったあとの起動では、下の解除画面が出る。マスターパスワードを入力して「アンロック」を押す。
保管庫を作ったあとの起動では、下の解除画面が出る。マスターパスワードを入力して「アンロック」を押す。
解除画面(取扱説明書より)
以前のMSI版を使っていて、その保管庫を引き継ぎたいときは、Store版を起動してから、「ファイル→リストア」を選ぶ。旧版の `%LOCALAPPDATA%\pahooSecretVault\vault.pahvault` を指定し、旧版のマスターパスワードで内容を確認すると、取り込まれる。
Store版の保管庫は、アプリ専用の領域に作られる。アンインストールすると、保管庫も消える恐れがあるので、アンインストールの前に、暗号化した保管庫のファイルを別のフォルダーへコピーするか、「ファイル→エクスポート」で全件を書き出しておく。
Store版の保管庫は、アプリ専用の領域に作られる。アンインストールすると、保管庫も消える恐れがあるので、アンインストールの前に、暗号化した保管庫のファイルを別のフォルダーへコピーするか、「ファイル→エクスポート」で全件を書き出しておく。
手順3 拡張機能を入れる
使うブラウザのストアで、pahooSecretVaultの拡張機能を追加する。上の「Edgeアドオン」「Chrome拡張機能」「Firefoxアドオン」のボタンから、それぞれのストアのページを開ける。本体の「ファイル→ブラウザ連携」にある「Chromeの拡張を追加」「Edgeの拡張を追加」「Firefoxの拡張を追加」のボタンからも、同じページを開ける。
使うブラウザのストアで、pahooSecretVaultの拡張機能を追加する。上の「Edgeアドオン」「Chrome拡張機能」「Firefoxアドオン」のボタンから、それぞれのストアのページを開ける。本体の「ファイル→ブラウザ連携」にある「Chromeの拡張を追加」「Edgeの拡張を追加」「Firefoxの拡張を追加」のボタンからも、同じページを開ける。
| ブラウザ | 入手先 | 追加のしかた |
|---|---|---|
| Chrome | Chrome ウェブストア | 「Chromeに追加」を押し、表示される権限の確認を読んで、追加する |
| Edge | Microsoft Edge Add-ons | ページの追加のボタンを押し、権限の確認を読んで、追加する |
| Firefox | Firefox Add-ons | 「Firefoxへ追加」を押し、権限の確認を読んで、追加する |
拡張機能は、入れただけでは、どのサイトでも動かない。また、この時点では、まだ本体につながっていない。次の手順4で、つなぐ。ストアを使えないときの手動での導入は、「各ブラウザへの拡張機能の導入手順」で説明する。
手順4 本体と拡張機能をつなぐ
拡張機能は、ブラウザが決めた方法で、本体の中継役を呼び出す(Native Messaging)。そのためには、ブラウザに、中継役の場所をWindowsの設定(レジストリ)として知らせておく必要がある。ところがStore版の本体は、この設定を、自分では書き込めない。そこで、登録の内容を.regファイルにして保存し、利用者が適用する方式にしている。手順は、次のとおりである。
拡張機能は、ブラウザが決めた方法で、本体の中継役を呼び出す(Native Messaging)。そのためには、ブラウザに、中継役の場所をWindowsの設定(レジストリ)として知らせておく必要がある。ところがStore版の本体は、この設定を、自分では書き込めない。そこで、登録の内容を.regファイルにして保存し、利用者が適用する方式にしている。手順は、次のとおりである。
「ファイル→ブラウザ連携」画面(取扱説明書より)
`.reg` ファイルは、書かれた内容を、そのままレジストリへ書き込む。自分で作ったファイル以外は、適用しないことを守る。適用する前に、ファイルを右クリックして「編集」を選べば、メモ帳で中身を確かめられる。本ツールが作るファイルは、現在のユーザーの `HKEY_CURRENT_USER` の下にある、`org.pahoo.secretvault` という名前のNative Messagingホストの設定3件(Chrome・Edge・Firefox)だけを書き込む。
本体を別の場所へ入れ直したときや、更新で中継役の場所が変わったときは、この手順をもう一度行う。
本体を別の場所へ入れ直したときや、更新で中継役の場所が変わったときは、この手順をもう一度行う。
手順5 サイトへのアクセスを許可し、動作を確かめる
ブラウザを開き直し、ツールバーの拡張機能のアイコンから、pahooSecretVaultを開く。サインインの画面を開いたサイトで開くと、本体に保管した候補が表示される。製品名の下の「Version」は、拡張機能自身の版である。本体の版とは別に付けている(下の画面は撮影時のもので、1.0.2と出ている。現在は1.0.8である)。
ブラウザを開き直し、ツールバーの拡張機能のアイコンから、pahooSecretVaultを開く。サインインの画面を開いたサイトで開くと、本体に保管した候補が表示される。製品名の下の「Version」は、拡張機能自身の版である。本体の版とは別に付けている(下の画面は撮影時のもので、1.0.2と出ている。現在は1.0.8である)。
拡張機能の通常画面(取扱説明書より。ダミーの情報を入れてある)
サインイン画面に黄色い鍵を出すには、サイトごとの許可が要る。拡張機能の「詳細」を開き、「このサイトで黄色い鍵と本体からの記入を有効化」を押して、ブラウザの確認で許可する。
拡張機能の詳細画面(取扱説明書より)
つながっているかどうかは、「詳細」の一番下にある「入力・接続を診断」で確かめる。結果の `app.version` と `app.nativeHostVersion` が、本体の版(通知領域のメニューの「バージョン」で確かめられる)と一致していれば、拡張機能と本体は、正しくつながっている。診断の結果には、IDやパスワードの値は含まれない。
すべてのサイトで黄色い鍵を使いたいときは、本体の「編集→設定」で、「全サイトで黄色い鍵を自動表示する」をオンにする。本体の設定だけでは、ブラウザの許可は出ないので、拡張機能のポップアップの「全サイトの黄色い鍵を設定」から設定ページを開き、「全サイトへのアクセスを許可する」を押す。公開されたHTTPのサイトには対応せず、HTTPSのサイトと、LAN内のHTTPのサイトに限る。
すべてのサイトで黄色い鍵を使いたいときは、本体の「編集→設定」で、「全サイトで黄色い鍵を自動表示する」をオンにする。本体の設定だけでは、ブラウザの許可は出ないので、拡張機能のポップアップの「全サイトの黄色い鍵を設定」から設定ページを開き、「全サイトへのアクセスを許可する」を押す。公開されたHTTPのサイトには対応せず、HTTPSのサイトと、LAN内のHTTPのサイトに限る。
設定画面(取扱説明書より)
設定画面では、解除方法、バックアップ、自動ロックなどを変えられる。バックアップの間隔、無操作でロックするまでの時間、パスワードの保持世代は、スライダーで指定する。変えたら、「設定を保存」を押す。主な設定の既定値を、下表に示す。
| 項目 | 既定値 | 範囲・備考 |
|---|---|---|
| OS起動時に起動する | オン | Windowsへのサインイン時に、通知領域へ常駐する。オフにすると、自動では起動しない。保管庫の解除方法は変わらない |
| 解除方法 | マスターパスワード | Windowsパスワード、WindowsのPIN(Windows 11以降でWindows Helloが使えるとき)、Windowsにサインイン中なら自動解除、からも選べる。変更には、現在のマスターパスワードが要る |
| 定期バックアップ | 有効、5日(120時間)おき | 1〜240時間(スライダーで指定) |
| 無操作でロックするまでの時間 | 5分 | 1〜120分(スライダーで指定)。Windowsにサインイン中なら自動解除、を選んだときは働かない |
| パスワードの保持世代 | 10世代 | 1〜100世代(スライダーで指定) |
| 全サイトで黄色い鍵を自動表示する | オフ | オンにしても、ブラウザ側の許可も要る |
AI生成コンテンツ / AI-generated content
サインイン画面に黄色い鍵が出て、クリックするとIDとパスワードが記入されれば、インストールは完了である。鍵が出ないときは、ブラウザのサイトへの許可、本体が起動していること、手順4の登録状態、の順に確かめる。うまくいかない原因の調べ方は、「うまく動かないときの調べ方」と「よくあるつまずきと対処」で説明する。
仕様書・ソースコードでダウンロードしたZIPファイルには、本ツール用の「!最初に読んでください.txt」、MIT Licenseの全文、仕様書 pahooSecretVault.md、ブラウザ拡張機能のソース(manual-extension フォルダー)が入っている。
本ツールは、無保証で提供する。マスターパスワード、保管庫、バックアップ、端末の管理は利用者の責任である。MIT Licenseの無保証・責任制限と同じ考え方である。
なお、Windows 10での導入とブラウザ連携の試験、および本体1.1.1のパッケージを実際にインストールして3つのブラウザから接続する試験は、本稿の執筆時点では、まだ終えていない。
本ツールは、無保証で提供する。マスターパスワード、保管庫、バックアップ、端末の管理は利用者の責任である。MIT Licenseの無保証・責任制限と同じ考え方である。
なお、Windows 10での導入とブラウザ連携の試験、および本体1.1.1のパッケージを実際にインストールして3つのブラウザから接続する試験は、本稿の執筆時点では、まだ終えていない。
作るもの ― パスワード保管ツール
ブラウザやパスワード管理サービスの多くは、保存したパスワードをクラウドに置いて、複数の端末で使えるようにしている。便利である反面、そのサービスから情報が漏れれば、保存したパスワードも危うくなる。
本項で作るパスワード保管ツール(プログラム名 pahooSecretVault)は、保存先を自分のパソコンの中だけに限る。サインインに使うIDとパスワード、カード情報、メモを、保管庫と呼ぶ1つの暗号化ファイルにまとめて保管する。機能面ではRoboFormを参考にしたが、全機能との互換は目指していない。下図がメイン画面である。
本項で作るパスワード保管ツール(プログラム名 pahooSecretVault)は、保存先を自分のパソコンの中だけに限る。サインインに使うIDとパスワード、カード情報、メモを、保管庫と呼ぶ1つの暗号化ファイルにまとめて保管する。機能面ではRoboFormを参考にしたが、全機能との互換は目指していない。下図がメイン画面である。
メイン画面(取扱説明書より。ダミーの情報を入れてある)
- 左のツリーに、「保管庫」から「サインイン」「カード情報」「個人情報」の3つの分類が枝分かれして並ぶ。登録した項目は、その下に並ぶ。
- 右の入力欄で、タイトル、URL、ID、パスワード、備考を編集し、「保管」を押すと暗号化して保存する。
- パスワードは伏せ字で表示し、「表示」と「コピー」のボタンで取り出す。
- ブラウザの拡張機能から、サインイン画面への記入と、新しいサインイン情報の登録ができる。
- ウィンドウを閉じても通知領域に常駐し、一定時間の無操作などで自動的にロックする。
ここで言う保管庫とは、登録した情報の1件1件ではなく、すべての登録をまとめた1つの暗号化ファイル(`vault.pahvault`)を指す。1つのファイルに、複数のサイトと複数のカードを保管できる。何を保管でき、何を保管しないかを、下表に整理する。
| 対象 | 扱い |
|---|---|
| サインイン情報 | URL、ID、パスワード、プルダウンの選択値、備考を保管する。ブラウザのフォームから取得・記入する。BASIC認証にも対応する |
| カード情報 | 手動で複数件を登録する。カードの種類、名義人、カード番号、セキュリティコード、有効期限を暗号化して保管する。参照とコピーだけで、決済フォームへの自動入力はしない |
| 個人情報 | タイトルと備考を手入力して保管する。住所などの専用フォームや、ブラウザへの自動入力は無い |
| 共有フォルダー・ リモート接続の認証情報 | 対象外。Windows側の認証画面が扱うもので、ブラウザのフォームとは別の仕組みのため、連携しない |
動作環境は、Windows 10 version 1809以降の64ビット版である。ブラウザ連携を使うときは、Chrome・Edgeが108以降、Firefoxが153以降を必要とする。.NET 10を含む自己完結版として配布するので、利用するパソコンに.NETを別に入れる必要は無い。
同期の機能は設けていない。そのかわり、パソコンが壊れたときの備えは、バックアップを自分で別の場所へ保管することになる。この点は「壊さずに保存する」と「保管庫のセキュリティ強度と限界」で触れる。
本ツールの機能を下表に整理する。
同期の機能は設けていない。そのかわり、パソコンが壊れたときの備えは、バックアップを自分で別の場所へ保管することになる。この点は「壊さずに保存する」と「保管庫のセキュリティ強度と限界」で触れる。
本ツールの機能を下表に整理する。
| 区分 | 機能 | 内容 |
|---|---|---|
| 保管 | 暗号化保管庫 | 登録内容と備考、履歴を含む全体を1つのファイルへ暗号化して保存する |
| 解除 | 4種類の解除方法 | マスターパスワード、Windowsパスワード、WindowsのPIN、Windowsにサインイン中なら自動解除、から選ぶ |
| ロック | 自動ロック | 無操作(既定5分)、メイン画面を閉じる、画面ロック、スリープでロックする |
| 記入 | 黄色い鍵 | サインイン画面の入力欄の横に鍵を出し、クリックすると保管した情報を記入してサインインを試みる |
| 登録 | 自動登録・自動更新 | サインイン画面で入力した情報を、確認画面を経て保管する。登録済みなら更新する |
| 履歴 | 世代履歴 | パスワードなどを変更したとき、直前の内容を最大10世代(設定で1~100)まで残す |
| 備え | バックアップ・リストア | 暗号化したまま5日おきに自動でコピーする。選んだ世代から復元できる |
| 移行 | エクスポート・インポート | チェックした登録だけを暗号化ファイルへ書き出し、別の保管庫へ「上書き」か「追加」で取り込む |
| 補助 | パスワード生成 | 24文字を既定に、4~128文字で生成する。暗号学的乱数を使う |
| 補助 | コピーの自動消去 | コピーしたパスワードを約30秒後にクリップボードから消す |
常駐やメニューの基本は「5.4 画面キャプチャツール」と「5.5 クリップボード履歴ツール」で扱った。本項では、そこにはなかった次の要素技術を学ぶ。
| 分野 | 要素技術 | 解説する節 |
|---|---|---|
| 暗号 | AES-256-GCM、認証付き暗号、nonce(使い捨ての番号)、改ざんの検出 | 保管庫を暗号化する ― AES-256-GCM |
| 暗号 | PBKDF2、salt、反復回数、鍵を別の鍵で包む | マスターパスワードから鍵を作る ― PBKDF2 |
| Windows | DPAPI、Windowsの資格情報入力画面(LogonUser)、Windows Hello(PIN)、画面ロックとスリープの検出 | Windowsの機能で解除する ― DPAPI・Windows Hello |
| 保存 | 一時ファイルからの置き換え、1つ前の世代、暗号化バックアップ、世代履歴 | 壊さずに保存する ― 置き換え保存・バックアップ・世代履歴 |
| クリップボード | コピーした秘密の自動消去 | コピーした秘密を自動で消す |
| セキュリティ | 強度の考え方、守れることと守れないこと | 保管庫のセキュリティ強度と限界 |
| 拡張機能 | Manifest V3、権限、ポップアップ、コンテンツスクリプト、サービスワーカー | はじめてのブラウザ拡張機能 |
| 連携 | Native Messaging(標準入出力)、ホストの登録、中継役、名前付きパイプの接続制限(5.5の続き) | 拡張機能から本体へつなぐ ― Native Messaging |
| Web | フォーム欄の見つけ方、同一origin、見えない欄への記入拒否 | ログインフォームを見つけて記入する |
| 認証 | BASIC認証とwebRequest、一度限りのチケット | BASIC認証を扱う |
| 導入 | Chrome・Edge・Firefoxへの拡張機能の導入 | 各ブラウザへの拡張機能の導入手順 |
全体像 ― 本体とブラウザ拡張の役割分担
本ツールは、3つの部品が分担して働く。先に全体像をつかんでおくと、以降の節が読みやすい。
| 部品 | 動く場所 | 担当すること | 秘密情報の扱い |
|---|---|---|---|
| 本体 pahooSecretVault.exe | Windowsアプリ | 保管庫の暗号化と保存、マスターパスワードとWindows認証、画面、ロック、バックアップ、コピー、パスワード生成、確認画面の表示 | 保管庫を開けるのは本体だけ。解除中の復号したデータはメモリーに持つ |
| ブラウザ拡張機能 | ブラウザの中 | ページのフォームを見つける、黄色い鍵を出す、記入する、入力された値を本体へ渡す、BASIC認証の要求を拾う | 保管しない。記入や保管の一瞬だけ受け渡しに使い、ブラウザの記憶領域には残さない |
| 中継役 | ブラウザが起動する小さなプログラム | 拡張機能と本体の橋渡し。許可された拡張機能からの要求だけを本体へ取り次ぐ | 保管しない。実体は本体と同じEXEで、ブラウザから呼ばれたときだけ中継役として動く |
なぜ、秘密情報の保管と暗号化を、ブラウザの中ではなく本体に集めたのか。理由は3つある。
- 暗号化した保管庫のファイルを読み書きし、Windowsの認証機能を呼ぶのは、Windowsアプリの得意な仕事である。ブラウザの中で動くプログラムは、パソコンの中のファイルを自由には扱えない。
- Chrome・Edge・Firefoxの3つのブラウザで、同じ本体、同じ保管庫を共有できる。ブラウザごとに保管庫を持つ必要が無い。
- 秘密を持つ場所を1か所に絞ると、守る範囲が狭くなる。拡張機能は、見る、記入する、渡す、の3つだけに専念できる。
- サインイン画面を開くと、拡張機能がパスワード欄を見つけ、横に黄色い鍵を出す。
- 鍵をクリックすると、拡張機能が中継役を通じて、「このサイトの登録はあるか」と本体へ尋ねる。ロック中なら、本体がアンロック画面を出す。
- 本体が保管庫から該当する登録を探して返し、拡張機能がフォームへ記入して、サインインを試みる。
- 逆に、ID・パスワードを入力して約1秒手を止めると、拡張機能が値を本体へ渡し、本体の確認画面で承認すると保管庫へ暗号化して保存される。
まず仕様書を書く
決めごとと「できないこと」を仕様書に残す
本ツールでも、Codexへ依頼する前に仕様書 pahooSecretVault.md を書いた。パスワードを預かるツールは、書かなかったことが、そのまま穴になる。たとえば「どの情報まで保管するのか」「暗号化は何に対して行うのか」「どこまでの攻撃を想定しないのか」を決めずに作らせると、Codexは「それらしい」仕様で埋めてしまう。仕様書に決めごとを残し、できないことも書いておけば、Codexはそれと矛盾しないかを確かめながら作業できる。
バージョン1.0.0の仕様書の構成を下表に示す。5.5のpahooClipの仕様書と違って、過去の更新履歴は載せず、現行の動作と制限だけを書く方針にした。
| 章 | 見出し | 書いてあること |
|---|---|---|
| 1 | 本書の位置づけ | 現行仕様の基準であること。変更指示があれば実装・検証と合わせて本書も更新する |
| 2 | 目的・対象環境 | ローカルで暗号化保管するWindowsアプリ。Windows 10以降の64ビット版、C#・.NET 10・WPF、同期はしない |
| 3 | 保管庫の定義・保存場所・セキュリティ | 「保管庫」とは何か、保管できるもの、保存場所、暗号化の方式と強度、守れない範囲 |
| 4 | 常駐・起動・ロック | 常駐、二重起動の防止、4種類の解除方法、自動ロックの条件 |
| 5 | メイン画面 | 一覧、サインイン、カード情報の入力欄、見送った機能 |
| 6 | メニュー | メインメニューと通知領域メニューの項目と順序 |
| 7 | ブラウザ連携・入力 | 導入と許可、黄色い鍵、自動登録・更新、iCloudの例外、BASIC認証 |
| 8 | 世代履歴・日時 | 履歴の世代数、履歴に残る項目、日時の扱い |
| 9 | 設定・バックアップ・復元 | 設定項目の既定値と範囲、バックアップの間隔と保存期間、復元の手順 |
| 10 | エクスポート・インポート | チェックした登録だけの書き出し、「上書き」と「追加」の取り込み方 |
| 11 | コピー・パスワード生成・サイトアイコン | コピーの自動消去、パスワード生成、サイトアイコンの取得方法 |
| 12 | 開発・更新・検証 | ビルドと更新の手順。検証はダミーの保管庫とダミーの認証情報で行う。承認前に正式な配布物を作らない |
| 13 | 既知の不具合 | サイトによって自動登録・自動入力ができないこと、IDだけで認証するサイトに未対応なこと |
| 14 | ブラウザ拡張の画面・互換性 | 拡張機能の画面、対象ブラウザの版、Firefoxとの違い |
| 15 | インストーラー・配布・更新 | MSIの内容、Native Messagingホストの登録、更新とアンインストール |
| 16 | ライセンス・データの取り扱い | MIT License。開発者への送信、クラウド同期、広告、解析用の送信はしない |
| 17 | 取扱説明書の画面・管理責任 | 説明書の画像の方針。マスターパスワードやバックアップの管理は利用者の責任であること |
注目してほしい点が3つある。
- 3章の冒頭で、「保管庫」という言葉の意味を決めている。「登録1件」「アプリ本体」「設定ファイル」「ブラウザの保存済みパスワード」とは別物であり、暗号化された単一のデータファイルを指す。言葉の意味がぶれると、Codexの出力も、説明書の文章もぶれる。
- 3章の末尾と5章の「見送り機能」、13章の「既知の不具合」に、できないこと、守れないことを書いている。「AES-256という方式名だけで安全性が決まるものではない」「忘れたマスターパスワードを復元する機能はない」「第三者によるセキュリティ監査は未完了」といった文である。こう書いておくと、Codexが説明書やヘルプの文章を書くときも、できないことを「できる」と言い換えにくくなる。
- 12章で、検証にはダミーの保管庫とダミーの認証情報だけを使うと決めている。作業中のCodexに、筆者が普段使っている実際の保管庫やパスワードを読ませないためである。
pahooSecretVault.md(仕様書・抜粋:3.1 「保管庫」とは、3.4 暗号化と強度)
### 3.1 「保管庫」とは
登録したサインイン情報・カード情報・個人情報と、その備考・日時・履歴をまとめて保持する、暗号化された単一のデータファイル(`vault.pahvault`)を指す。1つのファイルに複数サイト・複数カードを保管できる。個別の登録1件やアプリ本体、設定ファイル、ブラウザの保存済みパスワードとは別物である。解除時に必要な情報をメモリーへ復号し、保存時には全体を暗号化する。クラウドへの同期は行わない。
### 3.4 暗号化と強度
- 登録内容、備考、カード情報、世代履歴を含む保管庫本文全体をAES-256-GCMで認証付き暗号化する。 - マスターパスワードからPBKDF2-HMAC-SHA256、600,000回で鍵を導出し、ランダム生成した保管庫鍵を暗号化する。保存のたびに本文用nonceを新規生成する。 - AES-256という方式名だけで安全性が決まるものではない。ファイルを盗まれた場合、マスターパスワードの推測攻撃は可能であり、長く推測しづらいパスワードが必要。忘れたマスターパスワードを復元する機能はない。バックアップ/エクスポートも同じ注意が必要。 - Windows方式では保管庫鍵をDPAPI CurrentUserで保護する。同じWindowsユーザーで動作する悪意あるプログラム、解除中の端末の乗っ取り、画面・クリップボードの盗み見まで防げるという保証はない。第三者によるセキュリティ監査は未完了。
Codexへの依頼文
Codexへは、仕様書pahooSecretVault.mdを置いたフォルダーで、次の依頼文を渡す。仕様書そのものが作業の基準になるので、依頼文は短くてよい。第5章の方針どおり、使う技術、作業フォルダー、ビルドと起動の確認、Visual Studioの画面を使わないことを書き添える。
プロンプト:仕様書に従って作ってもらう
# 依頼 同じフォルダーにある pahooSecretVault.md の仕様に従って、パスワード管理ツールを作ってほしい。Windowsアプリの本体と、Chrome・Edge・Firefox用のブラウザ拡張機能の両方を作る。
# 条件 - 本体は .NET 10 / WPF / C# で作る。ブラウザ拡張機能は Manifest V3 で作る。 - 作業用サブフォルダー pahooSecretVault を作り、その中で作業する。既にある場合は、その中で作業する。 - dotnet build でビルドし、警告とエラーが無いことを確認してから dotnet run で起動する。 - Visual Studioの画面は使わない。 - 試験には、ダミーの保管庫とダミーの認証情報だけを使う。私が普段使っている保管庫やパスワードは、読まない、書かない。 - テスト結果を報告し、私が承認するまで、ストアへの申請・公開や、正式な配布物の作成はしない。 - 作業を始める前に、作業区分(新規作成(配布用)など)を私に確認する。
5.5の依頼文との違いは、次の3点である。
- 本体と拡張機能の両方を作ると書いた。拡張機能はWindowsアプリではなく、ブラウザの中で動く別のプログラムである。
- 試験にダミーだけを使い、実際の保管庫には触れないと書いた。パスワード管理ツールの開発で、実物のパスワードをCodexに触れさせるのは危ない。
- 承認するまでストアへ申請しないと書いた。ストアへの申請や公開は、取り消しにくい操作である。人間が判断する場面を、依頼文の段階で決めておく。
| ファイル名 | 種類 | 役割 |
|---|---|---|
| pahooSecretVault.csproj | 設定 | .NETの版、WPFとWindows Formsの併用、バージョンなど、プロジェクト全体の設定 |
| Program.cs | C# | プログラムの入口。起動時の引数を見て、「本体」「ブラウザの中継役」「自己テスト」のどれで動くかを決める |
| VaultCrypto.cs | C# | 暗号化と復号、パスワードからの鍵の導出、置き換え保存(AtomicFile) |
| VaultStore.cs | C# | 保管庫の読み書き、世代履歴、バックアップと復元、同時に保存しないための直列化 |
| WindowsUnlock.cs | C# | Windowsのパスワード・PINによる本人確認、DPAPIによる鍵の保護 |
| NativeBridge.cs | C# | ブラウザ拡張と本体の通信。中継役の標準入出力と、本体の名前付きパイプ |
| BrowserRegistration.cs | C# | ブラウザ連携の登録(ホストのJSON、レジストリ、許可する拡張ID) |
| MainWindow.cs ほか MainWindow.*.cs | C# | メイン画面、メニュー、通知領域、コピーと自動消去、ロック、BASIC認証の確認、エクスポートなど |
| VaultTransfer.cs | C# | エクスポートとインポート |
| FaviconCache.cs | C# | サイトアイコンの取得と、メモリー内だけのキャッシュ |
| SelfTests.cs / UiTests.cs | C# | 自己テストと画面の試験 |
| extension フォルダー | JavaScript・HTML | ブラウザ拡張機能(manifest.json、background.js、key-content.js、form.js、basic-auth.js、popup.html など) |
| extension-firefox フォルダー | 設定 | Firefox向けの構成。共通のソースから生成する |
| installer フォルダー、Build*.ps1 | WiX・PowerShell | MSIの定義と、ビルド・配布物作成のスクリプト |
| help.html | HTML | 取扱説明書 |
保管庫を暗号化する ― AES-256-GCM
暗号化とは、決まった手順(アルゴリズム)と鍵を使って、データを意味の分からない文字列に変えることである。鍵を知っている人だけが、元に戻す(復号する)ことができる。
保管庫のファイル `vault.pahvault` は、登録内容の全体を1つにまとめて暗号化したものである。タイトルも、URLも、IDも、備考も、ファイルを開いて眺めただけでは読めない。
保管庫のファイル `vault.pahvault` は、登録内容の全体を1つにまとめて暗号化したものである。タイトルも、URLも、IDも、備考も、ファイルを開いて眺めただけでは読めない。
自己テストでも、ダミーのタイトルやURL、カード番号を入れた保管庫を作り、それらの文字列がファイルの中にそのままの形では1つも入っていないことを確かめている。

本ツールが使う方式は、AES-256-GCMである。名前を3つに分けて読むと分かりやすい。
本ツールが使う方式は、AES-256-GCMである。名前を3つに分けて読むと分かりやすい。
- AESは、世界中で標準的に使われている暗号の方式である。暗号化に使う鍵と復号に使う鍵が同じなので、「共通鍵暗号」と呼ぶ。
- 256は、鍵の長さが256ビットという意味である。長いほど、鍵を総当たりで探すのに時間がかかる。
- GCMは、暗号化の手順の種類(モード)の1つである。暗号化と同時に、改ざんを見つけるための印(認証タグ)を作る。このように、暗号化と改ざんの検出を一度に行う方式を「認証付き暗号」と呼ぶ(AesGcm クラス)。
GCMには、もう1つ守るべき決まりがある。暗号化のたびに、nonce(ノンス)という使い捨ての番号を用意することである。本ツールでは96ビットの乱数を使う。同じ鍵で、同じnonceを2回使うと、暗号が破られるおそれがある。そこで、保存のたびに、暗号学的乱数でnonceを作り直している。自己テストにも「保存し直すとnonceが変わる」という試験が入っている。
暗号化するのは、登録内容をJSON(5.5で扱った、データを文字で表す形式)にした全体である。保管庫ファイルの構造を下表に示す。
暗号化するのは、登録内容をJSON(5.5で扱った、データを文字で表す形式)にした全体である。保管庫ファイルの構造を下表に示す。
| 位置(バイト) | 大きさ | 内容 | 暗号化 |
|---|---|---|---|
| 0~7 | 8 | 形式の識別子(PAHSV001) | しない |
| 8~11 | 4 | PBKDF2の反復回数 | しない |
| 12~43 | 32 | salt(次の節で説明する) | しない |
| 44~55 | 12 | 保管庫鍵を包むときのnonce | しない |
| 56~87 | 32 | 包まれた保管庫鍵 | する(包み鍵で) |
| 88~103 | 16 | 保管庫鍵を包んだときの認証タグ | しない |
| 104~115 | 12 | 本文用のnonce(保存のたびに変わる) | しない |
| 116~119 | 4 | 本文の長さ | しない |
| 120~ | 本文の長さ | 登録内容全体(JSON) | する(保管庫鍵で) |
| 末尾 | 16 | 本文の認証タグ | しない |
先頭の120バイトをヘッダーと呼ぶ。ヘッダーは暗号化しないが、本文の認証に加えている(追加認証データ)。そのため、ヘッダーのどこかを書き換えても、本文の復号に失敗する。反復回数をこっそり小さくするような細工も、見つけられる。
暗号化の部分を、CodexがC#で書いたコードで見てみよう。
暗号化の部分を、CodexがC#で書いたコードで見てみよう。
VaultCrypto.cs(本文の暗号化・抜粋。コメントは説明のために加えた)
public static byte[] Encrypt(VaultDocument document, byte[] key, byte[] envelope)
{
byte[] plain = JsonSerializer.SerializeToUtf8Bytes(document); // 登録内容全体をJSONにする
try
{
...(8 MiBの上限を超えていないか調べる)
byte[] bytes = new byte[HeaderLength + plain.Length + 16];
envelope.CopyTo(bytes, 0); // ヘッダーの前半(識別子・反復回数・salt・包まれた鍵)
RandomNumberGenerator.Fill(bytes.AsSpan(104, 12)); // 本文用のnonceを毎回作り直す
BinaryPrimitives.WriteInt32LittleEndian(bytes.AsSpan(116, 4), plain.Length);
using var aes = new AesGcm(key, 16); // 16 = 認証タグの長さ(バイト)
aes.Encrypt(bytes.AsSpan(104, 12), plain,
bytes.AsSpan(HeaderLength, plain.Length), // 暗号文の書き込み先
bytes.AsSpan(HeaderLength + plain.Length, 16), // 認証タグの書き込み先
bytes.AsSpan(0, HeaderLength)); // ヘッダー全体を認証に加える
return bytes;
}
finally { CryptographicOperations.ZeroMemory(plain); } // 使い終わった平文をメモリー上で0にする
}
注目してほしい点が3つある。
- 暗号の計算は、自作せずに、.NETが標準で備える AesGcm クラスを使っている。暗号は、自分で実装すると、ほぼ確実に間違える。実績のある部品を使うのが鉄則である。本ツールは、暗号のために外部のライブラリも使っていない。
- `Encrypt` の最後の引数にヘッダー全体を渡している。これが追加認証データである。
- `finally` の中の `ZeroMemory` で、使い終わった平文をメモリー上で0に上書きしている。ただし、仕様書にも書いたとおり、メモリー全体からの完全な消去を保証するものではない。
マスターパスワードから鍵を作る ― PBKDF2
AES-256の鍵は、256ビット、つまり32バイトの、でたらめに見えるバイト列である。人間が覚えられるものではない。人間が覚えるのは、12文字以上のマスターパスワードである。この2つをつなぐのが、鍵導出関数である。
本ツールは、PBKDF2-HMAC-SHA256を使う。パスワードとsalt(ソルト)を入力にして、ハッシュ計算(データから決まった長さの指紋を作る計算)を何十万回も繰り返し、32バイトの鍵を作る方式である。
本ツールは、PBKDF2-HMAC-SHA256を使う。パスワードとsalt(ソルト)を入力にして、ハッシュ計算(データから決まった長さの指紋を作る計算)を何十万回も繰り返し、32バイトの鍵を作る方式である。
saltと反復回数の意味を説明する。
- saltは、保管庫ごとにランダムに作る256ビットの値である。同じパスワードを使っても、saltが違えば別の鍵ができる。攻撃者が、よくあるパスワードの鍵を、あらかじめ計算して表にしておく手が使えなくなる。saltは秘密ではなく、ヘッダーにそのまま書いてある。
- 反復回数は、本ツールでは60万回である。正しい持ち主がパスワードを入力するのは、1回だけなので、60万回の計算でも気づかない。しかし、保管庫ファイルを盗んだ攻撃者が、パスワードを何億通りも試すときには、1回ごとの試行が重くなり、試せる回数が大きく減る。60万回という値は、OWASPがPBKDF2-HMAC-SHA256に推奨する回数に合わせた(Password Storage Cheat Sheet)。
VaultCrypto.cs(鍵の作成と導出・抜粋。コメントは説明のために加えた)
public const int Iterations = 600_000;
public static (byte[] Key, byte[] Envelope) CreateKey(string password) { ...(12~1024文字か調べる。反復回数と、ランダムなsalt・nonceをヘッダーに書く) byte[] key = RandomNumberGenerator.GetBytes(32); // 本文用のランダムな保管庫鍵 byte[] wrappingKey = Derive(password, envelope); // パスワードから包み鍵を作る using var aes = new AesGcm(wrappingKey, 16); aes.Encrypt(...); // 包み鍵で保管庫鍵を暗号化し、ヘッダーに入れる ... }
private static byte[] Derive(string password, ReadOnlySpan<byte> envelope) { byte[] bytes = Encoding.UTF8.GetBytes(password); try { return Rfc2898DeriveBytes.Pbkdf2(bytes, saltの位置, 反復回数, HashAlgorithmName.SHA256, 32); } finally { CryptographicOperations.ZeroMemory(bytes); } }
`Derive` の中身が、`Rfc2898DeriveBytes.Pbkdf2` の1行だけであることにも注目してほしい。ここも.NET標準の部品である(RFC 2898は、PBKDF2を定めた規格の旧い番号である)。
もう1つの工夫が、鍵の二段構えである。パスワードから作った鍵(包み鍵)で、本文を直接暗号化しているわけではない。本文を暗号化するのは、ランダムに作った別の鍵(保管庫鍵)で、包み鍵は、その保管庫鍵を暗号化してヘッダーに入れるためだけに使う。こうしておく利点は2つある。
もう1つの工夫が、鍵の二段構えである。パスワードから作った鍵(包み鍵)で、本文を直接暗号化しているわけではない。本文を暗号化するのは、ランダムに作った別の鍵(保管庫鍵)で、包み鍵は、その保管庫鍵を暗号化してヘッダーに入れるためだけに使う。こうしておく利点は2つある。
- 本文の鍵は、パスワードの強さに左右されない、256ビットの本物のランダム値になる。パスワードが推測されない限り、保管庫鍵は取り出せない。
- 保管庫鍵を別の方法で保護して取っておけば、マスターパスワードを入力しなくても保管庫を開ける。次の節で説明するWindowsによる解除は、これを使っている。
Windowsの機能で解除する ― DPAPI・Windows Hello
保管庫を使うたびに、12文字以上のマスターパスワードを打つのは大変である。そこで本ツールは、保管庫を解除する方法を、設定で4種類から選べるようにした。
| 解除方法 | 本人確認のしかた | ロックされるとき |
|---|---|---|
| マスターパスワード(既定) | 専用のアンロック画面にマスターパスワードを入力する | 無操作(既定5分)、メイン画面を閉じる、画面ロック・切断、スリープ |
| Windowsパスワードで解除 | Windows標準の資格情報入力画面で、現在のユーザーのWindowsパスワードを入力する | 同上 |
| WindowsのPINで解除 | Windows Helloの標準画面で確認する。Windows 11(build 22000以降)で、Windows Helloが使える場合だけ選べる。アプリはPINを受け取らず、保存もしない | 同上 |
| Windowsにサインイン中なら自動解除 | Windowsにサインインしていて、画面がロックされていなければ、自動で解除する | Windowsの画面ロック・サインアウト・切断・スリープと同時にロックする。無操作ではロックしない |
設定画面(取扱説明書より)
どの方式でも、保管庫の中身を暗号化しているのは、あくまで保管庫鍵である。Windows方式を選ぶと、その保管庫鍵を、DPAPIで包んで取っておく。DPAPI(Data Protection API)は、Windowsが、サインインしているユーザーのアカウントに結びつけた鍵で、データを暗号化してくれる仕組みである。同じユーザーでなければ復号できない(ProtectedData クラス)。
包んだ保管庫鍵は、設定ファイル `settings.json` の中に保存する。平文のマスターパスワードは、どこにも保存しない。
包んだ保管庫鍵は、設定ファイル `settings.json` の中に保存する。平文のマスターパスワードは、どこにも保存しない。
WindowsUnlock.cs(保管庫鍵をDPAPIで包む・抜粋)
public static string Protect(byte[] key, byte[] envelope)
{
byte[] entropy = SHA256.HashData(envelope); // 保管庫ごとに違う、追加の秘密
try { return Convert.ToBase64String(ProtectedData.Protect(key, entropy, DataProtectionScope.CurrentUser)); }
finally { CryptographicOperations.ZeroMemory(entropy); }
}
public static byte[] Unprotect(string token, byte[] envelope)
{
...(同じentropyを作り、ProtectedData.Unprotect で元に戻す。32バイトでなければ拒否する)
}
`DataProtectionScope.CurrentUser` が、「今サインインしているユーザーだけが復号できる」という指定である。`entropy`(追加の秘密)には、ヘッダー前半のSHA-256ハッシュを使う。ヘッダーは保管庫ごとに違うので、別の保管庫には流用できない。
Windowsパスワードによる確認では、Windows標準の資格情報入力画面(`CredUIPromptForWindowsCredentials`)を出し、入力された内容を `LogonUser` で検証する。そのうえで、確認できたユーザーのSID(ユーザーを区別する番号)が、今サインインしているユーザーと同じときだけ解除する。パソコンの別の管理者アカウントのパスワードでは解除できない。PINの確認は、Windows Helloの標準画面にまかせる。どちらも、アプリが秘密を受け取らない設計である。
ここで、正直に書いておくことがある。PINやWindowsパスワードの確認は、アプリの本人確認である。保管庫鍵を守っているのは、DPAPIである。DPAPIは、別のユーザーや別のパソコンからは守るが、同じユーザーで動くプログラムからは守らない。仕様書にも、「同じWindowsユーザーで動作する悪意あるプログラムまでは防げるという保証はない」と書いた。詳しくは「保管庫のセキュリティ強度と限界」で整理する。
自動ロックの仕組みも、Windowsの通知を使う。画面のロック、サインアウト、リモート接続の切断が起きると、保管庫をロックする。スリープに入るときもロックする。Windowsの状態を確認できないときは、解除しない側に倒す。自動解除方式では、さらに10秒ごとの定期確認でも、Windowsのロックを検出している。
Windowsパスワードによる確認では、Windows標準の資格情報入力画面(`CredUIPromptForWindowsCredentials`)を出し、入力された内容を `LogonUser` で検証する。そのうえで、確認できたユーザーのSID(ユーザーを区別する番号)が、今サインインしているユーザーと同じときだけ解除する。パソコンの別の管理者アカウントのパスワードでは解除できない。PINの確認は、Windows Helloの標準画面にまかせる。どちらも、アプリが秘密を受け取らない設計である。
ここで、正直に書いておくことがある。PINやWindowsパスワードの確認は、アプリの本人確認である。保管庫鍵を守っているのは、DPAPIである。DPAPIは、別のユーザーや別のパソコンからは守るが、同じユーザーで動くプログラムからは守らない。仕様書にも、「同じWindowsユーザーで動作する悪意あるプログラムまでは防げるという保証はない」と書いた。詳しくは「保管庫のセキュリティ強度と限界」で整理する。
自動ロックの仕組みも、Windowsの通知を使う。画面のロック、サインアウト、リモート接続の切断が起きると、保管庫をロックする。スリープに入るときもロックする。Windowsの状態を確認できないときは、解除しない側に倒す。自動解除方式では、さらに10秒ごとの定期確認でも、Windowsのロックを検出している。
壊さずに保存する ― 置き換え保存・バックアップ・世代履歴
保管庫は、1つのファイルである。保存している途中で電源が落ちたり、ウイルス対策ソフトがファイルを一瞬つかんだりして、書きかけのファイルが残ったら、すべてのパスワードを一度に失う。パスワード管理ツールの保存は、ふつうのアプリの保存より慎重に作る必要がある。
本ツールの保存は、置き換え保存である。手順は3つである。
- 新しい内容を、本物のファイルの隣に作る一時ファイルへ、最後まで書く。書き込みをディスクまで確実に反映させる指定(`FileOptions.WriteThrough` と `Flush(true)`)を付ける。
- 書き終わってから、`File.Replace` で本物のファイルと一瞬で入れ替える。このとき、入れ替え前のファイルを `vault.pahvault.previous` として残す。
- 入れ替えが一時的な競合で失敗したときは、30ミリ秒から倍々に待ち時間を延ばして、最大5回やり直す。
VaultCrypto.cs(AtomicFile:置き換え保存・抜粋)
public static void Write(string path, byte[] bytes, bool preservePrevious)
{
string temp = path + "." + Guid.NewGuid().ToString("N") + ".tmp";
try
{
using (var stream = new FileStream(temp, FileMode.CreateNew, FileAccess.Write, FileShare.None, 4096, FileOptions.WriteThrough))
{ stream.Write(bytes); stream.Flush(true); }
if (File.Exists(path))
{
...(共有違反などの一時的な失敗は、30ミリ秒から倍々に待って最大5回やり直す)
File.Replace(temp, path, preservePrevious ? path + ".previous" : null);
}
else File.Move(temp, path);
}
finally { if (File.Exists(temp)) File.Delete(temp); }
}
`finally` の中で、残った一時ファイルを片付けている。ここで消すのは、自分が作った一時ファイルだけである。自己テストでも、書きかけの一時ファイルが取り残されていても、正式な保管庫の読み込みに影響しないことを試している。
保管庫に関わるファイルは、`%LOCALAPPDATA%\pahooSecretVault` に置く。
保管庫に関わるファイルは、`%LOCALAPPDATA%\pahooSecretVault` に置く。
| ファイル・フォルダー | 内容 |
|---|---|
| vault.pahvault | 保管庫本体。全体を暗号化した単一ファイル |
| vault.pahvault.previous | 書き換え前の1つ前のファイル。暗号化したまま |
| backups フォルダー | 定期バックアップと手動バックアップ。暗号化したまま |
| settings.json | 設定。Windows方式を選んだときは、DPAPIで包んだ連携鍵も入る。平文のマスターパスワードは入らない |
| browser-clients.json など | ブラウザ連携の設定 |
次に、バックアップである。ファイルが壊れたり、パソコンが故障したりしたときの備えである。
- 保管庫を復号せず、暗号化したままコピーする。そのため、ロック中でも実行できる。
- 自動バックアップは既定で5日(120時間)おき(設定で1~240時間)、保存期間は暦年で1年である。1年を超えた古いバックアップだけを自動で削除する。
- バックアップに失敗したときは、成功した日時を進めず、世代の削除もしない。削除するのは、本ツールの命名規則と保存場所を確かめたファイルだけで、無関係なファイルは消さない。自己テストにも、無関係なファイルが残る試験が入っている。
- リストア(復元)では、選んだ暗号化ファイルのパスワードと内容を確かめ、承認してから、現在の保管庫を置き換える。置き換える前の保管庫も、暗号化バックアップとして残す。パスワードが合わないときは、現在のファイルを書き換えない。
コピーした秘密を自動で消す
パスワードを「コピー」して貼り付けるとき、パスワードは、いったんクリップボードに置かれる。クリップボードは、パソコンの中のどのアプリからも読める場所である(5.5で扱った)。貼り付けた後も残り続ければ、他のアプリに読まれるおそれがある。
そこで本ツールは、「コピー」ボタンでコピーした内容を、約30秒後にクリップボードから消す。ただし、消すのは、クリップボードに同じ内容が残っているときだけである。30秒のあいだに、利用者が別のものをコピーしていたら、その内容を消してはいけない。ロックしたときにも、同じ条件で消す。
MainWindow.cs(コピーと自動消去・抜粋)
private void CopySecret(string value, bool requireUnlocked = true)
{
if ((requireUnlocked && !store.IsUnlocked) || value.Length == 0) return;
try { Clipboard.SetText(value); copiedSecret = value; clipboardExpiry = DateTimeOffset.UtcNow.AddSeconds(30); ... }
catch { SetMessage("クリップボードを利用できませんでした。"); }
}
private void ClearClipboard()
{
try { if (copiedSecret != null && Clipboard.ContainsText() && Clipboard.GetText() == copiedSecret) Clipboard.Clear(); }
catch { }
copiedSecret = null; clipboardExpiry = null;
}
コピーした内容を `copiedSecret` に控えておき、期限が来たら、今のクリップボードの文字列と比べて、同じときだけ `Clipboard.Clear()` で消す。期限は、10秒ごとの定期確認の中で調べる。
この仕組みには限りがある。`Clipboard.Clear()` が消すのは、今のクリップボードである。Windows 11のクリップボード履歴(Windowsキー+V)をオンにしている場合や、「5.5 クリップボード履歴ツール」で作ったpahooClipのような履歴ツールを常駐させている場合は、コピーした時点で、履歴の側にも記録されることがある。履歴に残った分は、本ツールからは消せない。本ツールは、コピーした内容をクリップボード履歴の対象から外す指定もしていない。この点は、次の節の限界の表にも入れる。
この仕組みには限りがある。`Clipboard.Clear()` が消すのは、今のクリップボードである。Windows 11のクリップボード履歴(Windowsキー+V)をオンにしている場合や、「5.5 クリップボード履歴ツール」で作ったpahooClipのような履歴ツールを常駐させている場合は、コピーした時点で、履歴の側にも記録されることがある。履歴に残った分は、本ツールからは消せない。本ツールは、コピーした内容をクリップボード履歴の対象から外す指定もしていない。この点は、次の節の限界の表にも入れる。
保管庫のセキュリティ強度と限界
ここまでで、保管庫は、AES-256-GCMで暗号化し、PBKDF2で鍵を作り、置き換え保存で壊れにくくしていることが分かった。では、この保管庫は安全だと言えるだろうか。答えは、「何から守るかによる」である。
「AES-256を使っている」という方式の名前だけで、安全性は決まらない。守れる脅威と、守れない脅威を、分けて考える必要がある。
「AES-256を使っている」という方式の名前だけで、安全性は決まらない。守れる脅威と、守れない脅威を、分けて考える必要がある。
まず、守れることを表にまとめる。
| 脅威 | 対策 | どこまで効くか |
|---|---|---|
| 保管庫のファイルやバックアップを盗まれた | AES-256-GCMで全体を暗号化。PBKDF2で、パスワードの試行を重くする | 中身は読めない。ただし、パスワードの推測は試せるので、マスターパスワードが強いかどうかが決め手になる |
| ファイルの改ざん、破損 | GCMの認証タグと、ヘッダーの認証 | 復号に失敗し、保管庫を書き換えない。診断で、失敗した箇所(鍵の段階か本文か)を確かめられる |
| Windows方式の連携鍵を別のユーザー、別のパソコンへ持ち出された | DPAPI(CurrentUser)と、保管庫ごとに違う追加の秘密 | 別の環境や別の保管庫では使えない |
| 似たサイトや別のポートへの誤った記入 | スキーム・ホスト・ポートが一致する同一originだけに限る。HTTPSと、LAN内のHTTP以外は対象外。見えない欄や隠れた欄には記入しない | 登録したサイトと違うサイトには、記入しない。ただし、登録したサイトそのものが乗っ取られた場合は防げない |
| 開発者やクラウドへの流出 | 同期、広告、解析用の送信を実装していない | 保管庫の中身が外へ出ていく経路が無い。ただし、サイトアイコンの取得で対象サイトへは通信する |
| コピーしたパスワードの置きっぱなし | 約30秒後の自動消去 | 履歴機能に残った分は消せない(下表) |
次に、守れないことを表にまとめる。ここが、この節でもっとも大事である。
| 限界 | 理由 | 利用者の備え |
|---|---|---|
| 弱いマスターパスワード | コードが確かめるのは、12~1024文字という長さだけで、強さまでは判定しない。盗まれたファイルへの推測は、パスワードが弱ければ成功する | 長く、推測されにくいものにする。他のサービスと使い回さない |
| マスターパスワードの紛失 | 復元する機能は無い。バックアップやエクスポートも、同じパスワードで開く | 安全な場所に控える。控えの管理にも注意する |
| 同じWindowsユーザーで動く悪意あるプログラム | DPAPIは、同じユーザーのプログラムからは守らない。解除中は、復号したデータがメモリーにある | OSとウイルス対策を更新する。不審なソフトを入れない |
| 解除したままの端末の乗っ取り、席を外した隙 | 解除中は、誰でも使える状態になる | 自動ロックの時間を短くする。席を離れるときは、Windowsキー+Lでロックする。自動解除方式では、Windowsのロックがそのまま保管庫のロックになる |
| 画面・クリップボードの盗み見、キー入力の記録 | マスターパスワードの入力、画面表示、コピーは、盗み見られうる。コピーした内容は、Windowsのクリップボード履歴や履歴ツールにも残りうる | コピーより、黄色い鍵による記入を使う。履歴機能の対象を確かめる |
| 記入した後のページ側の処理 | フォームに記入された値は、そのページのものになる。サイトのスクリプトは、値を読める | 信頼できるサイトにだけ記入する |
| ブラウザや拡張機能の配布経路への攻撃 | 拡張機能は、各ブラウザのストアから導入する。ストアやブラウザ自体が侵害された場合は守れない | 公式のストアから導入し、更新を確かめる |
| 端末の故障、保管庫の消失 | クラウドへ同期しないので、パソコンが壊れたら、バックアップが無い限り戻せない | 暗号化バックアップを、別の媒体にも保管する |
| 第三者による検証が無いこと | 第三者によるセキュリティ監査は未完了である。Windows 10の実機や、すべての実サイトでの互換性の確認も、完了したとは言えない | 実績のある製品とは、確かさが同じではないことを理解して使う |
クラウド型のパスワード管理サービスと比べると、得手不得手が分かれる。クラウド型は、端末が壊れても情報が残り、複数の端末で使える。本ツールのようなローカル型は、サービス側から情報が漏れる経路が無いかわりに、バックアップと端末の管理が、すべて利用者の責任になる。どちらが優れているかではなく、何を守りたいか、どこまで自分で管理できるかで選ぶものである。
本ツールが想定するのは、保管庫のファイルが外へ流出する場合と、クラウド側の漏えいに巻き込まれる場合である。想定しないのは、利用中のパソコンそのものが侵害された場合である。この線引きを、仕様書にも、取扱説明書にも、そのまま書いてある。「安全です」と言い切らず、守れないことを書くのが、パスワード管理ツールの誠実な説明である。
本ツールが想定するのは、保管庫のファイルが外へ流出する場合と、クラウド側の漏えいに巻き込まれる場合である。想定しないのは、利用中のパソコンそのものが侵害された場合である。この線引きを、仕様書にも、取扱説明書にも、そのまま書いてある。「安全です」と言い切らず、守れないことを書くのが、パスワード管理ツールの誠実な説明である。
はじめてのブラウザ拡張機能
ここからは、本ツールのもう1つの柱であるブラウザ拡張機能を扱う。拡張機能は、ブラウザに機能を足す小さなプログラムである。ツールバーに並んでいる広告ブロックや翻訳の機能が、その例である。筆者がブラウザの拡張機能を作らせたのは、今回がはじめてである。
拡張機能の中身は、Webページと同じHTML、CSS、JavaScriptである。第1章から第4章で作った、ブラウザの中で動くJavaScriptのアプリと、同じ言語で書く。違うのは、ページの中ではなく、ブラウザそのものに組み込まれて動くことである。ChromeとEdgeは、同じ仕組み(Chromium系)なので、同じ拡張機能が動く。Firefoxは、ほぼ同じ仕組み(WebExtensions)で、細かな違いだけを吸収すればよい。

拡張機能は、いくつかの部品でできている。本ツールの拡張機能の部品を下表に示す。
拡張機能は、いくつかの部品でできている。本ツールの拡張機能の部品を下表に示す。
| ファイル | 部品の種類 | 役割 |
|---|---|---|
| manifest.json | 設計図 | 拡張機能の名前、版、必要な権限、どのファイルをどこで使うかを書く。拡張機能に必ず1つ必要なファイルである |
| popup.html / popup.js | ポップアップ | ツールバーのアイコンを押したときに開く小さな画面。保存済みの候補、「再検索」「手動保存」、「詳細」を表示する |
| background.js | サービスワーカー | 画面の裏で動く処理。本体との通信、BASIC認証の監視、登録の確認の受け付けを担当する |
| key-content.js | コンテンツスクリプト | Webページの中に差し込まれて動く。黄色い鍵を表示し、入力を見張る |
| form.js | ページ内で実行する関数 | ページの中でフォームの欄を調べ、記入する。必要なときだけ、ページへ注入して実行する |
| site-settings.html | オプション画面 | 「全サイトへのアクセスを許可する」などの設定画面 |
このうち、サービスワーカーとコンテンツスクリプトは、聞き慣れない言葉だろう。
- コンテンツスクリプトは、Webページの中に差し込まれて、そのページのHTMLを直接読み書きできる。黄色い鍵をページに描くのも、入力欄を調べるのも、これである。ただし、ページ自身のJavaScriptとは、変数などを共有しない。
- サービスワーカーは、画面を持たず、必要なときに起動して、用が済むとしばらくして止まる。Manifest V3では、これが拡張機能の「裏方」である。止まっても困らないように、メモリー上に大事な状態を持たない作りにする。
manifest.json(拡張機能の設計図・抜粋)
{
"manifest_version": 3,
"name": "pahooSecretVault",
"version": "1.0.2",
"permissions": ["activeTab", "scripting", "nativeMessaging", "storage", "webRequest", "webRequestAuthProvider"],
"minimum_chrome_version": "108",
"optional_host_permissions": ["https://*/*", "http://*/*"],
"action": { "default_popup": "popup.html", "default_title": "pahooSecretVault" },
"background": { "service_worker": "background.js", "type": "module" },
"content_security_policy": { "extension_pages": "script-src 'self'; object-src 'none'" }
}
`manifest_version` の3が、現在の拡張機能の規格(Manifest V3)である。拡張機能は、できることの範囲(権限)を、ここへ前もって書いておく。本ツールの権限の意味を下表に示す。
| 項目 | 意味 |
|---|---|
| activeTab | 利用者がアイコンを押した、そのタブにだけ、一時的にアクセスする |
| scripting | ページの中で、プログラム(form.jsなど)を実行する |
| nativeMessaging | パソコンの中の本体と通信する(次の節) |
| storage | 小さな設定や診断情報を保存する。パスワードなどの秘密は保存しない |
| webRequest / webRequestAuthProvider | BASIC認証の要求を見つけて、認証情報を渡す(「BASIC認証を扱う」の節) |
| optional_host_permissions | 「どのサイトで動くか」の権限。[インストールしただけでは、どのサイトにも許可されない:red]。利用者が、サイトごとに、または全サイトに、許可したときだけ有効になる |
| content_security_policy | 拡張機能の画面で実行してよいプログラムを、拡張機能自身に含まれるものだけに限る。外から取り込んだプログラムは動かさない |
`optional_host_permissions` が「optional(任意)」であることに注目してほしい。パスワードを扱う拡張機能が、インストールした瞬間から、すべてのサイトを読めるのは、不安である。本ツールは、最小限の権限だけを持ち、サイトへの許可は利用者が出す設計にした。この許可の出し方は、「各ブラウザへの拡張機能の登録手順」で説明する。
Chrome・Edgeと、Firefoxの違いは、おもに2点である。1つは、裏方の書き方で、Chrome・Edgeは `service_worker`、Firefoxは `scripts` に `type: module` を付けた背景ページを使う。もう1つは、拡張機能のIDで、Firefoxでは自分で決めた `pahoosecretvault@pahoo.org` を使う。本ツールでは、機能のソースを共通にして、ビルド用スクリプト(Build-Extensions.ps1)でFirefox向けの構成を生成している。ChromeとFirefoxでは、拡張機能の機能を呼ぶ名前も違う(`chrome.*` と `browser.*`)ので、`globalThis.browser | globalThis.chrome` のように、どちらかを選ぶ小さな部品を挟んでいる。
Chrome・Edgeと、Firefoxの違いは、おもに2点である。1つは、裏方の書き方で、Chrome・Edgeは `service_worker`、Firefoxは `scripts` に `type: module` を付けた背景ページを使う。もう1つは、拡張機能のIDで、Firefoxでは自分で決めた `pahoosecretvault@pahoo.org` を使う。本ツールでは、機能のソースを共通にして、ビルド用スクリプト(Build-Extensions.ps1)でFirefox向けの構成を生成している。ChromeとFirefoxでは、拡張機能の機能を呼ぶ名前も違う(`chrome.*` と `browser.*`)ので、`globalThis.browser |
拡張機能から本体へつなぐ ― Native Messaging
拡張機能は、ブラウザの中の小さな世界で動いている。パスワードを保管する本体は、その外の、別のプログラムである。ブラウザは、拡張機能が勝手にパソコンの中の別のプログラムを起動することを許さない。許されている正規の方法が、Native Messagingである(Native messaging(Chrome for Developers))。仕組みは次のとおりである。
- 本体の側で、ホストマニフェストというJSONファイルを作り、起動してよいプログラムの場所と、許可する拡張機能のIDを書く。
- そのファイルの場所を、レジストリに登録しておく。
- 拡張機能が `connectNative` や `sendNativeMessage` で、ホストの名前を指定して呼び出す。
- ブラウザが、登録されたプログラム(ホスト)を起動し、標準入力と標準出力で、JSONのメッセージをやり取りする。メッセージの前には、長さを表す4バイトが付く。
本ツールのホストマニフェストは、次のようなJSONである。本体の「ファイル→ブラウザ連携」から登録すると、`%LOCALAPPDATA%\pahooSecretVault` に作られる。
native-host.json(ホストマニフェスト・Chrome/Edge用の例)
{
"name": "org.pahoo.secretvault",
"description": "pahooSecretVault local bridge",
"path": "C:\\Program Files\\pahoo.org\\pahooSecretVault\\pahooSecretVault.exe",
"type": "stdio",
"allowed_origins": [ "chrome-extension://domgmobhemlpeeapdhaelkdmokillfke/" ]
}
各項目の意味を下表に示す。
| 項目 | 内容 |
|---|---|
| name | ホストの名前。拡張機能は、この名前で呼び出す。本ツールは `org.pahoo.secretvault` |
| path | 起動するプログラムの場所。本体のEXEを指す。MSIで入れた場合は、マニフェストからの相対パスで指す。Store版は、アプリ実行エイリアス(`pahooSecretVault.StoreBridge.exe`)を指す |
| type | 通信の方式。現在は `stdio`(標準入出力)だけである |
| allowed_origins | 呼び出してよい拡張機能のID。Chrome・Edge用の項目で、ワイルドカードは使えない。Firefox用のマニフェストでは `allowed_extensions` に拡張機能のID(`pahoosecretvault@pahoo.org`)を書く |
| レジストリ(Chrome) | `HKCU\Software\Google\Chrome\NativeMessagingHosts\org.pahoo.secretvault` の既定値に、マニフェストの場所を書く |
| レジストリ(Edge) | `HKCU\Software\Microsoft\Edge\NativeMessagingHosts\org.pahoo.secretvault` |
| レジストリ(Firefox) | `HKCU\Software\Mozilla\NativeMessagingHosts\org.pahoo.secretvault`(Native messaging(MDN)) |
レジストリは、利用者ごとのHKCUと、パソコン全体のHKLMのどちらにも書ける。手動で登録するときはHKCU、MSIで入れるときはHKLMを使う。手動の登録がHKCUに残っていると、HKLMよりHKCUが優先されることがあり、これが後述のつまずきの原因になる。Store版は、本体がレジストリを書き換えられないので、「連携登録ファイルを作成」で保存した `.reg` ファイルを、利用者がエクスプローラーから適用する(HKCUの3件)。
ブラウザが起動するのは、本体と同じ pahooSecretVault.exe である。本体として起動された場合と、ブラウザから呼ばれた場合を、起動時の引数で見分ける。Chromeは、第1引数に、呼び出した拡張機能のorigin(`chrome-extension://拡張機能のID/`)を渡す。Firefoxは、マニフェストの場所と拡張機能のIDを渡す。
ブラウザが起動するのは、本体と同じ pahooSecretVault.exe である。本体として起動された場合と、ブラウザから呼ばれた場合を、起動時の引数で見分ける。Chromeは、第1引数に、呼び出した拡張機能のorigin(`chrome-extension://拡張機能のID/`)を渡す。Firefoxは、マニフェストの場所と拡張機能のIDを渡す。
Program.cs(起動方法を見分ける・抜粋)
string? origin = args.FirstOrDefault(a => a.StartsWith("chrome-extension://", StringComparison.Ordinal));
if (origin == null && args.Length >= 2 && args[1] == BrowserRegistration.FirefoxId && args[0].EndsWith(".json", StringComparison.OrdinalIgnoreCase))
origin = BrowserRegistration.FirefoxId;
if (args.Contains("--native-host") || origin != null)
{
NativeBridge.Run(paths, origin ?? Value(args, "--origin") ?? "").GetAwaiter().GetResult(); // 中継役として動く
return 0;
}
...(それ以外は、通常の本体として起動する)
中継役になったEXEは、標準入力からメッセージを1つ受け取り、本体へ渡し、返事を標準出力へ書く。メッセージは、先頭の4バイトが長さ、続けてUTF-8のJSONである。本ツールは、2バイト未満や64KBを超える長さのメッセージを、不正として断る(Chromeが許す大きさは、これよりずっと大きい)。自己テストにも、長すぎるメッセージや途中で切れたメッセージを断る試験が入っている。
中継役から本体への道には、5.5で扱った名前付きパイプを使う。pahooClipでは、コマンドを渡すために使った。本ツールでは、パスワードを運ぶので、接続できる相手を厳しく絞っている。
中継役から本体への道には、5.5で扱った名前付きパイプを使う。pahooClipでは、コマンドを渡すために使った。本ツールでは、パスワードを運ぶので、接続できる相手を厳しく絞っている。
NativeBridge.cs(本体の受け付け側・抜粋)
using var pipe = new NamedPipeServerStream(PipeName(paths), PipeDirection.InOut, 1,
PipeTransmissionMode.Byte, PipeOptions.Asynchronous | PipeOptions.CurrentUserOnly);
await pipe.WaitForConnectionAsync(stop);
...(90秒で打ち切るタイムアウトを設ける)
byte[] bytes = await ReadMessage(pipe, timeout.Token) ?? throw new InvalidDataException();
var request = JsonSerializer.Deserialize<BridgeRequest>(bytes, JsonOptions) ?? throw new InvalidDataException();
if (!IsAllowed(paths, request.ClientOrigin)) response = new { ok = false, error = "無許可の拡張です。" };
else response = await handler(request).WaitAsync(timeout.Token);
守りの工夫は4つある。
- パイプの名前に、保管庫の保存先から作ったハッシュ値(`pahooSecretVault-` に続く24桁)を使い、保管庫ごとに別の名前にする。
- `PipeOptions.CurrentUserOnly` を指定して、同じWindowsユーザーのプロセスだけが接続できるようにする。同時に待ち受けるのは1つだけである。
- 許可の確認を2回行う。中継役が、起動引数のoriginを許可リストと照らし、本体も、受け取った要求の `clientOrigin` を、もう一度許可リストと照らす。
- 拡張機能が送ってきたJSONに `clientOrigin` が入っていても、大文字小文字の違いまで含めて取り除き、ブラウザから渡されたoriginで上書きする。拡張機能が、他の拡張機能のふりをすることはできない。
ログインフォームを見つけて記入する
拡張機能の仕事の中心は、どれがIDの欄で、どれがパスワードの欄かを見つけることである。Webページは、HTMLの `input` 要素で入力欄を表している。コンテンツスクリプトは、ページのHTML(DOM)をたどって、欄を調べる。
欄の見分け方を、下表に整理する。
| 対象 | 判断のしかた |
|---|---|
| パスワード欄 | `type="password"` の欄。表示切替で `type="text"` に変わった欄でも、`autocomplete` に `current-password` がある欄、または `id` が `password` で、`placeholder` に「パスワード」か「password」とある欄は、パスワード欄とみなす。見えているパスワード欄が1つだけのフォームに限り、2つ以上あれば中止する |
| ID欄 | `autocomplete` が `username` の欄を最優先する。無ければ、`type="email"` などの欄。それも無ければ、`name`、`id`、`placeholder`、ラベルに、user、email、login、account、「サインイン」「メール」「会員」「ユーザー」などの語を含む欄 |
| IDだけの1段階目 | IDだけを入れて「次へ」を押し、次の画面でパスワードを入れるサイトに対応する。IDだけの段階に、パスワードを渡すことはしない |
| 対象にしないもの | 新しいパスワードを作る画面(`new-password`)、カードのセキュリティコード欄(`cc-csc`、cvv、cvcなど)、CAPTCHAやワンタイムパスワードの欄、曖昧な欄 |
もう1つ大事なのは、その欄が、本当に人の目に見えているかを確かめることである。画面の外に出した欄、透明にした欄、別の部品で覆い隠した欄に、パスワードを書き込んでしまうと、悪意のあるページに値を読み取られかねない。そこで、記入の前に次のように調べる。
form.js(欄が見えているかを確かめる・抜粋)
function visible(input, acceptDescendants = false) {
if (input.disabled || input.readOnly || input.type === 'hidden') return false;
for (let node = input; node instanceof Element; node = node.parentElement) {
const style = getComputedStyle(node);
if (style.display === 'none' || style.visibility !== 'visible' || Number(style.opacity) === 0) return false;
}
...(画面に見えている部分の幅と高さを求め、8px未満なら false にする)
// 欄の上の9点のどこかで、その欄自身が最前面にあるかを確かめる
return [.2, .5, .8].some(x => [.3, .5, .7].some(y => {
const hit = document.elementFromPoint(left + width * x, top + height * y);
return hit === input || (acceptDescendants && hit && input.contains(hit));
}));
}
`getComputedStyle` で、表示の設定を調べる。`display: none` や、見えない設定、透明度0の欄は、見えていない。さらに、`document.elementFromPoint` で、欄の上の9つの点について、「その点にいちばん手前にあるのは、この欄か」を確かめる。どの点でも別の部品が手前にあれば、覆い隠されていると判断する。
そのうえで、記入してよいサイトを、厳しく絞る。
そのうえで、記入してよいサイトを、厳しく絞る。
| 決まり | 内容 |
|---|---|
| 許可したサイトだけ | 利用者が許可したサイトか、全サイト許可を出したときだけ動く。許可されていないサイトには、記入しない |
| 同一origin | スキーム(https)、ホスト名、ポート番号が、すべて一致するサイトだけを照合する。サブドメインが違う、ポートが違う、httpとhttpsの違いは、同じ扱いにしない |
| HTTPSが基本 | HTTPは、`localhost` と、10.x.x.x、172.16~31.x.x、192.168.x.x、127.x.x.xの数字のアドレスだけに限る。ホスト名からLANかどうかを推測しない |
| ページの本体だけ | ページの中に埋め込まれた別のページ(iframe)には、原則として記入しない。例外は、iCloudの中のApple認証画面だけである |
| 本物の操作だけ | 鍵のクリックが、`event.isTrusted`(人間の操作によるイベント)のときだけ受け付ける。ページのスクリプトが偽のクリックを送っても、動かない |
| 鍵の部品を触らせない | 鍵のボタンは、`attachShadow({ mode: 'closed' })` で作った、ページから中身を覗けない領域(Shadow DOM)に入れる |
| 確認中にページが変わったら中止 | 確認のあいだにページが移動したり、置き換わったりしたら、記入しない |
origin(オリジン)とは、スキーム、ホスト名、ポート番号の3つを合わせたものである。たとえば `https://example.com` と `https://example.com:8443` は、別のoriginである。登録したサイトに似せた偽サイトのURLは、originが一致しないので、鍵を押しても、記入されない。これが、パスワード管理ツールがフィッシング(偽サイトへの誘導)に効く理由の1つである。originを判定する部分を、JavaScriptで見てみよう。
origin-policy.js(対応するoriginかどうかの判定)
export function supportedOrigin(value) {
try {
const u = new URL(value);
if (u.username || u.password || !u.hostname) return null;
const parts = u.hostname.split('.').map(Number);
const privateV4 = parts.length === 4 && parts.every(n => Number.isInteger(n) && n >= 0 && n <= 255) &&
(parts[0] === 10 || parts[0] === 127 || (parts[0] === 192 && parts[1] === 168) || (parts[0] === 172 && parts[1] >= 16 && parts[1] <= 31));
return u.protocol === 'https:' || (u.protocol === 'http:' && (privateV4 || u.hostname === 'localhost')) ? u.origin : null;
} catch { return null; }
}
`new URL(value)` で、URLを部品に分ける。URLにユーザー名やパスワードが埋め込まれていたら、断る。HTTPSなら通し、HTTPのときは、`localhost` か、数字4つのプライベートアドレスのときだけ通す。判定のためにDNS(名前解決)は使わない。名前の解決結果を信用すると、偽の名前でLANのふりをされるおそれがあるからである。
サインイン画面で入力した内容を、保管庫へ登録する流れも、コンテンツスクリプトが受け持つ。
サインイン画面で入力した内容を、保管庫へ登録する流れも、コンテンツスクリプトが受け持つ。
key-content.js(入力を見張る・抜粋)
document.addEventListener('input', event => {
if (!event.isTrusted || !(event.target instanceof HTMLInputElement) || !['text', 'email', 'tel', 'password'].includes(event.target.type)) return;
registration.inputObserved = true;
clearTimeout(saveTimer);
saveTimer = setTimeout(offerRegistration, 1000); // 入力が1秒止まったら、登録の候補を本体へ渡す
}, true);
入力が続くあいだは待ち、1秒止まったときに1回だけ、登録の候補を本体へ渡す。本体は、確認ウィンドウを最前面に出し、題名(初期値はドメイン名)を確認する。承認すると、保管庫へ暗号化して保存する。キャンセルすれば、何も登録しない。すでに登録があるサイトで、入力が違っていれば、同じ登録を上書きする。上書きの前に、変更前の内容は世代履歴へ入る。
この自動登録は、サインインに成功したかどうかを判定していない。入力された値を、そのまま保存する処理である。パスワードを打ち間違えたまま保存してしまったときは、世代履歴で前の内容に戻せる。
下図は、拡張機能のポップアップである。サイトに登録した候補が出て、選ぶと、本体の確認を経て記入される。
この自動登録は、サインインに成功したかどうかを判定していない。入力された値を、そのまま保存する処理である。パスワードを打ち間違えたまま保存してしまったときは、世代履歴で前の内容に戻せる。
下図は、拡張機能のポップアップである。サイトに登録した候補が出て、選ぶと、本体の確認を経て記入される。
BASIC認証を扱う
サインインの方法には、フォームを使わないものもある。その1つがBASIC認証である。サーバーが「認証が必要」と答えると、ブラウザが、専用の小さなダイアログを出して、ユーザー名とパスワードを尋ねる。社内のサーバーや、公開前の試験用サイトで、よく使われる。
このダイアログは、ページのHTMLの中にあるのではなく、ブラウザ本体の画面である。そのため、コンテンツスクリプトでは、欄を見つけることも、記入することもできない。そこで、拡張機能のもう1つの手段、webRequestを使う。
このダイアログは、ページのHTMLの中にあるのではなく、ブラウザ本体の画面である。そのため、コンテンツスクリプトでは、欄を見つけることも、記入することもできない。そこで、拡張機能のもう1つの手段、webRequestを使う。
ブラウザが送るWebの通信(要求)を見張り、認証の要求を見つけたら、拡張機能が、認証情報を返す仕組みである(chrome.webRequest(Chrome for Developers))。本節の説明は、仕様書が前提にしているChrome・Edgeの場合である。

流れは、次のとおりである。
流れは、次のとおりである。
- ブラウザが認証を求められると、拡張機能が、そのサイトの保存済みの認証情報があるかを、本体へ尋ねる。
- 同じスキーム・ホスト・ポート・realm(サーバーが示す認証の領域の名前)で、保存したディレクトリの配下なら、候補が1件のとき、確認なしで自動的に使う。
- 未登録のとき、または候補が複数あるときは、本体が専用のウィンドウを出し、入力または選択を求める。
- 拡張機能は、受け取った認証情報をブラウザへ返す。
- サーバーが成功(2xxまたは3xx)で応えたことを確かめてから、はじめて保管庫へ保存する。
- 保存に必要な許可は、一度限りのチケット(最大2分)に結びつけておき、時間切れや失敗では捨てる。
basic-auth.js(認証情報を返す・成功を確かめて保存する・抜粋と整形)
// 認証が求められたとき
const reply = await native(api, { operation: 'basic-auth', url: details.url, realm: details.realm, error: count ? 'retry' : '' });
...
pending.set(details.requestId, { ticket: reply.ticket, url: details.url, realm: details.realm, tabId: details.tabId, at: Date.now() });
done({ authCredentials: { username: reply.userName, password: reply.password } }); // ブラウザへ返す
// 通信が終わったとき
if (details.url !== item.url || details.tabId !== item.tabId || details.statusCode < 200 || details.statusCode >= 400 || Date.now() - item.at > 120000 || ...) {
try { await native(api, { operation: 'basic-auth-discard', url: item.url, realm: item.realm, ticket: item.ticket }); } catch {}
return; // 成功でなければ保存しない
}
await native(api, { operation: 'basic-auth-commit', url: item.url, realm: item.realm, ticket: item.ticket }); // 保存する
`done({ authCredentials: ... })` が、ブラウザへ認証情報を渡す部分である。拡張機能は、ここで受け取った認証情報を、ブラウザへ渡したあと、手元に残さない。保存は、通信が成功(`statusCode` が200以上400未満)で終わり、2分以内で、同じURL、同じタブのときだけ、本体への `basic-auth-commit` で行う。それ以外は `basic-auth-discard` で、保存待ちを捨てる。パスワードを打ち間違えて401が返ったときに、間違った内容を保管庫へ保存してしまうことが無い。
同じ要求での認証の試行は、最大3回までである。4回目は取り消して、画面に結果を出す。
ここにも、限りがある。
同じ要求での認証の試行は、最大3回までである。4回目は取り消して、画面に結果を出す。
ここにも、限りがある。
- ブラウザが認証情報を覚えている(キャッシュしている)と、認証の要求自体が出ないので、拡張機能は働かない。
- プロキシの認証、Digest認証、NTLM認証、ページの中の画像などの要求は、対象外である。
- RoboFormなど、別の拡張機能もBASIC認証の情報を返す場合、ブラウザが別の拡張機能のものを優先することがある。本ツールは、使われなかったことを検出して、競合の可能性を案内する。BASIC認証を使うあいだは、競合する拡張機能の認証の機能を、無効にして使う。
各ブラウザへの拡張機能の導入手順
拡張機能を使えるようにするには、次の3つが必要である。
- ブラウザに、拡張機能を導入する。
- 本体に、その拡張機能のIDを登録して、Native Messagingの許可リストに入れる。
- 拡張機能に、記入してよいサイトへのアクセスを許可する。
本稿の執筆時点(2026年11月)で、Chrome・Edge・Firefoxの3つの拡張機能は、いずれもストアで公開されている。通常はストアから導入し、手動での導入は、ストアが使えないときや、開発中の確認に使う。ストアへの登録(提出)の手順は、あとの節で説明する。まず、Chromeの手順を示す。
| 方法 | 手順 |
|---|---|
| ストアから導入する(通常) | Chrome ウェブストアのpahooSecretVaultを開き、「Chromeに追加」を押す。IDの登録は不要である(Store版の本体は、さらに `.reg` ファイルを適用する) |
| 手動で導入する |
1. アドレス欄に `chrome://extensions` と入力して開く。 2. 右上の「デベロッパーモード」をオンにする。 3. 「パッケージ化されていない拡張機能を読み込む」を押し、配布物の `manual-extension\Chrome` フォルダを選ぶ。 4. 表示された拡張機能の「ID」(英小文字32文字)をコピーする。 5. 本体の「ファイル→ブラウザ連携」を開き、「拡張IDを登録」へ貼り付けて登録する(MSI版・開発版の場合。Store版は、「拡張ID」の欄へ貼り付けて、「連携登録ファイルを作成」を押し、できた `.reg` ファイルを適用する)。 |
| ブラウザ | 方法 | 手順 |
|---|---|---|
| Edge | ストアから導入する(通常) | Microsoft Edge Add-onsのpahooSecretVaultを開いて追加する。本体の「Edgeの拡張を追加」ボタンからも開ける。IDの登録は不要である(Store版の本体は、さらに `.reg` ファイルを適用する) |
| Edge | 手動で導入する |
1. `edge://extensions` を開く。 2. 「開発者モード」をオンにする。 3. 「展開して読み込み」を押し、`manual-extension\Edge` フォルダを選ぶ。 4. 拡張機能のIDを、本体の「ファイル→ブラウザ連携」へ登録する(Store版は、「拡張ID」の欄へ入れて、連携登録ファイルを作成する)。このフォルダの拡張機能のIDは、`kcmadgllhbbmappbphmknncfohgpiclp` になる(ストア版と同じ公開鍵を入れてあるため)。 |
| Firefox | ストアから導入する | Firefox Add-ons(pahooSecretVault)から追加し、本体の「Firefoxを登録」を押す。拡張機能のIDは固定(`pahoosecretvault@pahoo.org`)なので、IDの入力は要らない |
| Firefox | 一時的に読み込む | アドレス欄に `about:debugging#/runtime/this-firefox` を入力し、「一時的なアドオンを読み込む」で、`manual-extension\Firefox` の中の `manifest.json` を選ぶ。[Firefoxを終了すると消える:red]ので、試用向けである。あわせて、本体の「Firefoxを登録」を押す(一時的なインストール(Extension Workshop)) |
どの方法でも、最後に、サイトへのアクセスの許可が要る。「拡張機能とは」で説明したとおり、インストールしただけでは、どのサイトでも動かない。拡張機能のポップアップや設定画面(`site-settings.html`)で、「全サイトへのアクセスを許可する」を押すと、ブラウザの確認が出る。許可すると、ページを再読み込みしたあとから、黄色い鍵が出る。特定のサイトだけに限りたいときは、ブラウザの拡張機能の管理画面で、「サイトへのアクセス」を「特定のサイト」にして、サイトを追加する。
ブラウザごとの違いを、下表にまとめる。
ブラウザごとの違いを、下表にまとめる。
| 項目 | Chrome | Edge | Firefox |
|---|---|---|---|
| 必要な版 | 108以上 | 108以上 | 153以上 |
| ストアの状況(執筆時点) | 公開済み | 公開済み | 公開済み |
| 許可リストの項目 | allowed_origins | allowed_origins | allowed_extensions |
| 拡張機能のID | ストア版は固定、手動導入は割り当て | ストア版は固定、手動導入は割り当て | 固定 |
| 手動導入の注意 | デベロッパーモードが必要 | 開発者モードが必要 | 一時読み込みは再起動で消える |
| BASIC認証の自動記入 | 対応 | 対応 | 仕様書の対象外 |
登録のあと、ブラウザを開き直すと、本体の「ブラウザ連携」画面に、登録の状況が出る。ここが「登録済み」になっていて、拡張機能のポップアップから、保存済みの候補が出れば、つながっている。
うまく動かないときの調べ方
拡張機能は、本体、中継役、ブラウザ、Webサイトの4者が関わるので、うまく動かないとき、どこが悪いかが分かりにくい。本ツールには、切り分けのための診断を2つ用意した。
- 保管庫診断は、保管庫のファイルが開けるかを調べる。失敗したとき、原因がパスワードが違う(KEY_AUTH)のか、ファイルの本体が壊れている(BODY_AUTH)のかを、見分けて表示する。まず、パスワードから作った鍵で、ファイルの先頭にある保管庫の鍵を取り出せるかを調べ、取り出せなければKEY_AUTHとする。次に、取り出した保管庫の鍵で本体を開けるかを調べ、開けなければBODY_AUTHとする。この順で調べるので、「パスワードが違う」と「パスワードは合っているのに本体が壊れている」を混同しない。
- 入力・接続を診断は、拡張機能と本体のつながりを調べる。本体の起動、Native Messagingの登録、許可リスト、パイプの接続を順に確かめ、止まった箇所を示す。
ブラウザの拡張機能の詳細画面。IDや、サイトへのアクセスの設定を確かめる
本体の診断のほかに、ブラウザ側で、次の点を確かめるとよい。
- 拡張機能の管理画面(`chrome://extensions` など)で、拡張機能のIDが、本体に登録したものと同じか。
- 同じ画面の「サイトへのアクセス」が、対象のサイトで許可されているか。
- 対象のページを、許可したあとに、再読み込みしたか。
- 拡張機能の詳細にある「エラー」に、赤い表示が出ていないか。
- Chrome・Edgeでは、拡張機能の「サービスワーカー」の「検査」から、開発者ツールを開き、Consoleのメッセージを見る。
Codexに調査を頼むときは、症状と、上の確認の結果を、そのまま伝えるとよい。本ツールの開発でも、「黄色い鍵が出ない」「記入されない」と伝えると、Codexが原因の候補を挙げ、診断の機能を足してくれた。
現時点で分かっている、未解決の点も書いておく。
- サイトによっては、拡張機能が欄を見つけられなかったり、記入しても、サイト側が値を受け付けなかったりする。サイトの作りが多様なので、すべてのサイトでの動作は、保証できない。
- IDだけで認証するサイトの扱いは、検証が十分でない。
- Chromeでの黄色い鍵の表示は、最新版を導入した利用者による確認が、まだ終わっていない。
- ストア版は、版の更新の提出と公開を、別に待つ。Firefoxの署名済みの拡張機能は、配布物に同梱していない。
自己テストで動作を確かめる
パスワードを扱うツールは、壊れたことに気づかないまま使うのがいちばん怖い。そこで、Codexに、本体の中へ自己テストを組み込ませた。コマンドラインから起動すると、27項目の試験を自動で実行し、結果を表示する。試験には、実際の保管庫は使わない。テスト用のダミーの保管庫とダミーの認証情報だけを使う。主な試験は、次のとおりである。
| 分類 | 確かめること |
|---|---|
| 暗号 | 保存した保管庫のファイルに、平文(暗号化していない文字)が含まれない。保存のたびにnonceが変わる。パスワードが違っても、保管庫の内容は変わらない |
| 保存 | 置き換え保存の途中の一時ファイルが、正しく片付く。バックアップが、決めた数で入れ替わる |
| 拡張の安全 | origin判定が、決まりどおりに働く(https、プライベートアドレス、`localhost`、紛らわしいホスト名) |
| 通信 | Native Messagingのメッセージの形式(長さ、途中切れ、大きすぎる長さ)を確かめる。本物の中継役のプロセスを起動し、名前付きパイプを通して、往復する |
| 登録 | 各ブラウザへの登録(マニフェスト、レジストリ)が、正しく書き込まれる |
自己テストにも、限界がある。ブラウザの動作は、本物のブラウザではなく、代わりの部品(モック)で試す部分がある。そのため、実際のサイトで黄色い鍵が出るか、サイトが記入を受け付けるかは、自己テストでは確かめられない。ここは、人の目で、実際のサイトを使って確かめるしかない。自己テストは、「壊してしまったことにすぐ気づく」ための安全網であり、すべてを保証するものではない。
ストアに登録する ― 全体像
ストアに登録すると、利用者はストアの画面から、ふつうのアプリと同じように導入できる。更新も、ストアを通じて届く。その代わり、ストアごとに審査がある。
本ツールには、提出するものが4つある。提出先と状況を、下表にまとめる。
本ツールには、提出するものが4つある。提出先と状況を、下表にまとめる。
| 提出物 | 提出先 | 管理画面 | 版 | 状況 |
|---|---|---|---|---|
| 本体 | Microsoft Store | Partner Center(アプリとゲーム) | 1.2.1.0 | 1.1.1.0が公開済み(2026年11月14日までに公開) |
| Edge拡張機能 | Microsoft Edge Add-ons | Partner Center(Edge) | 1.0.3 | 公開済み(1.0.8は提出用に作成。公開は未確認) |
| Chrome拡張機能 | Chromeウェブストア | Chrome Developer Dashboard | 1.0.2 | 公開済み(1.0.8は提出用に作成。公開は未確認) |
| Firefox拡張機能 | Firefox Add-ons (AMO) | Add-on Developer Hub | 1.0.2 | 公開済み(承認済み)。1.0.8は署名済みXPIを入手済み、公開は未確認 |
AMOは、addons.mozilla.org の略で、Mozillaが運営するFirefox用アドオンの公式ストアである。4つの提出先は、画面も用語も違うが、流れは同じである。
- 開発者アカウントを作る。
- 提出物(ZIPまたはMSIX)をアップロードする。
- 掲載情報(名前、説明、スクリーンショット)と、データの取り扱いを記入する。
- 審査に出す。
- 合格すると、公開される。
AI生成コンテンツ / AI-generated content
ここで、人間とCodexの分担をはっきりさせておく。Codexが行うのは、提出物を作るところまでである。ストアへの申請と公開の操作は、管理画面で、人間が行う。申請は、取り消しにくいからである。仕様書にも、提出用ZIPを作る承認は、ストアへの申請・公開や、本体のMSIを作る承認を兼ねない、と書いてある。提出物の作成を頼む依頼文は、次のようになる。
プロンプト:ストア提出用のパッケージを作ってもらう
# 依頼 pahooSecretVault.md の「ストア提出用パッケージ」の節に従って、ストア提出用のパッケージを作ってほしい。作るのは次の4つである。 - Microsoft Store用の、本体のMSIX - Chromeウェブストア用の、拡張機能のZIP - Microsoft Edge Add-ons用の、拡張機能のZIP - Firefox Add-ons用の、拡張機能のZIP
# 条件 - 作る前に、対象の版を私に確認し、承認を得る。 - 提出用のZIPには、動作に必要なファイルとMIT Licenseだけを入れる。保管庫、認証情報、試験用のコードは入れない。 - 作ったファイルごとに、SHA-256を記録して報告する。 - ストアへの申請と公開は、私が管理画面で行う。ストアへは申請しない。 - 掲載文(説明)と、データの取り扱いの申告の案も作る。
以降の4つの節で、提出先ごとに、手順と、本ツールで引っかかった点を示す。管理画面の表記は、日本語と英語が混ざる。画面に出る名前を、そのまま書く。
本体をMicrosoft Storeへ登録する ― MSIX
AI生成コンテンツ / AI-generated content
Windowsアプリの本体は、Microsoft Storeに登録する。Microsoft Storeへの提出には、Microsoftの開発者向けの管理画面であるPartner Centerのアカウントが要る。

まず、Partner Centerのホームを開く。「アプリとゲーム」が、本体の提出先である。同じホームにある「Edge」は、次の節で使う、Edge拡張機能の提出先である。
まず、Partner Centerのホームを開く。「アプリとゲーム」が、本体の提出先である。同じホームにある「Edge」は、次の節で使う、Edge拡張機能の提出先である。
Partner Centerのホーム。本体は「アプリとゲーム」、Edge拡張機能は「Edge」から入る
「アプリとゲーム」を開くと、登録した製品の一覧が出る。新しい製品は、アプリ名を予約して作る。予約すると、製品ができ、Store IDという製品の番号が発行される。本ツールのStore IDは `9NNW1NQ42Q1T` である。製品の種類は、「MSIX または PWA アプリ」を選ぶ。
「アプリとゲーム」の概要。登録した製品が一覧に並ぶ
MSIXとは、Windowsアプリを1つのファイルにまとめる、Microsoft標準のパッケージ形式である。WiXで作るMSIと名前が似ているが、別のものである。MSIは、導入のときにファイルを配り、レジストリを書き換える。MSIXは、アプリを専用の場所に入れ、削除するときにきれいに外せる。
Microsoft Storeには、MSIXで出す。理由は、署名である。MSIXは、提出の時点では署名が無く、認定を通ったあとに、Microsoftが署名を付ける。証明書を自分で用意しなくてよい。
MSIXは、Codexが作る。`Build-StoreMsix.ps1` というスクリプトが、Windows SDKのMakeAppxで、自己完結型のx64ビルドから、未署名のMSIXを作る。本ツールの提出物は、次のとおりである。
Microsoft Storeには、MSIXで出す。理由は、署名である。MSIXは、提出の時点では署名が無く、認定を通ったあとに、Microsoftが署名を付ける。証明書を自分で用意しなくてよい。
MSIXは、Codexが作る。`Build-StoreMsix.ps1` というスクリプトが、Windows SDKのMakeAppxで、自己完結型のx64ビルドから、未署名のMSIXを作る。本ツールの提出物は、次のとおりである。
| 項目 | 内容 |
|---|---|
| ファイル名 | `pahooSecretVault_1.1.2.0_x64.msix`(本体は1.1.1。公開されたのは1.1.1.0) |
| 対象 | Windows 10 version 1809以降(ビルド17763)、x64(デバイスファミリーは `Windows.Desktop`、最小のOSの版は `10.0.17763.0`) |
| パッケージの名前(Identity/Name) | `studiopahoo.pahooSecretVault` |
| 発行元の表示名(PublisherDisplayName) | `studio pahoo` |
| 中身 | 実行に必要な492ファイル、取扱説明書、ライセンス。ソースコードと開発用の仕様書は入れない |
このうち、発行元の表示名で、本ツールは最初の関門につまずいた。最初にアップロードしたMSIXは、Partner Centerに拒否された。マニフェスト(パッケージの設計図にあたるファイル)の発行元の表示名を `Papa Pahoo` にしてあったが、Partner Centerに登録した名前は `studio pahoo` で、一致しなかったからである。Partner Centerが示す名前を、そのままマニフェストに入れるのが決まりである。表示名を直してMSIXを作り直すと、受け付けられた。
次に、制限付き機能である。MSIXのアプリは、安全のために、できることが絞られている。絞りを外す機能のうち、審査で理由を確かめるものを、制限付き機能という。本ツールが今、宣言しているのは、次の1つである。
| 機能 | 使う理由 |
|---|---|
| `runFullTrust` | Windowsデスクトップアプリとしての本体と、ブラウザ連携用の中継処理を、実行するため |
実は、最初の提出(1.0.2.0)では、もう1つ、`unvirtualizedResources` も宣言していた。MSIXのアプリは、ファイルやレジストリへの書き込みを、アプリ専用の場所へ振り替えられる。これを仮想化という。振り替えられると、ブラウザは、本体が書いた連携の登録を見つけられず、MSIで入れた従来版の保管庫も、MSIX版が開けなくなる。そこで、必要な場所だけを、仮想化の対象から外す宣言をしたのである。
ところが、認定のレポートの10.6.3で、Microsoftが、この機能の利用を認めなかった。認定は不合格となり、理由が報告に届いた。制限付き機能は、Partner Centerの「提出オプション」に、なぜ必要か、どう使うかを書いても、認定のときに、審査で承認されなければ使えない。
提出の前に、使い捨ての隔離環境(Windows Sandbox)で、MSIXを検証した。Windows Sandboxは、まっさらなWindowsを、パソコンの中に一時的に立ち上げる機能で、閉じると中身がすべて消える。ここで、インストールと起動、既存の保管庫の引き継ぎ、自己テスト33件、画面と中継の試験38件を確かめた。
この検証で、1つ、問題が見つかった。MSIXの中のEXEを、パッケージの外から直接起動すると、アクセスが拒否される。ブラウザは、パッケージの外から本体のEXEを起動するからである。対策として、Chrome・Edgeはアプリ実行エイリアス(Windowsが用意する、アプリを呼び出すための別名)を使い、Firefoxは専用の小さなランチャーから、同じ別名へつなぐ構成に変えた。変更後は、3つのブラウザの実物で、接続を確かめ直した。
10.6.3への対応では、`unvirtualizedResources` と、仮想化の除外の設定を、すべて外した。そのかわり、本体1.1.1では、次のように作り変えた。
ところが、認定のレポートの10.6.3で、Microsoftが、この機能の利用を認めなかった。認定は不合格となり、理由が報告に届いた。制限付き機能は、Partner Centerの「提出オプション」に、なぜ必要か、どう使うかを書いても、認定のときに、審査で承認されなければ使えない。
提出の前に、使い捨ての隔離環境(Windows Sandbox)で、MSIXを検証した。Windows Sandboxは、まっさらなWindowsを、パソコンの中に一時的に立ち上げる機能で、閉じると中身がすべて消える。ここで、インストールと起動、既存の保管庫の引き継ぎ、自己テスト33件、画面と中継の試験38件を確かめた。
この検証で、1つ、問題が見つかった。MSIXの中のEXEを、パッケージの外から直接起動すると、アクセスが拒否される。ブラウザは、パッケージの外から本体のEXEを起動するからである。対策として、Chrome・Edgeはアプリ実行エイリアス(Windowsが用意する、アプリを呼び出すための別名)を使い、Firefoxは専用の小さなランチャーから、同じ別名へつなぐ構成に変えた。変更後は、3つのブラウザの実物で、接続を確かめ直した。
10.6.3への対応では、`unvirtualizedResources` と、仮想化の除外の設定を、すべて外した。そのかわり、本体1.1.1では、次のように作り変えた。
- 保管庫は、Store版専用のローカルキャッシュ(アプリ専用の領域)へ保存する。
- 従来版の保管庫は、「ファイル→リストア」で、暗号化したまま取り込む。
- ブラウザ連携の登録は、本体が書き込まず、本体が作った `.reg` ファイルを、利用者がエクスプローラーから適用する。
提出の手順は、次のとおりである。Partner Centerの製品の画面で、順に埋める。項目の名前は、公式の資料の表記に合わせた。
| 順 | 画面の項目 | すること |
|---|---|---|
| 1 | Start submission | 製品の画面の「製品のリリース」から、提出を始める。下書きの提出ができる |
| 2 | Packages | MSIXをアップロードする。拒否された古いパッケージは、削除(Delete)で外す。デバイスファミリーのエラーが残るときは、Windows 10/11 Desktopを選び、Xboxなどのチェックを外す |
| 3 | Pricing and availability | 市場(Markets)、対象者(Audience)、ストアでの見つけやすさ(Discoverability)、公開の日程(Schedule)、価格(Base price)を設定する |
| 4 | Properties | 分類(Category)などを入れる。個人情報を集めて送る場合は、プライバシーポリシーのURLも要る。「Support Info」では、「Use different details for this app」を選び、「Support contact info」に、サポートの連絡先か開発者のサイトを登録する |
| 5 | Age ratings | 年齢区分の質問に、すべて答える |
| 6 | Store listings | 説明(Description)とスクリーンショットを、少なくとも1つの言語で入れる。スクリーンショットは、1枚以上が必須で、4枚以上が推奨である |
| 7 | Submission options | 制限付き機能の理由、審査担当者へのメモ(Notes for certification)、公開の保留(Publishing hold options)を入れる |
| 8 | Submit for certification | すべての区画が埋まったら、認定に提出する |
審査担当者へのメモには、確かめ方を書く。本ツールでは、次の内容を書いた。通知領域のアイコンから、メイン画面を開く。「ファイル→ブラウザ連携→連携登録ファイルを作成」で `.reg` ファイルを保存し、エクスプローラーから、利用者が適用する。登録するのは、`org.pahoo.secretvault` の、ユーザー別のホスト設定3件である。拡張機能で「入力・接続を診断」を実行して、接続の状態を確かめる。公開の保留は、3つから選ぶ。
- 認定に合格しだい、すぐに公開する(既定)。
- 「Publish now」を押すまで、公開しない。
- 指定した日時に公開を始める(提出から24時間以上先が必要)。
認定の所要時間は、通常は数時間で、場合によっては最大3営業日かかる、と画面に出る。合格すると、保留の設定がなければ、すぐに公開が始まる。本ツールは、前述の不合格のあと、設計を直した1.1.1.0を出し直して、2026年11月14日までに、Microsoft Storeで公開された。公式の手順は、Create an app submission for your MSIX appと、Manage submission optionsにある。
Edge拡張機能をEdge Add-onsへ登録する
AI生成コンテンツ / AI-generated content
Edgeの拡張機能は、Microsoft Edge Add-onsに登録する。管理画面は、本体と同じPartner Centerである。ホームの「アプリとゲーム」ではなく、「Edge」のワークスペースから入る。提出物は、ZIPである。ZIPの直下に、`manifest.json` と、拡張機能に必要なファイルを入れる。
提出の手順は、次のとおりである。
提出の手順は、次のとおりである。
| 順 | 画面の項目 | すること |
|---|---|---|
| 1 | Create new extension | 「Upload package (.zip file)」の画面で、ZIPをアップロードする。検証でエラーが出たら、直して、もう一度上げる |
| 2 | Availability | 公開の範囲を選ぶ。Publicは検索やストアから見つかる。Hiddenは、掲載ページのURLを知っている人だけが見つけられる。市場(Markets)は、既定ですべて |
| 3 | Properties | 分類(Category)が必須である。Webサイトやサポートの連絡先は任意 |
| 4 | Privacy | 拡張機能の目的(Single Purpose)、宣言した権限ごとの理由(Permission justification)、リモートコードの有無、集めるデータの種類(Data usage)、プライバシーポリシーのURLを入れる |
| 5 | Store listings | 言語ごとに、名前、説明(250〜10,000文字)、ロゴ(1対1、推奨300×300ピクセル)を入れる。スクリーンショットは最大6枚で任意。短い説明は、manifestの `description` から取られる |
| 6 | Publish | Store listingsが「Complete」になると押せる。審査担当者へのメモ(Notes for certification)を書き、もう一度Publishを押して提出する |
審査は、提出から最大7営業日かかる。合格すると、Partner Centerの状態が「In the Store」に変わり、公開される。公式の手順は、Publish a Microsoft Edge extensionにある。
本ツールのEdge拡張機能で、押さえた点は3つある。
本ツールのEdge拡張機能で、押さえた点は3つある。
- Privacyの申告を、実際の動作と合わせる。公式の資料は、申告が実際の動作と違うと、審査が長引いたり、却下されたりする、と書いている。本ツールの拡張機能は、パスワード欄の値を扱うが、開発者へは送らない。値は、同じパソコンの本体へ渡し、暗号化して保管する。
- 名前と説明を、英語と日本語で用意する。manifestの `default_locale` を `en`、`name` を `__MSG_ext_name__`、`description` を `__MSG_ext_description__` とし、`_locales/en` と `_locales/ja` の `messages.json` を、ZIPの直下の構成のまま入れた。画面と取扱説明書は、日本語のままである。
- 拡張機能のIDを、固定する。Edgeでは、Partner Centerから提供された公開鍵で、IDが決まる。本ツールのIDは `kcmadgllhbbmappbphmknncfohgpiclp` である。手動導入用の拡張機能にも、同じ公開鍵を入れて、同じIDにそろえた。IDをそろえる理由は、本体の許可リスト(Native Messagingの `allowed_origins`)にIDを書くからで、IDが変わると、本体につながらない。公開鍵は秘密鍵ではなく、IDの確認用である。
Chrome拡張機能をChromeウェブストアへ登録する
Chromeの拡張機能は、Chromeウェブストアに登録する。管理画面は、Chrome Developer Dashboardである。最初に、開発者として登録する。
- Chrome Developer Dashboardに、Googleアカウントでサインインする。
- 初回に出る登録の画面で、デベロッパー契約とポリシーに同意する。
- 一度だけの登録料を払う。
AI生成コンテンツ / AI-generated content
登録のときに、連絡先のメールアドレス(デベロッパーメール)を決める。作成後は、変更できない。変えたいときは、新しいアカウントを作って、拡張機能を移す。重要な通知が届くので、頻繁に見るアドレスを、できれば公開専用に用意するのがよい。また、新しい発行者は、公開できる拡張機能が最大2つに限られる。上限に達したときは、ダッシュボードから引き上げを申請できる。

拡張機能の提出の手順は、次のとおりである。
拡張機能の提出の手順は、次のとおりである。
| 順 | 画面の項目 | すること |
|---|---|---|
| 1 | Add new item | ZIPを選んで、アップロードする。上限は2GBである |
| 2 | Package | アップロードした内容を確かめる。作った直後は、編集できない |
| 3 | Store Listing | ストアに出す掲載の内容を入れる |
| 4 | Privacy | 拡張機能の目的(single purpose)と、ユーザーデータの取り扱いを申告する |
| 5 | Distribution | 有料か無料か、公開する国、見せる相手を設定する |
| 6 | Test instructions | 必要なときだけ、試験の手順や、試験用の認証情報を書く |
| 7 | Submit for Review | 確認の画面で、提出を確定する |
審査が終わったあと、公開までの期限は最長30日で、過ぎると下書きに戻り、出し直しになる。提出のときに自動公開のチェックを外すと、審査のあとも自動では公開されず、好きなときに公開できる。公式の手順は、Publish in the Chrome Web Storeと、Register your developer accountにある。
本ツールのChrome拡張機能で、押さえた点は3つある。
本ツールのChrome拡張機能で、押さえた点は3つある。
- ユーザーデータを扱う拡張機能は、プライバシーポリシーの掲載が必須である。公式のポリシーは、データをどう集め、使い、誰と共有するかを、正確に示すよう求めている。本ツールの拡張機能は、パスワード欄の値を扱うので、これに当たる。拡張機能の中には、データの取り扱いを説明するページ(`privacy.html`)を置いてある。
- 提出ZIPには、動作に必要なファイル(`manifest.json`、JavaScript、HTML、CSS、アイコン)と、MIT Licenseの全文、ブラウザ向けの `!最初に読んでください.txt` だけを入れる。開発用の `package.json`、試験用のコード、保管庫や認証情報は入れない。
- 登録の完了と、審査・公開の完了を、区別する。ZIPをアップロードして、下書きが保存できても、審査に合格して公開されたわけではない。
Firefox拡張機能をFirefox Add-ons(AMO)へ登録する
AI生成コンテンツ / AI-generated content
Firefoxの拡張機能は、Firefox Add-ons(AMO)に登録する。管理画面は、Add-on Developer Hubである。Mozillaのアカウントでログインして使う。Firefoxには、他のブラウザと違う点がある。ストアに出さなくても、署名という手続きが要る。署名のない拡張機能は、通常のFirefoxに、恒久的には入れられないからである。
Add-on Developer Hubの「My Add-ons」には、提出した拡張機能が一覧で出る。新しい拡張機能は、「Submit a New Add-on」から出す。
Add-on Developer Hubの「My Add-ons」には、提出した拡張機能が一覧で出る。新しい拡張機能は、「Submit a New Add-on」から出す。
提出の手順は、次のとおりである。
| 順 | 画面の項目 | すること |
|---|---|---|
| 1 | Submit a New Add-on | 配布の方法を選ぶ。「On this site」はAMOに掲載する。「On your own」は、AMOに載せず、署名だけを受けて、自分で配る。本ツールは「On this site」 |
| 2 | Upload Version | ZIPまたは `.xpi` を選ぶ(上限は200MB)。自動の検査が走り、エラーがあると進めない。警告は、とくにセキュリティとプライバシーに関するものを、確かめる |
| 3 | 対応プラットフォーム | 対応するプラットフォームを選ぶ |
| 4 | ソースコードの提出 | 提出の要否を選ぶ。要るときは、ソースコードのパッケージをアップロードする |
| 5 | Describe Add-on | 名前(Name)、URL、短い説明(Summary)、説明(Description)、分類(最大2つ)、サポートの連絡先、ライセンス、プライバシーポリシー、審査担当者へのメモ(Notes for Reviewers)を入れる |
| 6 | Submit Version | 提出する。受付の画面とメールが届く。公開のあとも、審査が続くことがある |
本ツールのFirefox拡張機能で、押さえた点は4つある。
- 専用のmanifestを使う。Firefoxは、背景の処理を `scripts` と `type: module` で書き、Chrome・Edgeは `service_worker` と `type: module` で書く。機能のソースは共有し、`Build-Extensions.ps1` が、Firefox向けの構成を作る。対象は、Firefox 153以上である。
- 拡張機能のIDは、固定である。`pahoosecretvault@pahoo.org` である。本体の許可リストは、Chrome・Edgeの `allowed_origins` ではなく、Firefox用の `allowed_extensions` を使い、2つを混ぜない。
- データの取り扱いを、正直に申告する。必須のデータとして、`authenticationInfo`(認証情報)、`browsingActivity`(閲覧の活動)、`websiteContent`(Webサイトの内容)を宣言した。Native Messagingも申告の対象なので、「収集なし」とは宣言しない。使う目的と送り先は、拡張機能の中の `privacy.html` に書いた。
- ソースコードの提出に備える。Firefox向けの構成は、共通のソースからスクリプトで作る。AMOは、ビルドの過程でコードを作るツールを使った拡張機能には、元のソースの提出を求める。このため、拡張機能のZIPとは別に、`pahooSecretVault_<版>_Firefox_review_source.zip` を用意した。中身は、生成前の共通ソース、2つのビルドのスクリプト、MIT License、英語の `README.md`、日本語の `!最初に読んでください.txt`、元の提出パッケージの全ファイルのSHA-256の一覧である。審査する側が同じものを作れるよう、Windows x64とPowerShell 7.6.5の環境で、別のフォルダに作り直し、拡張機能の全27ファイルの内容が一致することを確かめた。本体、実際の保管庫、認証情報は入れない。
バージョンアップ履歴 ― 1.0.0から1.2.1まで
ツールは、公開して終わりではない。正式版の1.0.0からの変更履歴を、下表にまとめる。なお、本体と拡張機能は、別々の版で管理する。拡張機能は各ブラウザのストアで、本体はMicrosoft Storeで、それぞれ更新されるからである。
| 版 | 対象 | 主な変更・到達点 |
|---|---|---|
| 1.0.0 | 本体・3ブラウザ拡張 | 正式版の画面と文書を整備。Firefox対応を追加し、WiXによるMSIと、各ブラウザの提出用ZIPを作成 |
| 1.0.1 | Firefox拡張 | AMOの自己配布向けの登録から、公開掲載向けの提出へ切り替える準備 |
| 1.0.2 | 3ブラウザ拡張 | 全サイト許可のワイルドカード(`*`)の処理を修正 |
| 1.0.2 | 本体 | パスワードを、Windowsのクリップボード履歴と端末間同期に載せないコピー方式を実装 |
| 1.0.3 | Edge拡張 | 拡張名と説明を、英語・日本語にローカライズ |
| 1.1.0 | 本体・MSI | チェックした項目の一括削除、起動時の通知領域への常駐を追加 |
| 1.1.1(1.1.1.0) | 本体・Store用MSIX | Storeの認定結果を受けて、ブラウザ連携の登録と、旧保管庫の移行方法を変更 |
| 1.1.2.0 | Store用MSIX | 最小のOSをWindows 10 version 1809(x64)へ変更。本体は1.1.1のまま |
| 1.2.0(1.2.0.0) | 本体・Store用MSIX | 設定のスライダー化、通知領域メニューの整理、App Installerの設定、配布物の個人情報検査 |
| 1.0.4 | Chrome拡張 | サインイン画面で、入力の直後に画面が切り替わる問題を修正。送信ボタンのクリック処理を使う方式に変更 |
| 1.0.5 | Chrome拡張 | form要素を持たないXの認証パネルに対応 |
| 1.0.6 | Chrome拡張 | 選んだIDを、次のパスワード画面へ引き継ぐ継続入力を追加 |
| 1.0.7 | Chrome拡張 | パネルの描画途中と、空の重複ID欄に対応。診断に継続入力の状態を追加 |
| 1.0.8 | 3ブラウザ拡張 | 本体との定期通信からも継続要求を確認。Chrome・Edge・Firefoxを1.0.8にそろえ、署名済みFirefox XPIを同梱 |
| 1.2.1(1.2.1.0) | 本体・Store用MSIX | 「OS起動時に起動する」設定を追加。Windowsへのサインイン時に、通知領域へ常駐 |
バージョン1.2.0では配布物の点検作業を加えた。これは、仕様書や画面画像、各種リソースに、機密情報や個人情報が残っていないかどうかを点検する作業である。具体的には次の作業を行った。
- リリースビルドのデバッグ情報を無効にした(DLLには、作ったパソコンのフォルダー名が入ることがあるため)。
- 仕様書に書いたフォルダーの場所を、環境変数と相対パスに変えた。
- 変更した画面の説明画像は、ダミーのデータで取り直した。
- 新しいMSIXと、検証用のZIPを展開し、ファイルの内容と、画像のメタデータに、対象の文字列が無いことを調べた。画像は、表示される内容も、目で確かめた。
AI生成コンテンツ / AI-generated content
1.2.0の試験は、内部試験34件とWPFの画面試験40件に合格した。Store提出用MSIXの493ファイルと、検証用MSIの展開後の650ファイルは、それぞれ、元のファイルと照合した。
拡張機能1.0.4〜1.0.8 実際のサイトで入力できるまで
1.2.0のあと、拡張機能は、実際のサイトで入力できない問題が続いた。1.0.4から1.0.8まで、5回直した。順に説明する。
1.0.4 NHK ONE:入力のすぐあとに、画面が切り替わった
NHK ONEのサインイン画面では、本体との接続、保管庫の解除、IDとパスワードの欄の検出が、すべて正常だった。それでも、入力した値が入った直後に、画面が切り替わった。原因は、拡張機能が、フォームの送信を直接実行していたことだった。多くのサイトは、送信ボタンをクリックしたときのJavaScriptの処理で、認証を行う。その処理を通さずに、HTMLのフォームを直接送信すると、サイトが想定した認証と違う動作になることがある。さらに、フォームの送信方法が指定されていないと、GETになり、入力した値がURLの末尾に入る恐れもあった。
そこで、送信ボタンが1つに決まるときは、サイト側のクリックの処理を動かす方式に変えた。あわせて、GETでの送信、ボタン側でGETに上書きする送信、別のサイトへの標準の送信を、拡張機能が止めるようにした。止めた場合も、入力した内容は残すので、利用者が、サイトの画面で操作を続けられる。修正後、正常に入力できることを、利用者の確認で確かめた。なお、記事や診断の資料には、認証情報を含むURLの文字列を載せないことにした。
1.0.5 Xの認証パネル:form要素が無い
Xでは、IDは入力できたが、次のパスワード欄への記入で問題が出た。診断では、パスワード欄は見つかっているのに、ID欄が、非表示か無効になっていた。従来の処理は、HTMLの `form` 要素があることを前提にしていた。ところが、Xの認証画面は、`form` 要素を持たないパネルだった。そこで、`form` 要素が無い認証パネルでも、表示中の入力欄に記入できるようにした。
記入のあとのボタン操作は、同じパネルの中で、「次へ」「続ける」「ログイン」「サインイン」などのボタンが1つに決まるときだけにした。無効なボタン、パネルの外のボタン、候補が複数あるときは、自動では押さず、利用者の操作に戻す。
1.2.0のあと、拡張機能は、実際のサイトで入力できない問題が続いた。1.0.4から1.0.8まで、5回直した。順に説明する。
1.0.4 NHK ONE:入力のすぐあとに、画面が切り替わった
NHK ONEのサインイン画面では、本体との接続、保管庫の解除、IDとパスワードの欄の検出が、すべて正常だった。それでも、入力した値が入った直後に、画面が切り替わった。原因は、拡張機能が、フォームの送信を直接実行していたことだった。多くのサイトは、送信ボタンをクリックしたときのJavaScriptの処理で、認証を行う。その処理を通さずに、HTMLのフォームを直接送信すると、サイトが想定した認証と違う動作になることがある。さらに、フォームの送信方法が指定されていないと、GETになり、入力した値がURLの末尾に入る恐れもあった。
そこで、送信ボタンが1つに決まるときは、サイト側のクリックの処理を動かす方式に変えた。あわせて、GETでの送信、ボタン側でGETに上書きする送信、別のサイトへの標準の送信を、拡張機能が止めるようにした。止めた場合も、入力した内容は残すので、利用者が、サイトの画面で操作を続けられる。修正後、正常に入力できることを、利用者の確認で確かめた。なお、記事や診断の資料には、認証情報を含むURLの文字列を載せないことにした。
1.0.5 Xの認証パネル:form要素が無い
Xでは、IDは入力できたが、次のパスワード欄への記入で問題が出た。診断では、パスワード欄は見つかっているのに、ID欄が、非表示か無効になっていた。従来の処理は、HTMLの `form` 要素があることを前提にしていた。ところが、Xの認証画面は、`form` 要素を持たないパネルだった。そこで、`form` 要素が無い認証パネルでも、表示中の入力欄に記入できるようにした。
記入のあとのボタン操作は、同じパネルの中で、「次へ」「続ける」「ログイン」「サインイン」などのボタンが1つに決まるときだけにした。無効なボタン、パネルの外のボタン、候補が複数あるときは、自動では押さず、利用者の操作に戻す。
1.0.6 選んだIDを、次の画面へ引き継ぐ
利用者が求めていたのは、ID画面で保存済み情報を選んだら、パスワード画面では、もう一度選ばなくても、入力が続くことだった。1.0.6では、IDだけの画面への記入が成功した時点で、選んだ登録と、タブ、サイトの場所(origin)、有効期限を結び付ける。次のパスワード画面で、同じアカウントだと確かめられたときに、1回だけ、続けて入力する。この継続入力には、次の制約を付けた。
利用者が求めていたのは、ID画面で保存済み情報を選んだら、パスワード画面では、もう一度選ばなくても、入力が続くことだった。1.0.6では、IDだけの画面への記入が成功した時点で、選んだ登録と、タブ、サイトの場所(origin)、有効期限を結び付ける。次のパスワード画面で、同じアカウントだと確かめられたときに、1回だけ、続けて入力する。この継続入力には、次の制約を付けた。
| 条件 | 実装した制約 |
|---|---|
| 操作の起点 | 利用者が、保存済み情報を明示的に選んで、IDを記入した後 |
| 入力先 | 同じタブ、同じoriginの認証画面 |
| 有効期限・回数 | 2分以内、1回限り |
| アカウントの確認 | 画面に残されたIDと、選んだIDを照合する |
| パスワード欄 | 空の autocomplete="current-password" の欄 |
| 保管庫 | 解除済みであること。継続入力のために、認証を迂回しない |
| 保留する情報 | 登録ID、ユーザー名、origin、有効期限。パスワードは、保留して保存しない |
| 送信 | 継続入力では、ログインのボタンを押さない |
手入力、アカウントの不一致、別のサイトへの移動、期限切れでは、継続入力を中止する。また、パスワードを取り出す前に、継続の要求を使用済みにして、同時に複数の確認が走っても、二重に入力しないようにした。継続入力の流れを、下図に示す。
AI生成コンテンツ / AI-generated content
ブラウザの試験は118件に合格した。ところが、利用者の実際のX画面では、入力されなかった。再現した画面での試験の合格と、実際のサイトでの解消は、別のことだと分かった。
1.0.7・1.0.8 診断の項目を増やして、原因を絞る
1.0.7では、利用者から、パスワードの入力欄は別のページではなく、パネルとして出る、との補足があった。確認の処理には、2つの欠点があった。1つは、パスワード欄を見つけた時点で、IDの照合の条件がそろっていないと、継続の要求を、すぐに捨てることである。もう1つは、サイトが補完用に持つ、空の重複したID欄まで、不一致として数えることである。そこで、空でないID情報が1つ以上あり、それらがすべて選んだIDと一致するときに、継続を認めた。空の重複欄は、数えない。ID情報が、まだ設定されていないときと、旧いID欄が表示中のときは、有効期限の中で、表示の状態を確かめ直す。空でないIDが違うときと、パスワードが手入力されているときの中止は、そのままにした。
あわせて、診断に `passwordContinuation` を加えた。入力値は集めない。継続の要求が有効か、どの段階で待ったか、中止したかを、確かめるためのものである。再現画面を含む124件の試験に合格したが、実際のサイトでは、まだ入力されなかった。利用者が示した診断には、`"active": true` と `"stage": "armed"` が残っていた。IDを選んだ記録は残っているのに、パスワード画面の確認の段階へ進んだ記録が無い、という状態である。この診断だけで、原因をすべて特定したわけではないが、直すべき処理の経路は、絞り込めた。
1.0.8では、黄色い鍵のページ監視に加えて、本体との定期的な通信(通常は約2秒おき)からも、継続の要求を確かめるようにした。対象は、IDを選んだ要求があるタブだけである。この確認でも、アクティブなタブか、ページが表示中か、同じorigin、サイトの許可、保管庫の解除、有効期限、IDの一致、パスワード欄が空であること、を調べ直す。すべてのページで、無条件にパスワードを入力する機能にはしていない。追加のブラウザの権限も、要求しない。
ページ監視のスクリプトの再導入も直した。単純な導入済みの印をやめて、版の情報と後始末の処理を持たせた。版が違うときや、旧い印があるときは、初期化し直す。同じ版の二重の導入は避け、差し替えるときは、旧いタイマーとイベントの監視を止める。診断には、監視スクリプトの版と、確認処理の状態(開始、完了、成功、操作中)を加えた。ID、パスワード、入力した長さ、入力値のハッシュは、含めない。
「ページ側から確認の要求が来ない」条件を含む132件の試験に合格した。そのあと、利用者から「パスワードまで入力できた」との報告があり、Xのパネルへの継続入力が、実際のサイトでも動くことを確かめた。ただし、これは、全サイト・全ブラウザでの入力の互換を、保証するものではない。
1.0.7・1.0.8 診断の項目を増やして、原因を絞る
1.0.7では、利用者から、パスワードの入力欄は別のページではなく、パネルとして出る、との補足があった。確認の処理には、2つの欠点があった。1つは、パスワード欄を見つけた時点で、IDの照合の条件がそろっていないと、継続の要求を、すぐに捨てることである。もう1つは、サイトが補完用に持つ、空の重複したID欄まで、不一致として数えることである。そこで、空でないID情報が1つ以上あり、それらがすべて選んだIDと一致するときに、継続を認めた。空の重複欄は、数えない。ID情報が、まだ設定されていないときと、旧いID欄が表示中のときは、有効期限の中で、表示の状態を確かめ直す。空でないIDが違うときと、パスワードが手入力されているときの中止は、そのままにした。
あわせて、診断に `passwordContinuation` を加えた。入力値は集めない。継続の要求が有効か、どの段階で待ったか、中止したかを、確かめるためのものである。再現画面を含む124件の試験に合格したが、実際のサイトでは、まだ入力されなかった。利用者が示した診断には、`"active": true` と `"stage": "armed"` が残っていた。IDを選んだ記録は残っているのに、パスワード画面の確認の段階へ進んだ記録が無い、という状態である。この診断だけで、原因をすべて特定したわけではないが、直すべき処理の経路は、絞り込めた。
1.0.8では、黄色い鍵のページ監視に加えて、本体との定期的な通信(通常は約2秒おき)からも、継続の要求を確かめるようにした。対象は、IDを選んだ要求があるタブだけである。この確認でも、アクティブなタブか、ページが表示中か、同じorigin、サイトの許可、保管庫の解除、有効期限、IDの一致、パスワード欄が空であること、を調べ直す。すべてのページで、無条件にパスワードを入力する機能にはしていない。追加のブラウザの権限も、要求しない。
ページ監視のスクリプトの再導入も直した。単純な導入済みの印をやめて、版の情報と後始末の処理を持たせた。版が違うときや、旧い印があるときは、初期化し直す。同じ版の二重の導入は避け、差し替えるときは、旧いタイマーとイベントの監視を止める。診断には、監視スクリプトの版と、確認処理の状態(開始、完了、成功、操作中)を加えた。ID、パスワード、入力した長さ、入力値のハッシュは、含めない。
「ページ側から確認の要求が来ない」条件を含む132件の試験に合格した。そのあと、利用者から「パスワードまで入力できた」との報告があり、Xのパネルへの継続入力が、実際のサイトでも動くことを確かめた。ただし、これは、全サイト・全ブラウザでの入力の互換を、保証するものではない。
Chromeでの一連の修正は、共通のソースにまとめ、Chrome・Edge・Firefoxの3つを、1.0.8にそろえた。Firefoxのバックグラウンドの構成と固定のアドオンID、Edgeのローカライズ、Chrome・Edgeの手動版の固定IDは、そのままにした。確認の途中で、Firefoxの手動導入用ソースの更新漏れが見つかったので、生成の処理へ加えた。各ストア用のZIPは、ルートに `manifest.json` を置く。Firefoxの審査用ソースZIPは、別に作り、再生成した25ファイルが、提出版と一致することを確かめた。
AI生成コンテンツ / AI-generated content
1.2.1 「常駐」と「自動起動」を分ける
本体1.2.0には、起動したあと、メイン画面を出さずに通知領域へ常駐する動作があった。しかし、Windowsへのサインインに合わせて、本体を起動する設定は無かった。この2つは、別のことである。1.2.1では、「編集→設定」に、「OS起動時に起動する」のチェックを加えた。初期値はオンで、以前の設定ファイルに項目が無いときも、オンとして読み込む。
本体1.2.0には、起動したあと、メイン画面を出さずに通知領域へ常駐する動作があった。しかし、Windowsへのサインインに合わせて、本体を起動する設定は無かった。この2つは、別のことである。1.2.1では、「編集→設定」に、「OS起動時に起動する」のチェックを加えた。初期値はオンで、以前の設定ファイルに項目が無いときも、オンとして読み込む。
利用者が明示的にオフにしたときは、その選択を保存する。ここでの「OS起動時」は、現在のユーザーが、Windowsにサインインした時点である。サインインの前から動くWindowsサービスは、作っていない。

起動の登録の方法は、配布の形で違う。
起動の登録の方法は、配布の形で違う。
| 配布の形 | 起動の登録 | 備考 |
|---|---|---|
| MSI版・展開版 | 現在のユーザーのRunキーへ、本体を登録する。実行ファイルのパスは引用符で囲み、--startup の引数を付ける | 初回の通常起動で登録する。管理者権限は要らない。空白を含む配置先にも対応する。設定をオフにすると、アプリ自身の登録値だけを削除する |
| Store版 | MSIXの windows.startupTask と、WindowsのStartupTask APIを使う。タスクIDは PahooSecretVaultStartup、初期状態は有効 | 通常のRunキーは使わない。WindowsApps内のパスは版ごとに変わるので、固定して登録できないからである。unvirtualizedResources は追加せず、runFullTrust の範囲のままにした |
動作の決まりは、次のとおりである。
- ダミー保管庫を使う試験や、`--data-dir` で起動するカスタム保管庫では、実際の自動起動の登録に、影響させない。
- 自動起動の要求で、すでに本体が常駐しているときは、既存のメイン画面を出さずに終了する。手動で二重に起動したときに、既存の画面を開く従来の動作は、そのままにした。
- Windows側で、利用者や組織のポリシーが、自動起動を無効にしているときは、アプリから、勝手に有効に戻さない。設定画面から有効にできないときは、Windowsの「設定→アプリ→スタートアップ」を確かめるよう、案内する。
- OSへの反映に失敗したときは、設定の変更を、成功として保存しない。設定画面に、エラーを出す。OS側を変えたあとで、設定ファイルの保存に失敗したときは、元の設定へ戻す。通常の起動での登録の失敗は、通知領域から案内し、本体の常駐は続ける。
1.2.1 検証と、配布物の作成
1.2.1の検証の結果を、下表にまとめる。
1.2.1の検証の結果を、下表にまとめる。
| 検証 | 結果・確認した内容 |
|---|---|
| 本体の基本試験 | 36件合格。暗号化、互換性、バックアップ、通信などの既存の機能と、自動起動の設定の初期値・移行・保存・登録の解除を確認 |
| 画面操作の試験 | 41件合格。チェックボックス、オンとオフの反映、OSが拒否したときに未保存で残る動作、通知領域への常駐などを確認 |
| 過去版EXEとの比較 | 対象のEXEが無かったので、1件をスキップ |
| Store用MSIXの構造 | Windows 10 build 17763以上、自動起動の宣言、既存の権限、インストール画面の設定を確認 |
| MSIの管理用展開 | 製品をインストールせずに展開し、650個の収録ファイルのSHA-256が一致 |
自動起動の試験は、専用の場所で行い、利用者の実際のスタートアップの登録を、書き換えない。画面の試験も、ダミーの保管庫を使った。最初の画面の試験では、既存のクリップボードの試験が1件失敗した。同じコードで再実行すると合格したので、最初のレポートは残し、再実行の結果と区別した。この1回の失敗の原因は、特定していない。
まだ確認できていないこともある。Windowsへ再サインインして、実際に自動起動する試験、今回のStoreパッケージを実際の環境へ導入する試験、Windows 10の実機やVMでの総合の試験は、完了していない。Xでの利用者の確認も、全サイト・全ブラウザでの入力の互換や、第三者によるセキュリティ監査を、意味するものではない。
検証の承認を受けて、1.2.1の正式なMSI、配布用ZIP、Store提出用のMSIX(1.2.1.0)を作成した。配布ZIPには、MSI、ヘルプと画像、仕様書、ライセンス、最初に読む文書、3ブラウザの手動導入用のファイルを入れた。MSIXには、App Installer用の設定(進行状況の表示と「準備ができたら起動」)を同梱した。Microsoft Storeの導入画面は、Storeが管理する。Store経由の実際の画面は、確認していない。
まだ確認できていないこともある。Windowsへ再サインインして、実際に自動起動する試験、今回のStoreパッケージを実際の環境へ導入する試験、Windows 10の実機やVMでの総合の試験は、完了していない。Xでの利用者の確認も、全サイト・全ブラウザでの入力の互換や、第三者によるセキュリティ監査を、意味するものではない。
検証の承認を受けて、1.2.1の正式なMSI、配布用ZIP、Store提出用のMSIX(1.2.1.0)を作成した。配布ZIPには、MSI、ヘルプと画像、仕様書、ライセンス、最初に読む文書、3ブラウザの手動導入用のファイルを入れた。MSIXには、App Installer用の設定(進行状況の表示と「準備ができたら起動」)を同梱した。Microsoft Storeの導入画面は、Storeが管理する。Store経由の実際の画面は、確認していない。
Firefoxの署名済みXPIは、次のように扱った。最初の配布物では、Firefoxのソースは1.0.8だったが、同梱できる署名済みXPIは、旧版の1.0.2だった。この違いは、導入の案内に明記した。そのあと、署名済みの1.0.8のXPIを入手した。拡張ID `pahoosecretvault@pahoo.org`、版1.0.8、署名の整合性を確かめ、25個の実行用ファイルを、共通のソースから生成したFirefox版と照合した。manifestは、MozillaによるJSONの整形の違いがあったので、意味上の内容で比べた。ここで確かめたのは、署名の整合性であり、Windowsの証明書による、Mozillaの信頼の判定ではない。署名済みのファイルは、中身を変えず、そのままコピーした。旧い1.0.2のXPIは、配布から外した。完成したMSIから取り出したXPIと、ZIPの中のXPIは、どちらも、原本とSHA-256が一致した。
最後に、1.2.0のときと同じ、個人情報と秘密情報の点検を行った。MSIX、ZIP、MSIの展開内容、同梱したXPIの中まで、計1,271件のファイルの内容を調べた。指定した個人名、秘密鍵、アクセスキーのパターンを、テキストだけでなく、バイナリとUTF-16の内容も対象にして検索した。ヘルプ用の画像は、表示して内容を確かめた。該当する内容は無かったが、この検査は、包括的なペネトレーションテストや、セキュリティ監査と同じではない。
最後に、1.2.0のときと同じ、個人情報と秘密情報の点検を行った。MSIX、ZIP、MSIの展開内容、同梱したXPIの中まで、計1,271件のファイルの内容を調べた。指定した個人名、秘密鍵、アクセスキーのパターンを、テキストだけでなく、バイナリとUTF-16の内容も対象にして検索した。ヘルプ用の画像は、表示して内容を確かめた。該当する内容は無かったが、この検査は、包括的なペネトレーションテストや、セキュリティ監査と同じではない。
よくあるつまずきと対処
本ツールの開発と、はじめての拡張機能の導入、ストアへの登録で出会ったつまずきを、下表にまとめる。
| 症状 | 原因 | 対処 |
|---|---|---|
| 拡張機能から本体へ接続すると、「Access forbidden(アクセスが禁止されています)」と出る | (MSI版・開発版の場合)HKCUのレジストリに、開発用の拡張機能のIDだけを許可した登録が残っていて、HKLMのMSIの登録より優先された | 本体の「ファイル→ブラウザ連携」から、使っている拡張機能のIDを、登録し直す |
| 黄色い鍵が出ない | サイトへのアクセスが許可されていない。許可のあと、ページを再読み込みしていない。パスワード欄が見えていない、または複数ある | 拡張機能の「サイトへのアクセス」を確かめ、ページを再読み込みする。「入力・接続を診断」を実行する |
| 許可したはずなのに、拡張機能が動かない | 全サイト許可を出したとき、ワイルドカードの扱いで、許可が正しく保存されなかった(`%2A` を含む記録) | 1.0.2の導入後に、「全サイトへのアクセスを許可する」を、もう一度実行する |
| Firefoxを再起動したら、拡張機能が消えた | 一時的に読み込んだ拡張機能は、再起動で消える | ストア版を導入するか、起動のたびに、読み込み直す |
| BASIC認証の情報が、記入されない | 他の拡張機能が、先に認証情報を返している。ブラウザが認証情報を覚えている | 競合する拡張機能の認証の機能を、無効にする。ブラウザに保存された認証情報を消す |
| 黄色い鍵を押しても、記入されない | サイトのoriginが、登録したものと違う(サブドメイン、ポート、http/https) | 登録のURLを確かめる。別のoriginなら、そのサイト用に、別に登録する |
| 本体が起動していないと言われる | 本体が終了している。パイプの名前が、保管庫の保存先と合っていない | 本体を起動し、保管庫を開く。保管庫の保存先を変えたら、ブラウザ連携を登録し直す |
| デバイスファミリーのエラーが残る | 対象に、Xboxなど、本ツールが動かない区分が含まれている | Windows 10/11 Desktopを選び、対象外のチェックを外す。最小のOSの版は、マニフェストの値(`10.0.17763.0`)で決まる。ここが22000だと、Windows 10では入手できない |
| 制限付き機能の警告が出る | `runFullTrust` などは、審査で理由を確かめる機能である。`unvirtualizedResources` は、認定レポートの10.6.3で、利用を認められなかった | 提出オプションの「制限付き機能」の欄に、なぜ必要か、どう使うかを書く。承認されない機能は、宣言から外し、設計を変える(本ツールは、保管庫をStore版専用の領域へ移し、連携登録を `.reg` ファイルにした) |
| MSIX版で、拡張機能から本体につながらない | MSIXの中のEXEを、パッケージの外から直接起動すると、アクセスが拒否される | アプリ実行エイリアスを使う構成にし、本体の「ブラウザ連携」で「連携登録ファイルを作成」を押して、できた `.reg` ファイルを適用する。エイリアスが無効なら、Windowsの設定で有効にしてから、もう一度適用する |
| AMOから、生成前のソースを求められる | Firefox向けの構成は、共通のソースからスクリプトで作るため | 生成前の共通ソース、ビルドのスクリプト、READMEをまとめた、別のソースZIPを提出する |
| 入力した直後に、サインイン画面が切り替わる | フォームの送信を直接実行すると、サイトの認証処理を通らないことがある | 拡張機能を1.0.4以降(現在は1.0.8)に更新する |
| IDだけ入り、パスワードが入らない(Xなどのパネル型) | form要素が無い画面、またはパネルの表示途中で、継続入力の確認が止まった | 拡張機能を1.0.8に更新する。診断の `passwordContinuation` で、継続要求の段階を確かめる |
| Windowsにサインインしても、本体が起動しない | 「OS起動時に起動する」がオフか、Windows側で自動起動が無効になっている | 「編集→設定」でオンにする。Windowsの「設定→アプリ→スタートアップ」でも有効にする。Store版は、アプリから強制的には戻せない |
本項では、パスワード保管ツールを題材に、AES-256-GCMとPBKDF2による暗号化、DPAPIとWindows Helloによる解除、置き換え保存とバックアップ、クリップボードの自動消去を、順に見てきた。そのうえで、保管庫の強度と、守れないことを、正直に書いた。後半では、はじめてのブラウザ拡張機能を作り、Native Messagingで本体とつなぎ、フォームへの記入とBASIC認証を扱い、3つのブラウザへの導入手順と、4つのストアへの登録(提出)手順を整理した。

個人の認証情報を、自分の手元だけで管理したい、という動機から出発した。クラウドに預ける便利さを手放すかわりに、バックアップと端末の管理を、自分の責任として引き受ける道である。その代わり、中身を知らないものに預けるのではなく、何をどう守り、何を守れないかを、自分で説明できるツールになった。Codexに依頼するときも、仕様書を先に書き、守る範囲と限界を、先に決めておくことが、いちばん効いた。
ストアの審査では、発行元の表示名の不一致、制限付き機能の理由、データの取り扱いの申告が、つまずきの種になった。どれも、仕様書と提出物に、あらかじめ書いておけることである。
個人の認証情報を、自分の手元だけで管理したい、という動機から出発した。クラウドに預ける便利さを手放すかわりに、バックアップと端末の管理を、自分の責任として引き受ける道である。その代わり、中身を知らないものに預けるのではなく、何をどう守り、何を守れないかを、自分で説明できるツールになった。Codexに依頼するときも、仕様書を先に書き、守る範囲と限界を、先に決めておくことが、いちばん効いた。
ストアの審査では、発行元の表示名の不一致、制限付き機能の理由、データの取り扱いの申告が、つまずきの種になった。どれも、仕様書と提出物に、あらかじめ書いておけることである。
参考サイト
- Native messaging:Chrome for Developers
- chrome.webRequest:Chrome for Developers
- Native messaging:MDN Web Docs
- Temporary Installation in Firefox:Firefox Extension Workshop
- AesGcm クラス:Microsoft Learn
- ProtectedData クラス:Microsoft Learn
- Password Storage Cheat Sheet:OWASP
- pahooSecretVault:Chrome ウェブストア
- pahooSecretVault:Microsoft Edge Add-ons
- pahooSecretVault:Firefox Add-ons
- Create an app submission for your MSIX app:Microsoft Learn
- Manage submission options:Microsoft Learn
- Publish a Microsoft Edge extension:Microsoft Learn
- Register your developer account:Chrome for Developers
- Publish in the Chrome Web Store:Chrome for Developers
- Submitting an add-on:Firefox Extension Workshop
- Source Code Submission:Firefox Extension Workshop
- Add-on Policies:Firefox Extension Workshop
- ぱふぅ家のホームページ:studio pahoo
(この項おわり)

2026年8月以降、クラウドサービスからの情報漏えいが続いていることに危機感を覚え、認証情報の管理をローカルストレージに閉じて行えるツールが欲しくなった。それが作った動機である。