メインコンテンツへスキップ

カスタムストレージ

Capgo はアプリの bundle 向けのカスタムストレージソリューションに対応しており、独自のインフラやサードパーティのストレージサービスでアップデートをホストできます。これは、特定のセキュリティ要件やコンプライアンス、既存のストレージインフラを持つ組織にとって特に有用です。

Capgo のカスタムストレージは、bundle を外部の場所にアップロードし、アクセス用の URL を Capgo に提供することで動作します。これにより、Capgo の SDK は、Capgo のデフォルトのクラウドストレージではなく、カスタムストレージの場所から直接アップデートをダウンロードします。

外部URLからのアップロード

「外部URLアップロード」セクション

カスタムストレージを利用する最も簡単な方法は、bundleを公開URLにアップロードし、そのURLをCapgoに渡すことです。

ターミナル
npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip

このコマンドにより、CapgoはbundleをCapgoのクラウドストレージにアップロードする代わりに、指定されたURLのbundleを参照します。

外部ストレージのセキュリティを高めるには、bundleを暗号化し、復号キーを指定できます。

ターミナル
npx @capgo/cli@latest bundle upload --external https://your-domain.com/bundles/v1.2.3.zip --iv-session-key YOUR_IV_SESSION_KEY

Capgo は、Amazon S3 および S3 互換ストレージサービスを標準でサポートしています。CLI は、bundle を S3 に自動アップロードし、Capgo が S3 URL を使用するように設定できます。

ターミナル
npx @capgo/cli@latest bundle upload \
--s3-region us-east-1 \
--s3-apikey YOUR_ACCESS_KEY \
--s3-apisecret YOUR_SECRET_KEY \
--s3-bucket-name your-bucket-name

S3互換サービスまたはカスタムエンドポイントを使用する場合:

ターミナル
npx @capgo/cli@latest bundle upload \
--s3-region us-east-1 \
--s3-apikey YOUR_ACCESS_KEY \
--s3-apisecret YOUR_SECRET_KEY \
--s3-endpoint https://s3.your-provider.com \
--s3-bucket-name your-bucket-name \
--s3-port 443 \
--no-s3-ssl # Only if your endpoint doesn't support SSL
パラメータ説明必須
--s3-regionS3バケットのAWSリージョンはい
--s3-apikeyS3 アクセスキー IDはい
--s3-apisecretS3 シークレットアクセスキーはい
--s3-bucket-nameS3 バケット名はい
--s3-endpointカスタム S3 エンドポイント URLいいえ
--s3-portS3 エンドポイントのポートいいえ
--no-s3-sslS3 アップロードの SSL を無効化いいえ

カスタムストレージを使う場合、特に暗号化を併用する場合は、Bundleを適切に準備する必要があります。これにはzipファイルの作成と、必要に応じた暗号化が含まれます。

まず、アプリのBundleをzipファイルにまとめます:

ターミナル
npx @capgo/cli@latest bundle zip com.example.app --path ./dist

zipコマンドを実行すると、zipファイルのチェックサムが返されます。必要に応じて、このチェックサムを使ってzipファイルを暗号化できます。チェックサムを含む構造化出力を取得するには、 --json オプションを使用してください。

ターミナル
npx @capgo/cli@latest bundle zip [appId] \
--path ./dist \
--bundle 1.2.3 \
--name myapp-v1.2.3 \
--json \
--no-code-check \
--key-v2 \
--package-json ../../package.json,./package.json
オプション説明
--pathzipするフォルダのパス (デフォルトは capacitor.config の webDir)
--bundlezipファイル名に使用するBundleのバージョン番号
--namezipファイルのカスタム名
--json結果をJSON形式で出力 (チェックサムを含む)
--no-code-checknotifyAppReady() の呼び出しとindexファイルのチェックをスキップ
--key-v2暗号化 v2 を使用
--package-jsonモノレポ用の package.json へのパス (カンマ区切り)

ステップ 2: Bundleの暗号化 (オプション)

セクション「ステップ 2: Bundle の暗号化(任意)」

セキュリティを強化するために、アップロード前に zip bundle を暗号化します:

ターミナル
# Using default local key
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM
# Using custom key file
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM --key ./path/to/.capgo_key_v2
# Using key data directly
npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM --key-data "PRIVATE_KEY_CONTENT"

この CHECKSUM パラメータは必須で、zip ファイルのチェックサムを指定します。チェックサムは zip コマンドの出力から取得できます( --json オプションを構造化出力に使用)。

デフォルトでは、encrypt コマンドはローカルの秘密鍵を使用します。 --key または --key-data オプションも指定可能です。

encrypt コマンドは、アップロードまたは復号に必要となる ivSessionKey キーを返します。

