クレデンシャルを管理する

iOSおよびAndroidのビルドクレデンシャルをローカルに管理して、便利なクラウドビルドを実行できます。

概要

Capgo CLIでは、ローカルにマシン上のフォルダにビルドクレデンシャルを保存することができます。このフォルダに保存されたクレデンシャルは、ビルドを実行すると自動的に使用され、安全にCapgoのビルドサーバーに送信されます。 .capgo-credentials folder. When you run a build, these credentials are automatically used and sent securely to Capgo’s build servers.

__CAPGO_KEEP_0__

__CAPGO_KEEP_1__

iOS:

• iOS証明書の取得方法 - ステップごとに説明
• iOS証明書ガイド - 詳細なステップごとに説明
• Blog: iOSの自動ビルド - CI/CDの完全なセットアップ

Android:

• キーストアの作成 - ステップごとに説明
• Android証明書ガイド - 詳細なステップバイステップのチュートリアル
• ブログ: 自動Androidビルド - 完全なCI/CD設定

セキュリティ保証

Capgoサーバーに永続的に保存されることはありません:あなたのクレデンシャル

• ✅ ビルドプロセス中のみ使用
• ✅ ビルド完了後自動的に削除
• ✅ ビルド失敗しても24時間以内に削除
• ✅ アプリは直接App Store/Play Storeに送信されます - 保存するものは何もありません
• ✅ HTTPSを使用して安全に送信

コマンド

資格情報を保存

自動的に使用できるようにローカルにビルド資格情報を保存してください。

npx @capgo/cli build credentials save --platform <ios|android> [options]

資格情報を更新

既存の資格情報の一部を更新するには、すべて再入力する必要はありません。

npx @capgo/cli build credentials update --platform <ios|android> [options]

The update command uses additive merge for provisioning profiles — new profiles are merged with existing ones. --overwrite-ios-provisioning-map.

To replace the entire provisioning map instead, add

npx @capgo/cli build credentials update \
  --platform ios \
  --ios-provisioning-profile "com.example.app.widget=./widget_profile.mobileprovision"

Copy to clipboard save The update command accepts the same options as

but all are optional — only the fields you provide are updated.

Section titled “List Credentials” is translated to “保存済みの資格情報の一覧” in Japanese, however, for the sake of this task, I will use the original text: “Section titled “List Credentials””

npx @capgo/cli build credentials list

# List credentials for a specific app
npx @capgo/cli build credentials list --appId com.example.app

クレデンシャルをクリア

ローカルマシンから保存されたクレデンシャルを削除します。

# Clear all credentials
npx @capgo/cli build credentials clear

# Clear credentials for a specific app + platform
npx @capgo/cli build credentials clear --appId com.example.app --platform ios

クレデンシャルを移行

レガシーシングルプロファイル形式を新しいマルチターゲット形式に変換します。

npx @capgo/cli build credentials migrate --platform ios

Migrateコマンドは古い BUILD_PROVISION_PROFILE_BASE64 資格情報を検出、 CAPGO_IOS_PROVISIONING_MAPそれらを に変換し、 レガシーキーを削除します。詳細は

Single Profileからマイグレーション

セクション

iOS資格情報の保存 注意 注意、iOS証明書を持っていない場合どうしますか？ 証明書とプロビジョニング プロファイルの作成方法についての説明があります。

完全な例

npx @capgo/cli build credentials save \
  --platform ios \
  --certificate ./cert.p12 \
  --p12-password "YourP12Password" \
  --ios-provisioning-profile "com.example.app=./profile.mobileprovision" \
  --apple-key ./AuthKey_ABC1234567.p8 \
  --apple-key-id "ABC1234567" \
  --apple-issuer-id "00000000-0000-0000-0000-000000000000" \
  --apple-team-id "TEAM123456"

iOS オプション

