私たちが開発している iOS 向けの求人アプリでは、データ層を Kotlin Multiplatform(KMP)で書き、端末のデータベースには Room を使っています。ログインしていない利用者が入力した個人情報を、端末にだけ保存する場面もあります。バックアップが持ち出されたときにもその情報を守るため、個人情報にあたる項目を CryptoKit で暗号化しました。
CryptoKit でできること
CryptoKit は iOS 13 で導入された暗号のフレームワークです。
Swift では AES.GCM や ChaChaPoly を使って、共通鍵でデータを暗号化できます。
今回使ったのは AES.GCM です[2]。暗号化すると、暗号文と一緒に改ざんを検知するための認証タグができます。復号時に鍵が違ったり暗号文が壊れていたりすると、認証に失敗して例外が返ります。
import CryptoKit
import Foundation
let key = SymmetricKey(size: .bits256)
let sealedBox = try AES.GCM.seal(Data("山田太郎".utf8), using: key)
let stored = sealedBox.combined! // 既定の nonce + 暗号文 + 認証タグ
let box = try AES.GCM.SealedBox(combined: stored)
let opened = try AES.GCM.open(box, using: key)
nonce は、同じ鍵で暗号化するたびに異なる値を使う必要があります。同じ値を再利用すると平文同士の関係が漏れ、改ざん検知も損なわれます。引数を省略すれば seal が毎回ランダムに生成するので、アプリで採番・管理する必要はありません。
実装では、端末ごとに作った AES 鍵をキーチェーンに保存します[3]。CryptoKit の SecureEnclave には、AES 鍵をそのまま保存する API はありません。
個人情報だけを暗号化した
私たちのプロジェクトではまず、端末に保存していた値を見直すところから始めました。サーバーから受け取る値の中には、URL を知っているだけで本人の情報を開けるものや、アプリでは表示にも処理にも使わない値がありました。必要になれば次の通信で取り直せる値は、保存するのをやめました。
端末に残す値のうち、氏名とふりがな、生年月日、連絡先、住所、学校名などは暗号化しました。自己 PR 欄も、氏名や連絡先が書かれる可能性があるため、暗号化の対象にしました。
暗号化する前に、その項目が検索や並べ替えに使われていないかも確認しました。ランダムな nonce を使うと、同じ氏名を同じ鍵で暗号化しても、保存されるバイト列は毎回変わります。検索したい氏名をもう一度暗号化して WHERE name = ? に渡しても一致しません。クエリは普通に通るので、エラーも出ずに「該当なし」になります。
私たちは、都道府県や職種の区分など、検索や並べ替えに使う項目のうち、ほかの保存項目と合わせても個人を絞り込みにくいと判断したものを平文で残しました。
ファイルごと暗号化するか、項目を選ぶか
Room の保存先は SQLite です。個人情報を含むデータベースを守る方法として、暗号化に対応した SQLite である SQLCipher を組み込む方法と、Room に渡す前にアプリで値を暗号化する方法を検討しました。
| ファイルごと暗号化 | 項目を選んで暗号化 | |
|---|---|---|
| 守る範囲 | DB 本体のデータとインデックス | 選んだ項目の値 |
| 検索・並べ替え | DB を開けば従来どおり | 暗号化した値を従来の条件で検索・整列できない |
| 実装する場所 | 主に DB を開く処理 | 対象項目を読み書きする処理 |
| 追加するもの | SQLCipher など | iOS 側は OS 標準の CryptoKit |
| 鍵を失ったとき | DB ごと開けなくなる | 暗号化した項目だけ読めなくなる |
ファイルごと暗号化する方法には、項目を追加しても個別の暗号化処理を書き忘れずに済む利点があります。Android の Room では openHelperFactory を使う構成がありますが、KMP の iOS 側では、Room が実際にどの SQLite ドライバでファイルを開くかまで確認する必要があります。
たとえば BundledSQLiteDriver は SQLite をアプリに組み込みます。SQLCipher もリンクしたからといって、Room の接続が SQLCipher を使うとは限りません。通常の SQLite は知らない PRAGMA をエラーにせず無視します[4]。その接続に PRAGMA key を渡しても、平文の DB が作られ、読み書きは普通に成功します[5]。
検証するときは、アプリの保存処理を一度通し、実際にできたファイルを確認します。通常の SQLite ファイルの先頭は次の16バイトです。
$ head -c 16 app.db | xxd
00000000: 5351 4c69 7465 2066 6f72 6d61 7420 3300 SQLite format 3.
SQLCipher の既定設定を想定しているのにこの文字列が見えたら、ドライバの構成を見直す手がかりになります。先頭の見た目だけで判定せず、正しい鍵でテーブルを読めることと、鍵なし・誤った鍵では読めないことを対にして確かめます。今回のように項目だけを暗号化した場合は、SQLite のヘッダーが見えるのが正常です。
Room 以外では、ストアによって指定できる設定が異なります。
| 保存の仕組み | ストア側で指定できること | 項目を選んで暗号化する場合 |
|---|---|---|
| CoreData |
NSPersistentStoreFileProtectionKey でファイルの保護クラスを指定できる |
暗号化した Data を属性に持たせる |
| SwiftData | ファイルの保護と、アプリ独自の鍵による暗号化を分けて考える | 保存する Data と、復号して利用する値を分ける |
| Realm | 設定に64バイトの鍵を渡すと、ファイルごと暗号化できる | 暗号化した Data をプロパティに持たせる |
CoreData の NSSQLitePragmasOption で OS 標準の SQLite に PRAGMA key を渡しても、SQLCipher の代わりにはなりません。また、項目単位で暗号化する限り、平文を条件に検索できなくなる制約は、NSPredicate でも SwiftData の #Predicate でも同じです。
機種変更でバックアップを復元するとき
バックアップから DB と復号鍵の両方を取り出せれば、暗号化した項目も読めます。キーチェーンの設定によって、新しい端末で鍵を使える条件が変わります。
| 鍵の置き方 | バックアップから新しい端末へ復元したとき |
|---|---|
ThisDeviceOnly を付ける |
元の端末に結び付くため、復元先でその鍵を使えない |
| 移行可能な属性を使い、同期はしない | パスワード付きのローカルバックアップから移行できる。暗号化なしのローカルバックアップでは移行できない |
kSecAttrSynchronizable を使う |
iCloud キーチェーンの同期が有効で、復元先でも同期の条件を満たせば鍵を利用できる |
iCloud バックアップと iCloud キーチェーンは別の仕組みです。Apple の説明では、iCloud バックアップに含まれるローカルキーチェーンは、元の端末にひも付いた鍵で保護されます[6]。クイックスタートによる端末間の直接移行は未検証です。
暗号化したローカルバックアップで鍵も移る設定だと、バックアップとパスワードを手に入れた人にも DB と鍵が渡ります。
ログインせずに入力して端末にだけ保存した情報は、サーバーから取り直せません。今回は入力し直せば使い続けられる項目だったので、機種変更後は再入力してもらうことにしました。
利用者からは、これまで引き継げていた入力内容が消えたように見えます。プロダクトオーナーや企画の担当者と相談するときは、機種変更後にどの画面で何を入力し直すのかまで具体的に伝えると、判断してもらいやすくなります。再入力をお願いできない情報なら、サーバーに預ける導線も含めて検討する必要があります。
実装するときの注意点
鍵が「無い」のと「今は読めない」のとを分ける
鍵は端末ごとに SymmetricKey(size: .bits256) で作り、キーチェーンに保存します。全利用者で同じ鍵をアプリに埋め込んでしまうと、配布したバイナリから取り出された鍵で、ほかの端末のデータまで復号できてしまいます。
キーチェーンに保存した鍵は、端末の状態と鍵の保護クラスによって、一時的に読めないことがあります。たとえば再起動してまだ一度もロックを解除していないとき、アプリのプロセスが起動したことだけでは、鍵を読めるとは判断できません。
ここで「取得に失敗したら新しい鍵を作る」と書くと、元の鍵で暗号化したデータを読めなくするおそれがあります。検索結果は少なくとも次のように分けます。
switch SecItemCopyMatching(query as CFDictionary, &item) {
case errSecSuccess:
guard let data = item as? Data, data.count == 32 else {
return .unavailable
}
return .found(SymmetricKey(data: data))
case errSecItemNotFound:
return .notFound
default:
return .unavailable
}
この例は256ビット鍵を保存し、クエリでデータを要求する前提です。errSecInteractionNotAllowed などは「今は取得できない」として扱います。.notFound の場合も、初回起動と、機種変更で暗号文だけ戻った場合とでは、次に必要な処理が違います。新しい鍵を作っても、既存の暗号文が読めるようにはなりません。
鍵を読めないときの保存処理
鍵が読めず暗号化できなかったら、その保存を中断して後でやり直します。平文での保存に切り替えると、保護するはずの値が DB に残ります。旧版の平文も読めるようにしているアプリでは、次に読み出しても成功するため、気づきにくい不具合です。
復号に失敗した値を空文字で画面に返すと、「未入力」として扱われることがあります。その状態で利用者が別の欄を編集し、フォーム全体を保存すると、元の暗号文まで空の値で上書きされます。一時的に鍵が読めない間は、保存済みの値をそのまま残します。
リリース済みのアプリに足すとき
すでにリリースしたアプリには、旧版が平文で保存したデータがあります。新旧を見分けられるようにすれば、旧形式の値を読み出したときに暗号化し直せます。形式にバージョン番号を持たせておくと、将来方式を変えるときにも使えます。ただし、読み出されない行には平文が残ります。いつまでに既存データを保護したいかによっては、一括での移行も必要です。
整数や日付の列に暗号文を保存するなら、バイト列や文字列を保存できる型へのマイグレーションも要ります。さらに、WHERE token = ? のように、対象の値で更新する行を探していた処理も見直します。候補を読み出して復号・比較してから書き換える場合は、その間に別の保存が割り込まないよう、一連の処理をトランザクションにまとめます。
テストで確かめる範囲
ホストアプリを持たない Swift Package のテストでは、キーチェーンへのアクセスが errSecMissingEntitlement で失敗することがあります。暗号化と復号のテストでは外から鍵を渡し、同じ鍵なら元の値を読めること、別の鍵や壊れた暗号文なら失敗することを確かめられるようにします。キーチェーンと組み合わせたときの挙動や、実際の保存ファイルに対象の平文が残っていないかは、実機で確認します。
実際に起きている攻撃
今回想定したのは、バックアップからの情報の抜き取りです。2015年には Palo Alto Networks が、PC に感染したマルウェアが、そこに保存されていた iPhone のバックアップを持ち出す手口を報告しています[7]。暗号化されていないバックアップなら、iPhone を脱獄させる必要もありません。2026年には、偽の Apple サインイン画面を使い、記者や活動家の iCloud バックアップを狙った事例も報じられました[8]。
一方、端末そのものを乗っ取る攻撃もあります。Google が2026年3月に公表した Coruna と DarkSword は、細工された Web ページを入り口に iPhone を侵害するものです。Coruna ではウォレットアプリ内の情報を収集する挙動が報告されています[9]。DarkSword では、メッセージや連絡先、キーチェーンなども収集の対象でした[10]。
アプリで暗号化して何が守れるか
iOS では、アプリが何もしなくてもファイルは Data Protection で暗号化されています。ファイルごとに鍵があり、いつその鍵を使えるかは保護クラスで決まります。
| 保護クラス | 読み書きできるタイミング |
|---|---|
complete |
ロック解除中。ロック後まもなく保護されたファイルにアクセスできなくなる |
completeUnlessOpen |
ロック前に開いたファイルは引き続き使え、ロック中に新規ファイルも作れる。閉じた既存ファイルを開き直すには解除が必要 |
completeUntilFirstUserAuthentication |
再起動後、一度ロックを解除すれば次の再起動まで使える。通常のアプリデータの既定 |
none |
ロック解除の状態にかかわらず使える |
ロック中の読み出しを防ぎたい場合は、ファイルの保護クラスを complete に上げる選択肢があります。ファイル属性やアプリのエンタイトルメントで指定でき、独自の暗号化処理は要りません。その代わり、バックグラウンド同期や通知を受けたときの保存など、ロック中にもそのファイルが必要な処理に影響します。
パスワードを設定していないローカルバックアップには、端末上のファイルの保護クラスにかかわらず、アプリのファイルが暗号化されずに保存されます。iCloud バックアップ自体は暗号化されますが、標準のデータ保護と「高度なデータ保護」では復旧用の鍵を誰が持つかが異なります。
| 想定する状況 | 今回の設計で守れる範囲 |
|---|---|
| バックアップから DB を取得される | 元の端末の鍵が使えなければ、暗号化した項目は読めない |
| 端末の盗難・紛失 | まず OS の保護クラスが効く。再起動後の最初の解除前と、一度解除した後とで条件が変わる |
| ロック解除後の端末の解析・乗っ取り | 鍵や復号後の値まで取得される場合は守れない |
| アプリのバイナリの解析 | バイナリだけを入手しても、端末ごとに生成した鍵は得られない |
| 保存データの書き換え | 暗号文自体の改変は認証タグで検知できる。正しい暗号文同士の入れ替えには追加の対策が要る |
同じ鍵を使っていれば、A さんの行から B さんの行に暗号文と認証タグをコピーしても、復号は成功します。AES.GCM.seal(_:using:authenticating:) に行の ID や項目名を追加の認証データとして渡し、復号時にも読み出し先の行・項目から同じ値を組み立てれば、別の場所に移された暗号文を検知できます。
暗号化の外に残るもの
DB に保存する値を暗号化しても、保存前の値をログに出せば、個人情報はそこに残ります。例外のメッセージを収集するクラッシュレポート、アプリ切り替え時の画面スナップショット、DB とは別に保存する写真も、それぞれ確認が必要です。
暗号文の長さから、元の値のバイト数が分かります。空欄を暗号化せずに保存していれば、どの欄が未入力かも分かります。
まとめ
Room に残すデータを見直し、必要なときに取り直せる値は保存をやめました。氏名や連絡先、自己 PR などは CryptoKit で暗号化し、都道府県や職種の区分は検索に使うため平文で残しました。
鍵を元の端末に残すと、バックアップに DB があっても暗号化した項目は読めません。そのため、機種変更後に何を入力し直してもらうかも、暗号化の対象とあわせて決めました。