オプション説明
zipPath暗号化する zip ファイルへのパス(必須)
checksumzip ファイルのチェックサム(必須)- zip コマンドから取得
--key秘密鍵の自定义パス(省略可、デフォルトではローカル鍵を使用)
--key-data秘密鍵データを直接指定(省略可)
--json結果を JSON 形式で出力
  1. アプリをビルド:

    ターミナル
    npm run build
  2. zip bundleを作成します:

    ターミナル
    npx @capgo/cli@latest bundle zip com.example.app --path ./dist --bundle 1.2.3

    このコマンドが返すチェックサムを記録してください。

  3. bundleを暗号化:

    ターミナル
    npx @capgo/cli@latest bundle encrypt ./com.example.app-1.2.3.zip CHECKSUM_FROM_STEP_2

    以下を控えてください: ivSessionKey 出力から。

  4. ストレージにアップロード: 暗号化された zip ファイルをホスティングサービスにアップロードします。

  5. Capgo に登録:

    ターミナル
    npx @capgo/cli@latest bundle upload \
    --external https://your-cdn.com/bundles/com.example.app-1.2.3.zip \
    --iv-session-key IV_SESSION_KEY_FROM_STEP_3
  1. アプリをビルド:

    ターミナル
    npm run build
  2. S3へ直接アップロード:

    ターミナル
    npx @capgo/cli@latest bundle upload \
    --s3-region us-west-2 \
    --s3-apikey YOUR_ACCESS_KEY \
    --s3-apisecret YOUR_SECRET_KEY \
    --s3-bucket-name your-app-bundles \
    --channel Production
  1. ビルドしてzip圧縮:

    ターミナル
    npm run build
    npx @capgo/cli@latest bundle zip com.example.app --path ./dist --key-v2
  2. bundleを暗号化:

    ターミナル
    npx @capgo/cli@latest bundle encrypt ./com.example.app.zip CHECKSUM
  3. 暗号化してS3にアップロード:

    ターミナル
    npx @capgo/cli@latest bundle upload \
    --s3-region us-west-2 \
    --s3-apikey YOUR_ACCESS_KEY \
    --s3-apisecret YOUR_SECRET_KEY \
    --s3-bucket-name your-app-bundles \
    --iv-session-key IV_SESSION_KEY_FROM_STEP_2 \
    --channel Production

カスタムストレージを使う場合は、次のセキュリティベストプラクティスを検討してください:

  • ストレージのURLは、アプリのユーザーがアクセスでき、かつ一般には公開されないようにしてください
  • 可能な限り署名付きURLまたはトークンベースの認証を使用してください
  • Webベースのアプリには適切なCORSヘッダーを実装してください
  • 機密性の高いbundleは常に Capgo の暗号化ツールを使用して暗号化してください
  • 暗号化キーは安全に保管し、定期的にローテーションしてください
  • すべてのbundle URLにHTTPSを使用してください(モバイルおよびElectronアプリでは必須)
  • アクセスログを監視し、異常なダウンロードパターンを検知してください
  • bundleのダウンロード失敗に対するアラートを設定してください
  • ストレージの権限を定期的に監査してください

Bundleがダウンロードできない場合:

  • URLが公開されていてHTTPSを使用しているか確認してください(モバイルおよびElectronアプリでは必須)
  • Webアプリの場合はCORSヘッダーを確認してください
  • Bundleのフォーマットが正しいか確認してください

暗号化エラー:

  • 次を確認してください: ivSessionKey 暗号化されたBundleと一致しているか
  • Bundleが正しいキーで暗号化されているか確認してください
  • 新しいbundleにはencryption v2を使用してください

S3のアップロード失敗:

  • S3の認証情報と権限を確認してください
  • バケットポリシーとCORS設定を確認してください
  • 指定したリージョンが正しいか確認してください

bundleのステータスを確認:

ターミナル
npx @capgo/cli@latest app debug

bundleの整合性を確認:

ターミナル
npx @capgo/cli@latest bundle list
  • 詳しく知る チャンネル 異なるデプロイ環境を管理するには
  • 詳しく見る アップデートの動作 アップデートの適用方法をカスタマイズするために
  • セットアップ CI/CD 連携 カスタムストレージのワークフローを自動化するために

使用している場合 カスタムストレージ セキュリティとコンプライアンスを計画するには、これを以下と連携させてください 暗号化 暗号化の実装詳細について コンプライアンス コンプライアンスの実装詳細について Capgo セキュリティスキャナー Capgo Security Scanner のプロダクトワークフローについて Capgo のセキュリティ Capgo Security のプロダクトワークフロー向け、および Capgo トラストセンター Capgo Trust Center のプロダクトワークフロー向け。