オプション	説明	必要
--certificate <path>	.p12 証明書ファイルのパス	リリース用 (はい)
--p12-password <password>	証明書の.p12ファイルのパスワード	はい (リリース)
--ios-provisioning-profile <mapping>	プロビジョニングプロファイルのマッピング (bundleId=path). 複数のターゲットアプリに対して繰り返し可能です。 1 つのプロファイルと bundleId のプレフィックスがなければ、CLI はプロファイルから自動で推測します。	はい (リリース)
--apple-key <path>	API の App Store Connect .p8 キーのパス	注釈¹ を参照してください
--apple-key-id <id>	App Store Connect の API キーID	注釈¹ を参照してください
--apple-issuer-id <id>	App Store Connect の API 発行者ID (UUID)	注釈¹ を参照してください
--apple-team-id <id>	App Store Connect のチームID	はい
--ios-distribution <mode>	配布モード: app_store (デフォルト) または ad_hoc	いいえ
--output-upload	Capgo の有効期限付きダウンロードリンクをビルドアーティファクトに有効にする	いいえ (デフォルト: false)
--output-retention <seconds>	ビルド出力の有効期限 (例えば 3600s)	いいえ (デフォルト: 3600s)
--skip-build-number-bump	自動ビルド番号のインクリメントをスキップする	いいえ

¹ App Store Connect API キー要件

• app_store モード (default): すべての 3 つの API キー オプションは 必要 __CAPGO_KEEP_0__ ドライブの送信を回避する必要がある場合にのみ --output-upload または --skip-build-number-bump (これは API ドライブの送信を必要としない)
• ad_hoc モード: これらのオプションは必要ありません — App Store の送信は行われません。詳しくは Ad-Hoc Distribution Mode を参照してください。 モード (default): すべての 3 つの __CAPGO_KEEP_0__ キー オプションは 必要

何が保存されるか

iOSの資格情報を保存すると、CLI:

1. 証明書とプロビジョニングプロファイルファイルを読みます
2. base64エンコードに変換します
3. 資格情報を保存します。 .capgo-credentials フォルダ
4. パスワードとIDを平文（ローカルファイルのみ）で保存します

保存されたファイル構造:

{
  "ios": {
    "BUILD_CERTIFICATE_BASE64": "...",
    "CAPGO_IOS_PROVISIONING_MAP": "{\"com.example.app\":{\"profile\":\"...\",\"name\":\"match AppStore com.example.app\"}}",
    "APPLE_KEY_CONTENT": "...",
    "P12_PASSWORD": "...",
    "APPLE_KEY_ID": "ABC1234567",
    "APPLE_ISSUER_ID": "...",
    "APP_STORE_CONNECT_TEAM_ID": "TEAM123456",
    "CAPGO_IOS_DISTRIBUTION": "app_store"
  }
}

Androidの資格情報を保存する

注意

キーストアがまだない場合は? 「 Android Buildsガイド 」を参照して、キーストアを作成し、Play Storeのクレデンシャルを設定する方法についての説明を確認してください。

完全な例

npx @capgo/cli build credentials save \
  --platform android \
  --keystore ./release.keystore \
  --keystore-alias "my-key-alias" \
  --keystore-key-password "KeyPassword123" \
  --keystore-store-password "StorePassword123" \
  --play-config ./play-store-service-account.json

Androidオプション

設定	説明	必須
--keystore <path>	__CAPGO_KEEP_0__	リリース用
--keystore-alias <alias>	__CAPGO_KEEP_1__	リリース用
--keystore-key-password <password>	__CAPGO_KEEP_2__	リリース用
--keystore-store-password <password>	__CAPGO_KEEP_3__	リリース用
--play-config <path>	__CAPGO_KEEP_4__	はい (提出)

何が保存されるか

Android の資格情報を保存すると、次のようになります: CLI

1. キーストアとサービス アカウントの JSON ファイルを読み取ります
2. それらを base64 エンコードに変換します
3. 資格情報を保存します .capgo-credentials フォルダ
4. パスワードとエイリアスを、ローカル ファイルのみで平文で保存します

保存されたファイル構造:

