暗号化

Capgoは、配布されるアプリケーションパッケージに強力なエンドツーヘンド暗号化を提供し、JavaScript codeやアセットが送信および保存される際に保護されます。この暗号化システムは、ライブ更新の便利さを維持しながら、完全な制御を提供するように設計されています。

概要

Capgo’s encryption system uses industry-standard cryptographic methods to protect your bundles from unauthorized access. When encryption is enabled, your bundles are encrypted before leaving your development environment and remain encrypted until they’re decrypted by your app on the user’s device.

: OTAシステムが更新のみ署名するのと異なり、__CAPGO_KEEP_0__はアップロードされたパッケージを暗号化し、保存および配信する前に暗号化します。これにより、保存または転送中のパッケージの内容が一般的なアクセスから保護され、有効な暗号化された更新を生成するには、プライベートキーが必要になります。: Unlike OTA systems that only sign updates, Capgo encrypts the uploaded bundle before storage and delivery. This protects the bundle contents from casual access in storage or transit and ensures only someone with your private key can produce a valid encrypted update. It does 暗号化の必要性 Overview

When You Need Encryption

アップロードしたバンドルが暗号化されていない場合、パブリック アセットとして扱います。

暗号化は、保管中および転送中の保護を強化したい場合や、プライベート キーを持つ者だけが有効な暗号化された更新を公開できるようにしたい場合に便利です。

Capgo encryption protects against bundle disclosure by Capgo, storage providers, CDNs, or anyone who only sees the encrypted delivery artifact. It also prevents third parties from generating valid encrypted updates without your private key. Because the public key is embedded in the distributed app so the client can decrypt updates, someone who has your app binary and enough motivation can still recover the key material needed to inspect the bundle.

Threat Model

Threat Model

• __CAPGO_KEEP_0__暗号化は、__CAPGO_KEEP_1__、ストレージ プロバイダー、CDN、または暗号化された配信アーティファクトのみを参照できる者によってアップロードされたバンドルを漏洩させないように保護します。
• Enterprise applications with compliance requirements
• Tip
• Tip

暗号化は特に重要です。

Capgoは、RSAとAESの暗号化を組み合わせたハイブリッド暗号化アプローチを使用して、最適なセキュリティとパフォーマンスを実現します。

1. キー生成

• プライベートキー: 開発環境で安全に生成および保存され、暗号化に使用されます。
• パブリックキー: プライベートキーから派生され、Capacitorアプリの設定で保存され、復号化に使用されます。
• セッションキー: 各アップロード用にランダムに生成されるAESキー

2.暗号化プロセス

1. ランダムなAESセッションキーが各バンドルアップロード用に生成されます
2. バンドルはAESセッションキーで暗号化されます
3. バンドルのチェックサムが計算されます
4. 両方のAESセッションキーとチェックサムは、RSA秘密鍵（署名を作成する）で暗号化されます
5. 暗号化されたバンドルと署名が保存されます

チェックサムはAESキーと共に暗号化され、改ざんを防止します。RSA秘密鍵のみで署名を作成でき、対応する公開鍵のみで復号化できるため、AESセッションキーと予想されるチェックサムが本物であり、攻撃者によって改ざんされていないことを保証します。

3. Decryption Process

1. アプリは暗号化されたバンドルと署名をダウンロードします
2. Capgo SDKは、RSA公開鍵（アプリ内に保存されている）を使用して署名を復号化します
3. これにより、AESセッションキーと元のチェックサムが明らかになります
4. AES セッション キーは、バンドルを復号するために使用されます。
5. 復号したバンドルのチェックサムが計算され、元のチェックサムと比較され、整合性の検証が行われます。

このプロセスにより、攻撃者が暗号化されたバンドルをキャッチしたとしても、AES セッション キーを変更したり、偽のチェックサムを提供したりすることはできません。なぜなら、有効な署名を作成するには、プライベート キーが必要だからです。ただし、パブリック キーは署名を復号できます。

ヒント

RSA は大量のデータを効率的に暗号化できません。したがって、実際のバンドル暗号化に AES が使用され、RSA は AES キーを保護し、チェックサム署名を通じて整合性の検証を提供します。

Capgo vs Other Platforms

