仕様書
Sealed の暗号化のしくみを文書で公開:テストベクタ付き
Sealedはすべてのファイルを、保存する前にAES-256-GCMで暗号化します。 各ファイルにはそれぞれランダムな256ビットのキーが与えられ、そのキーは保管庫のキーで封印されます。 この仕様書には、Sealed 1.0.0 のすべての形式がバイト単位で書かれています。アプリが作ったテストベクタと、それを復号する別のプログラムも付いているので、主張を信じるのではなく、自分で確かめられます。
このページの内容
書かれていること
この仕様書は、Sealed 1.0.0 が保管したものをどう封印するかを、バイト単位で説明しています。
- 名前、メモ、レコードのフィールドを保持する封印された値。AES-GCMを使います。
- 写真、ビデオ、書類、サムネールのファイル形式。読み手が1つずつ検証できるチャンクに分かれています。
- リカバリーキー。Crockford Base 32の文字セットで書かれます。
- ほかの Sealed ユーザに送れるファイル。PBKDF2でパスフレーズから作った鍵でロックされます。
- バックアップが保持するレコードと、保存サービスにそのうち何が見えるか。
また、Sealed が暗号化しないもの(アプリのローカルデータベースにある日付やサイズなど)と、作り手が把握している限界も挙げています。写真だけでなく、名前、メモ、レコードの各項目も保管庫のキーで封印されます。 大きなファイルはチャンク単位で暗号化され、Sealedは変更、並べ替え、または途中で切り詰められたファイルを受け付けません。
対象のバージョン
この版は Sealed 1.0.0 の形式を対象とし、以降のバージョンもそれを読み取れます。その後に追加された機能、たとえば交換可能なリカバリーキー、保管庫のパスフレーズ、保管庫のオープンコピーは、この版には含まれていません。「設定」で新しいリカバリーキーを作成できます。現在のキーは、新しいキーが保存され、次のバックアップが終わるまで使え続け、古いキーと古いバックアップのコピーを持つ人は、そのコピーを開けるままです。 保管庫パスフレーズを使うと、保管庫のキーは、ロック解除のたびに入力するパスフレーズで封印され、それを失った場合は、リカバリーキーだけが保管庫を開けます。
3つのファイル
- **仕様書。**Markdownのテキストファイルです。形式ごとに節があり、各節に、読み手が拒否すべきものが書かれています。
- **テストベクタ。**アプリ自身のコードが作った入力と出力です。封印された値、さまざまなサイズのファイル、人が入力するさまざまな表記のリカバリーキー、パスフレーズでロックされたファイル、読み手が拒否すべき壊れた入力のセットが含まれます。
- **検証プログラム。**仕様書に書かれたことだけを使ってすべてのベクタを復号し、最初に一致しなかったものを報告するPythonのスクリプトです。
自分で確かめる
PythonとそのcryptographyパッケージがあればOKです。3つのファイルを1つのフォルダに置いて、次を実行します。
python3 -m venv venv
venv/bin/pip install cryptography
venv/bin/python3 -I verify_vectors.py vectors.json
プログラムは、ベクタのグループごとに、PASSかFAILの1行を出力し、最後にRESULTの行を出して終わります。このプログラムは、アプリのソースを見ずに、仕様書とベクタだけから書かれました。その最初の試みで文章に従えなかったところは、文章を直し、プログラムをもう一度実行しました。
合格が意味すること
合格は、仕様書の形式がベクタの形式であり、別に書かれた2つ目のプログラムがそれを読み取れる、ということです。つまり、鍵を持つ人なら誰でも、自分のコードで Sealed のファイルを読めます。
アプリが文書に書かれたことだけを行う、という意味ではありません。アプリのソースは公開されていません。Sealedは、独立したセキュリティ監査を受けていません。
Sealed が役立つこと、役立たないこと
役立つこと: 査読者、研究者、ほかの開発者が、ストアのページの一文を信じるのではなく、Sealed の形式を読み、ベクタを実行し、ファイルがどう封印されるかを確認できます。Sealedはすべてのファイルを、保存する前にAES-256-GCMで暗号化します。
役立たないこと: 動作は証明しません。この文書が説明するのは形式です。アプリがファイルを平文で書くことが決してないこと、アプリの中のほかの何かがデータを漏らさないことは、示せません。それらの主張には、ソースか監査が必要で、どちらもまだ公開されていません。Sealedは、独立したセキュリティ監査を受けていません。
間違いや、仕様書が封印されていると述べているものを読み取る方法を見つけたら、報告してください。
出典
このページの Sealed についての記述は、 にアプリで確認しました。
- Apple Developer Documentation, AES.GCM — 仕様書が、AppleのCryptoKitを通じて土台にしている暗号。
- NIST SP 800-38D, Galois/Counter Mode — GCMを定義している標準。
- RFC 8018, PKCS — 共有項目のパスフレーズから鍵を作るPBKDF2。
- Crockford, Base 32 — リカバリーキーの表記に使われる文字セット。
Sealed を入手
Sealedはダウンロード無料で、Sealed Proはアプリ内課金による任意のプランです。