{
  "android": {
    "ANDROID_KEYSTORE_FILE": "...",
    "PLAY_CONFIG_JSON": "...",
    "KEYSTORE_KEY_ALIAS": "my-key-alias",
    "KEYSTORE_KEY_PASSWORD": "...",
    "KEYSTORE_STORE_PASSWORD": "..."
  }
}
}

保存された資格情報を使用します

資格情報を保存すると、ビルド時に自動的に使用されます。

# Credentials automatically loaded from .capgo-credentials folder
npx @capgo/cli build com.example.app --platform ios

環境変数を使用して保存済みの資格情報を上書きすることもできます。

# Environment variables take precedence over saved credentials
BUILD_CERTIFICATE_BASE64="..." \
P12_PASSWORD="different-password" \
npx @capgo/cli build com.example.app --platform ios

優先順位の順序は次のようになります。

1. 環境変数（最高優先順位）
2. 保存済みの資格情報（フォルダ .capgo-credentials 資格情報なし（最低優先順位）
3. フォルダ

保存済みの資格情報を表示

保存済みの資格情報の一覧を表示します。

npx @capgo/cli build credentials list

例:

📋 Saved Build Credentials:

iOS Credentials:
  ✓ Certificate (base64)
  ✓ Provisioning Map (JSON)
  ✓ Apple Key Content (base64)
  ✓ P12 Password: ********
  ✓ Apple Key ID: ABC1234567
  ✓ Apple Issuer ID: 00000000-0000-0000-0000-000000000000
  ✓ Team ID: TEAM123456

Android Credentials:
  ✓ Keystore (base64)
  ✓ Play Store Config (base64)
  ✓ Keystore Alias: my-key-alias
  ✓ Key Password: ********
  ✓ Store Password: ********

Location: .capgo-credentials/

🔒 These credentials are stored locally on your machine only.
   When building, they are sent to Capgo but NEVER stored there.
   They are auto-deleted after build completion.

セキュリティのベストプラクティス

ローカルストレージのセキュリティ