機能	Capgo	他のOTAプラットフォーム
バンドルコンテンツ	ストレージ/トランジットで暗号化されている; しかし、特定のリバースエンジニアによってアプリバイナリを検査することは可能	パブリックに読み取れる
セキュリティーメソッド	完全にエンドツーエンドの暗号化	Code署名のみ
プライバシー レベル	プラットフォームが__CAPGO_KEEP_0__にアクセスできる	Platform can access your code
コンテンツ + 完全性 + 認証性	完全性 + 認証性のみ	なぜこれが重要なのか:

ストレージ/トランジットで暗号化されている; しかし、特定のリバースエンジニアによってアプリバイナリを検査することは可能

• Code署名 更新が改ざんされていないか、正しい元のソースから来たかだけを確認する
• Capgo暗号化 配布中のバンドルを保護し、偽造された暗号化された更新を困難にし、攻撃者がプライベートキーを取得する必要があるため、偽造された暗号化された更新を困難にします。
• アプリが配信された後、クライアントには更新を復号化およびロードするために必要な公開鍵が含まれているため、逆アセンブルはまだ可能です。 暗号化方法

「暗号化方法」のセクション

Capgo uses Encryption V2 as the standard encryption method:

「暗号化方法V2 (現在の標準)」のセクション

• Encryption Methods
• AES-256-GCMによる認証付き暗号化
• 整合性検証を提供
• パフォーマンスとセキュリティの向上

Encryption V1 (廃止)

• RSA-2048を使用して鍵の暗号化
• AES-256-CBCによるバンドル暗号化
• CLIで現在利用できない
• __CAPGO_KEEP_0__で現在利用できない

危険

Encryption V1 is no longer supported in the current Capgo CLI. If you’re using V1 encryption, you must migrate to V2. See the targetLanguage":"Japanese", protectedTokens":["Cloudflare","Capacitor","GitHub","Capgo","code","API","SDK","CLI","npm","bun"]

texts":["migration guide","for detailed instructions.","暗号化設定","Section titled “Setting Up Encryption”","暗号化キー生成の手順1","Section titled “Step 1: Generate Encryption Keys”","まず、__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ を使用して暗号化キーを生成します。","ターミナル画面","コピー","これにより、","：秘密鍵（この情報を安全に保管してください。）","：公開鍵（アプリで使用）"]

translations":["migration guide","for detailed instructions.","暗号化設定","Section titled “Setting Up Encryption”","暗号化キー生成の手順1","Section titled “Step 1: Generate Encryption Keys”","まず、__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ を使用して暗号化キーを生成します。","ターミナル画面","コピー","これにより、","：秘密鍵（この情報を安全に保管してください。）","：公開鍵（アプリで使用）"]}】

translations":["migration guide","for detailed instructions.","暗号化設定","Section titled “Setting Up Encryption”","暗号化キー生成の手順1","Section titled “Step 1: Generate Encryption Keys”","まず、Capgo CLI を使用して暗号化キーを生成します。","ターミナル画面","コピー","これにより、","：秘密鍵（この情報を安全に保管してください。）","：公開鍵（アプリで使用）"]}】

# Generate new encryption keys (creates files in current directory)
npx @capgo/cli@latest key create

translations":["migration guide","for detailed instructions.","暗号化設定","Section titled “Setting Up Encryption”","暗号化キー生成の手順1","Section titled “Step 1: Generate Encryption Keys”","まず、__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ を使用して暗号化キーを生成します。","ターミナル画面","コピー","これにより、","：秘密鍵（この情報を安全に保管してください。）","：公開鍵（アプリで使用）"]}】

• .capgo_key_v2translations":["migration guide","for detailed instructions.","暗号化設定","Section titled “Setting Up Encryption”","暗号化キー生成の手順1","Section titled “Step 1: Generate Encryption Keys”","まず、__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ を使用して暗号化キーを生成します。","ターミナル画面","コピー","これにより、","：秘密鍵（この情報を安全に保管してください。）","：公開鍵（アプリで使用）"]}】
• .capgo_key_v2.pubtranslations":["migration guide","for detailed instructions.","暗号化設定","Section titled “Setting Up Encryption”","暗号化キー生成の手順1","Section titled “Step 1: Generate Encryption Keys”","まず、__CAPGO_KEEP_0__ __CAPGO_KEEP_1__ を使用して暗号化キーを生成します。","ターミナル画面","コピー","これにより、","：秘密鍵（この情報を安全に保管してください。）","：公開鍵（アプリで使用）"]}】

このコマンドを実行したディレクトリでファイルが作成されます。

注意

重要なストレージの注意事項:

