データの扱いと暗号化のしくみ

入力したデータがどう扱われるかを、使う人は知ることができるべきだと考えています。そして CarKeep の安全は、しくみを隠すことではなく、鍵があなたの Passkey の中にしかないことで成り立っています。しくみが知られても、鍵がなければ記録は読めません。

Web 版の画面のプログラムは、もともとブラウザにそのまま届いているので、調べようと思えば誰でも中身を読めます。このページは、それを読まなくても分かるように書いたものです。

一方で、ソースコードは今のところ公開していません。このページは運営者による説明で、第三者が確かめたものではありません。自分で確かめられる範囲は「確かめる方法」に書きました。

このページに書かないのは、招待や登録の具体的な手順と、サービスの運用（管理の作業をどこでどう行うか）の詳細です。これらは記録の安全には関係せず、書くと攻撃の手がかりになるためです。

記録は、あなたの端末（ブラウザまたは iPhone アプリ）の中で暗号化してから送ります。サーバーは暗号文を預かって端末どうしで受け渡すだけで、中身を読むことも、並べ替えや燃費の計算をすることもありません。それらはすべて端末が復号してから行います。

サーバーは Cloudflare の上で動いています。通信は HTTPS で暗号化され、Cloudflare で一度ほどかれますが、その中身の記録はさらに端末で暗号化されているので、Cloudflare からも読めません（配信するプログラムを書き換えられた場合は別です。「この暗号化で守れないこと」を参照）。

iPhone アプリをアカウントなし（「このiPhoneだけで使う」）で使う場合は、記録をどこにも送りません。このページの以下の内容は、アカウントで使う場合の話です。

記録を暗号化する鍵（データ鍵）は、アカウントごとに 1 つ、最初に記録を開いた端末が乱数で作ります。データ鍵は、Passkey から作った別の鍵で包んで（暗号化して）からサーバーに預けます。Passkey がなければ包みを開けないので、サーバーにある包まれたデータ鍵だけでは何もできません。

• Passkey の PRF という機能で、Passkey ごとに決まった秘密の値を端末の中で取り出し、そこから鍵を作ります。ログインの署名に使う秘密鍵とは別のもので、署名用の秘密鍵は CarKeep にも取り出せません。この値と、そこから作った鍵は端末の外に出しません。サーバーは、この値を含んだログインの応答を受け取ると拒否します。
• PRF に対応していない Passkey でもログインはできますが、鍵を作れないので記録は開けません。その場合は画面でお知らせします。
• Passkey を追加するときは、今の Passkey でデータ鍵を開き、新しい Passkey の鍵で包み直して預けます。データ鍵そのものは変わらないので、どの Passkey でも同じ記録を開けます。
• 暗号文には、どのアカウントの、どの記録のものかを結び付けてあります（AES-GCM の追加認証データ）。サーバーが暗号文を別の記録や別の人のものと入れ替えても、復号の段階で失敗します。
• 中身は、決まった大きさ（256 byte）単位で空白を足してから暗号化します。暗号文の大きさから、給油か整備かといった記録の種類は分かりません。
• 暗号の処理は自作せず、Web はブラウザ標準の WebCrypto、iPhone は Apple の CryptoKit を使っています。Web と iPhone が同じ入力から同じ暗号文を作ることを、共通のテストデータで確かめています。
• Passkey をすべてなくすと、データ鍵を開ける手段がなくなり、運営者にも記録を戻せません。戻せる裏口を作っていないためです。Passkey は 2 つ以上登録しておくと安心です。

一度開くと、データ鍵はその端末に保存されるので、次からは Passkey の確認なしで開けます（Web は取り出せない形でブラウザに、iPhone はその端末だけのキーチェーンに保存）。ログアウトすると消去します。

データベースにあるのは次の情報だけです。データベースがすべて外に漏れても、ここから記録を読むことも、あなたになりすましてログインすることもできません。CarKeep が付ける ID（アカウント、Passkey の登録、記録）は UUIDv7 という形式で、作った日時をミリ秒単位で含みます。

アカウント

ID、利用者か管理者か、最後に使った日（日付のみ。6 か月で削除するため）

Passkey

登録の ID、公開鍵、Passkey そのものの ID（認証器が作るもの）、使用回数のカウンター、包んだデータ鍵、Passkey の名前（暗号化済み）

ログイン状態

ログイン用の値のハッシュ（値そのものは持たない）、Web か iPhone か、有効期限、最後に本人確認した時刻

記録

記録の ID（端末が作る）、変更の通し番号（他の端末が、前回より後の変更だけを受け取るため）、アカウント ID、暗号文

一時的な情報

ログインの途中の確認用の値や招待の受け付けに使う値のハッシュ。期限が来れば毎日消去

暗号化されて、サーバーに分からないもの：車の名前、記録の種類、日付、走行距離、給油量、金額、製品名、タイヤ溝、どの記録がどの車のものか、Passkey の名前。

暗号化しても、サーバーに分かってしまうもの：記録の件数と、それぞれのおおよその大きさ（256 byte 単位）、アカウントを作った日時、Passkey を登録した日時、それぞれの記録を作った日時（ID に含まれます。給油日など入力した日付とは別です）、記録を保存・更新・削除した順番と時期、一度にまとめて送った記録のまとまり、Passkey の数、Web と iPhone のどちらでログインしているか。

サーバーのログには、リクエストの種類と場所（URL のパス部分）、結果、かかった時間、エラーの種類だけを書きます。送られてきた中身、ログイン用の値、URL のクエリは書きません。CarKeep として IP アドレスは保存しませんが、通信を中継する Cloudflare は通信のために IP アドレスを扱います。

ただし「できないこと」は、次の「守れないこと」にある方法を運営者が取らない限りの話です。

暗号化は万能ではありません。次の場合は、記録を読まれる可能性があります。

• 記録を削除すると、暗号文を消します。他の端末に削除を伝えるため、記録の ID、変更の通し番号、アカウント ID だけが残ります。
• 車を削除すると、その車の記録もまとめて削除します。
• アカウントを削除すると、Passkey、ログイン状態、記録をすべて消し、何も残しません。
• 6 か月間使われていない（ログインも、ログインした状態での閲覧もない）アカウントは、毎日の自動処理で同じように削除します。
• 消したデータは、データベースの障害に備えた復元用の履歴に、しばらくの間（暗号文のまま）残ることがあります。

ソースコードは公開していませんが、パソコンのブラウザがあれば、送られている中身は確かめられます。

1. パソコンの Chrome や Safari で CarKeep にログインし、開発者ツールの「ネットワーク」を開きます。
2. 記録を保存すると、/api/v1/records への送信が表示されます。その中身の ciphertext が、入力した内容とは似ても似つかない英数字の並びになっていることが分かります。
3. ページの応答ヘッダーの Content-Security-Policy で、CarKeep 以外から来たスクリプトを実行しないこと、画面からの通信の宛先を CarKeep 自身に限っていることも確かめられます（配信元でのプログラムの差し替えまでは防げません）。