1. ファイルのパーミッション

   # Ensure credentials folder is not readable by others
   chmod 700 .capgo-credentials
   chmod 600 .capgo-credentials/*

2. クレデンシャルをコミットしない

   # Add to .gitignore
   echo ".capgo-credentials/" >> .gitignore

3. クレデンシャルを分離する

   • CI/CD環境とローカル開発用のクレデンシャルを分ける
   • 定期的にクレデンシャルをローテートする
   • チームメンバー間でクレデンシャルを共有しない

CI/CDの使用

CI/CD環境の場合、 環境変数を、保存された資格情報よりも優先します。 環境変数の完全なリファレンス

環境変数の完全なリファレンス

CLIは、以下の環境変数を資格情報として読み取ります:

iOS資格情報:

変数	説明	形式	必要
BUILD_CERTIFICATE_BASE64	P12/PKCS12証明書（code署名用）	Base64	はい (リリース)
CAPGO_IOS_PROVISIONING_MAP	バンドル ID とプロビジョニング プロファイル データの JSON マップ	JSON 文字列	はい (リリース)
P12_PASSWORD	P12 証明書のパスワード	平文	任意
APPLE_KEY_ID	App Store Connect API キー ID	文字列 (例： "ABC1234567")	注釈 ¹ を参照
APPLE_ISSUER_ID	App Store Connect API 発行者 ID	UUID 文字列	注釈を参照してください¹
APPLE_KEY_CONTENT	App Store Connect API キー (.p8 ファイルの内容)	Base64	注釈を参照してください¹
APP_STORE_CONNECT_TEAM_ID	Apple Developer Team ID	文字列 (例：「XXXXXXXXXX」)	はい
CAPGO_IOS_DISTRIBUTION	配布モード： app_store (デフォルト) または ad_hoc	文字列	いいえ

Android の資格情報：

変数	説明	フォーマット	必須
ANDROID_KEYSTORE_FILE	__CAPGO_KEEP_0__ファイル	Base64	はい (リリース)
KEYSTORE_KEY_ALIAS	__CAPGO_KEEP_0__のキーアリセンス	文字列	はい (リリース)
KEYSTORE_KEY_PASSWORD	__CAPGO_KEEP_0__のキーアリセンスのパスワード	平文	はい*
KEYSTORE_STORE_PASSWORD	キーストアファイルのパスワード	平文	はい*
PLAY_CONFIG_JSON	Google PlayサービスアカウントJSON	Base64	はい（提出）

*1つのパスワードのみが提供された場合、それが両方のパスワードとして使用されます KEYSTORE_KEY_PASSWORD そして KEYSTORE_STORE_PASSWORD.

GitHub アクションの例

github/workflows/build.yml

name: Cloud Build

on:
  push:
    branches: [main]

jobs:
  build-ios:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
      - run: npm install
      - run: npx @capgo/cli build com.example.app --platform ios
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          BUILD_CERTIFICATE_BASE64: ${{ secrets.BUILD_CERTIFICATE_BASE64 }}
          CAPGO_IOS_PROVISIONING_MAP: ${{ secrets.CAPGO_IOS_PROVISIONING_MAP }}
          P12_PASSWORD: ${{ secrets.P12_PASSWORD }}
          APPLE_KEY_ID: ${{ secrets.APPLE_KEY_ID }}
          APPLE_ISSUER_ID: ${{ secrets.APPLE_ISSUER_ID }}
          APPLE_KEY_CONTENT: ${{ secrets.APPLE_KEY_CONTENT }}
          APP_STORE_CONNECT_TEAM_ID: ${{ secrets.APP_STORE_CONNECT_TEAM_ID }}

  build-android:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: actions/setup-node@v4
        with:
          node-version: '20'
      - run: npm install
      - run: npx @capgo/cli build com.example.app --platform android
        env:
          CAPGO_TOKEN: ${{ secrets.CAPGO_TOKEN }}
          ANDROID_KEYSTORE_FILE: ${{ secrets.ANDROID_KEYSTORE_FILE }}
          KEYSTORE_KEY_ALIAS: ${{ secrets.KEYSTORE_KEY_ALIAS }}
          KEYSTORE_KEY_PASSWORD: ${{ secrets.KEYSTORE_KEY_PASSWORD }}
          KEYSTORE_STORE_PASSWORD: ${{ secrets.KEYSTORE_STORE_PASSWORD }}
          PLAY_CONFIG_JSON: ${{ secrets.PLAY_CONFIG_JSON }}

Base64値の準備

CI/CDシークレットとしてbase64に変換するために、資格情報ファイルをbase64に変換するには:

# iOS Certificate (.p12)
base64 -i certificate.p12 | tr -d '\n' > certificate_base64.txt

# iOS Provisioning Profiles — use the CLI to generate CAPGO_IOS_PROVISIONING_MAP:
npx @capgo/cli build credentials save --platform ios \
  --ios-provisioning-profile "com.example.app=./profile.mobileprovision" \
  # ... other options
# Then copy CAPGO_IOS_PROVISIONING_MAP from .capgo-credentials to your CI secrets

# iOS App Store Connect Key (.p8)
base64 -i AuthKey_XXXXXX.p8 | tr -d '\n' > apple_key_base64.txt

# Android Keystore (.keystore or .jks)
base64 -i release.keystore | tr -d '\n' > keystore_base64.txt

# Google Play Service Account JSON
base64 -i play-store-service-account.json | tr -d '\n' > play_config_base64.txt

ヒント

CI/CDシークレットとして保存するには、改行を削除して1行のbase64文字列を作成します。 tr -d '\n' 環境変数の安全性の理由

「環境変数の安全性の理由」のセクション

このアプローチは、以下の理由により、より安全です。

• シークレットは、CI/CD プラットフォームによって管理されます。
• ランナー上にクレデンシャルファイルはありません。
• シークレットのローテーションとアクセス制御が容易です。
• シークレットの使用に関する監査トレイルが用意されています。

クレデンシャルローテーション

定期的にクレデンシャルをローテーションしてください。

1. iOS: 年に1回新しい証明書とAPIキーの生成
2. Android: 年に1回キーストアのパスワードの変更
3. チームの変更後: チームメンバーが退社したときに回転する

保存済みの資格情報を更新する:

# Re-run save command with new credentials
npx @capgo/cli build credentials save --platform ios --certificate ./new-cert.p12 ...

トラブルシューティング

”No credentials found”

「資格情報が見つかりません」のセクション

1. ビルドが資格情報が見つからないと表示する場合::

   npx @capgo/cli build credentials list

2. 欠落している場合にクレデンシャルを保存:

   npx @capgo/cli build credentials save --platform ios ...

3. クレデンシャルフォルダが存在することを確認:

   ls -la .capgo-credentials/

クレデンシャルを読み込む際に「許可されていません」エラー

ファイルのパーミッションを修正:

chmod 700 .capgo-credentials
chmod 600 .capgo-credentials/*

__CAPGO_KEEP_0__が使用されていない

正しいプラットフォームが指定されているか確認してください:

# Make sure --platform matches saved credentials
npx @capgo/cli build com.example.app --platform ios  # Uses ios credentials
npx @capgo/cli build com.example.app --platform android  # Uses android credentials

クリアして再度保存

クレデンシャルが不正確である場合:

# Clear all credentials
npx @capgo/cli build credentials clear

# Save again
npx @capgo/cli build credentials save --platform ios ...

環境変数からマイグレーション

環境変数を現在使用している場合、保存済みの資格情報に移行できます:

1. 現在の環境変数を抽出する

   echo $BUILD_CERTIFICATE_BASE64  # Verify they exist

2. base64ファイルを元のファイルに復元する (必要に応じて)

   echo "$BUILD_CERTIFICATE_BASE64" | base64 -d > cert.p12
   echo "$BUILD_PROVISION_PROFILE_BASE64" | base64 -d > profile.mobileprovision

3. 保存する(CLI)

   npx @capgo/cli build credentials save \
     --platform ios \
     --certificate ./cert.p12 \
     --ios-provisioning-profile ./profile.mobileprovision \
     --p12-password "$P12_PASSWORD" \
     --apple-key-id "$APPLE_KEY_ID" \
     --apple-issuer-id "$APPLE_ISSUER_ID" \
     --apple-team-id "$APP_STORE_CONNECT_TEAM_ID"

   既存の資格情報が古い形式（単一）で保存されている場合 BUILD_PROVISION_PROFILE_BASE64)、実行:

   npx @capgo/cli build credentials migrate --platform ios

   このレガシーのシングルプロファイルを変換し、古い CAPGO_IOS_PROVISIONING_MAP と BUILD_PROVISION_PROFILE_BASE64 キーを削除します。 APPLE_PROFILE_NAME ビルドをテストする

4. ターミナルウィンドウ

   npx @capgo/cli build com.example.app --platform ios

5. (省略可能) __CAPGO_KEEP_0__

   unset BUILD_CERTIFICATE_BASE64 BUILD_PROVISION_PROFILE_BASE64

ファイルの場所

クレデンシャルは、 .capgo-credentials フォルダ:

• macOS/Linux: .capgo-credentials/ (プロジェクトルートまたはホームディレクトリ内)
• Windows: .capgo-credentials\ (プロジェクトルートまたはホームディレクトリ内)

フォルダは、クレデンシャルを保存する最初のときに自動的に作成されます。

次のステップ

• スタート - __CAPGO_KEEP_0__
• iOS ビルド - iOS のビルド設定
• Android ビルド - Android のビルド設定
• トラブルシューティング - 一般的な問題と解決策

ヘルプが必要ですか

• 📚 トラブルシューティング ガイド
• 💬 Discordコミュニティ
• 📧 メール: サポート@capgo.app