• プライベート キー (.capgo_key_v2): これをバージョン管理にコミットしないでください。このファイルは安全に保管し、バンドルアップロードの際にのみ暗号化に使用してください。
• パブリック キー (.capgo_key_v2.pub): これをバージョン管理にコミットすることができます。これはあなたのパブリック キーのバックアップです。
• ファイルの場所: コマンドを実行したディレクトリでキーアイテムが作成されます。 key create コンフィグ内に含まれるパブリック キー
• command: key save to store the public key in your Capacitor config for the mobile app to use.

モバイルアプリがキーを使用できるようにするには、__CAPGO_KEEP_0__ 設定にパブリック キーを保存する必要があります。

Step 2: Save Your Public Key to Capacitor Config (Required)

「ステップ 2: __CAPGO_KEEP_0__ 設定にパブリック キーを保存する (必須)」というセクション あなた save your public key to the Capacitor config so your mobile app can decrypt bundles:

# Save public key from file to Capacitor config (required)
npx @capgo/cli@latest key save --key ./.capgo_key_v2.pub

# Or save public key data directly
npx @capgo/cli@latest key save --key-data "$CAPGO_PUBLIC_KEY"

Step 3: Sync Capacitor Platform (Required)

After saving the public key, you must Capacitorプラットフォームを同期する必要があります。

# Sync the platform to copy config to native
npx cap sync

注意

必要な手順:

1. この key save コマンドは、Capacitorの設定ファイルにパブリックキーを保存し、ネイティブ層にこの設定をコピーします。
2. npx cap sync この設定をコピーすることで、モバイルアプリは更新を暗号化できます。
3. 両方のステップを実行しないと、アプリは暗号化された更新を復号できません。

暗号化されたバンドル

アップロード中に暗号化する方法

アップロードプロセス中に暗号化する最も簡単な方法は次のとおりです。

# Upload with automatic encryption
npx @capgo/cli@latest bundle upload --key-v2

# For external storage, you must encrypt first (see Manual Encryption Workflow below)

手動暗号化フロー

より多くの制御が必要な場合は、バンドルを手動で暗号化できます。

1. zipバンドルを作成する

   npx @capgo/cli@latest bundle zip com.example.app --path ./dist --key-v2

2. 暗号化する:

   npx @capgo/cli@latest bundle encrypt ./com.example.app.zip CHECKSUM_FROM_STEP_1

3. Capgoにアップロードして登録する (例: S3)

   # First upload the encrypted bundle to your storage (e.g., AWS S3)
   aws s3 cp ./encrypted-bundle.zip s3://your-bucket/encrypted-bundle.zip
   
   # Then register with Capgo using the external URL
   npx @capgo/cli@latest bundle upload --external https://your-storage.com/encrypted-bundle.zip --iv-session-key IV_SESSION_KEY_FROM_STEP_2

鍵管理

鍵の安全な保存

秘密鍵のオプション:

1. ファイルベース (ローカル開発):

   # Key stored as .capgo_key_v2 file in project root
   npx @capgo/cli@latest bundle upload --key-v2

2. 環境変数 (CI/CD):

   # Store in environment variable for CI
   export CAPGO_PRIVATE_KEY="$(cat .capgo_key_v2)"
   npx @capgo/cli@latest bundle upload --key-data-v2 "$CAPGO_PRIVATE_KEY"

公開鍵セットアップ (必須):

# Must save public key to Capacitor config for mobile app
npx @capgo/cli@latest key save --key ./.capgo_key_v2.pub

本番環境:

• AWS KMS、Azure Key Vault などを含む安全な鍵管理サービスでプライベート鍵を保存
• CI/CD のシークレット管理を使用してプライベート鍵を管理
• バージョン管理にプライベート キーをコミットしないでください

Key Usage:

• プライベート キー: CLI がバンドル アップロード中に暗号化に使用します (安全に保管してください)
• パブリック キー: デバイス上で復号化するためにアプリの構成に保存します (コミットすることが安全です)

Key Rotation

セキュリティを向上させるために、定期的に暗号化キーのローテーションを実行してください:

1. 新しいキーを生成:

   # Navigate to desired directory first, then create keys
   mkdir ./new-keys && cd ./new-keys
   npx @capgo/cli@latest key create

2. 新しい公開鍵をCapacitor設定に保存してください:

   npx @capgo/cli@latest key save --key ./new-keys/.capgo_key_v2.pub

3. 新しい公開鍵でアプリケーション設定を更新してください 新しい公開鍵とともに

4. アップロードする暗号化されたバンドルに新しい鍵を使用する前に、アプリケーションを更新してください セキュリティのベストプラクティス

セクション「セキュリティのベストプラクティス」

セクション「鍵のセキュリティ」

• セキュリティのベストプラクティス 環境やチームメンバー間で
• 異なるキーを使用する 異なる環境 (開発、ステージング、生産) に対して
• 定期的にキーをローテートする (推奨: 6-12 か月ごと)
• セキュアにキーを保存する 適切なキー管理システムを使用する

Bundle Security

• 常に 暗号化解除後、バンドルの完整性を検証する
• 監視する __CAPGO_KEEP_0__
• HTTPSを使用する __CAPGO_KEEP_1__ (モバイルアプリ用必須)
• 実装 暗号化失敗時の適切なエラーハンドリング

アクセス制御

• 暗号化キーへのアクセス 承認された従業員のみに
• ロールベースのアクセス 暗号化キー管理オペレーション
• 監査 キー使用とアクセスを定期的に行ってください
• Implement 適切なバックアップと復旧手順を実施してください

トラブルシューティング:暗号化

一般的な問題

復号エラー:

• 暗号化に使用した公開鍵と一致するプライベートキーを確認してください
• 暗号化に使用した ivSessionKey が正しいことを確認してください
• 暗号化 V2 (V1 はサポートされていません) を使用していることを確認してください

Key-related errors:

• 秘密鍵のフォーマットが正しいことを確認してください (PEM形式)
• 保存/転送中の鍵が損傷していないことを確認してください
• アプリの設定で鍵が適切な権限を持っていることを確認してください

Performance issues:

• 大きなバンドルは暗号化/復号化に長い時間かかる可能性があります
• Delta (マニフェスト) アップデートを使用してバンドルのサイズを削減することを検討してください
• デバイスのパフォーマンスを復号化中に監視してください

Debug Commands

暗号化の状態を確認してください:

npx @capgo/cli@latest app debug

暗号化/復号ワークフローをテスト:

# Test the complete workflow: zip → encrypt → decrypt → unzip
npx @capgo/cli@latest bundle zip com.example.app --key-v2
npx @capgo/cli@latest bundle encrypt ./com.example.app.zip CHECKSUM --json
npx @capgo/cli@latest bundle decrypt ./encrypted-bundle.zip IV_SESSION_KEY

規制と基準

Capgoの暗号化実装は、業界標準に従っています:

• AES-256: FIPS 140-2で承認された暗号化アルゴリズム
• RSA-4096: 強力な非対称暗号化を使用して鍵を保護する
• GCM モード: と を両方とも保証します。
• ランダムなセキュリティ数値: 強度の高い暗号化を使用したランダムな数字の生成

この機能により、Capgo は以下の要件に適合するアプリケーション向けに適しています。

• データ保護規制総則（General Data Protection Regulation）
• HIPAA (健康保険 portability と accountability Act)
• サービス機関制御2 (SOC 2)
• ISO 27001 (情報セキュリティマネジメントシステム規格)

パフォーマンスの考慮事項

暗号化オーバーヘッド

• Bundle size: __CAPGO_KEEP_0__
• Processing time: __CAPGO_KEEP_0__
• Memory usage: __CAPGO_KEEP_0__

Optimization Tips

• Use Delta (manifest) updates to minimize encrypted data transfer
• Optimize your bundle size by converting images to WebP format
• Minimize JavaScript and CSS files before bundling
• Remove unused dependencies and code
• 古い/遅いデバイスでパフォーマンスを監視する

次のステップ

• 学習する カスタムストレージ 自分のインフラストラクチャで暗号化を使用するには
• 探索 チャンネル 環境間で暗号化されたバンドルを管理するには
• セットアップ CI/CD統合 暗号化されたデプロイを自動化するには

暗号化から続けて

暗号化を使用して 暗号化 セキュリティとコンプライアンスの計画に使用する場合、 コンプライアンス コンプライアンスの実装詳細 Capgo セキュリティ スキャナー Capgo セキュリティ スキャナーの製品ワークフロー Capgo セキュリティ Capgo セキュリティの製品ワークフロー Capgo トラスト センター 製品ワークフローについては、Capgo Trust Centerで確認してください。 組織セキュリティ 製品実装詳細については、組織セキュリティを参照してください。