管理用資格情報

コピー可能

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

概要

Capgo CLIはビルドクレデンシャルを 機械に保存します — Capgoのサーバーには保存されません。デフォルトでは、すべてのプロジェクトで共有される グローバル ファイルに保存されます。 ~/.capgo-credentials/credentials.jsonファイル --local パスを渡して保存する プロジェクトごとに 内 .capgo-credentials.json 代わりに。ビルドを実行すると、保存された資格情報が自動的に使用され、安全に Capgo に送信され、ビルドが完了すると削除されます。

コマンド

クレデンシャルをインタラクティブに管理

保存されたクレデンシャルを操作する最速の方法は、インタラクティブマネージャです。TUI (同じものを使用) が開き、保存されているものを参照できます。アプリとプラットフォームごとに設定されているものを確認できます。CI/CD用のファイルをエクスポートするか、プラットフォームのクレデンシャルを削除できます。 build init ターミナル画面 .env クリップボードにコピー

bunx @capgo/cli@latest build credentials manage

設定	説明
`--appId <appId>`	管理するアプリ (省略した場合は選択肢が表示されます)
`--platform <ios\|android>`	管理するプラットフォーム (省略した場合は選択肢が表示されます)
`--local`	プロジェクトごとに使用する `.capgo-credentials.json` グローバルファイルではなくプロジェクトごとのファイルを使用する

一括実行ではなく、スクリプトで実行することを優先しますか? 以下の個別のコマンドを使用してください。

資格情報を保存

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

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

資格情報を更新

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

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

この update コマンドは 追加的マージ プロビジョニングプロファイルの場合 — 新しいプロファイルは既存のプロファイルとマージされます。すべてのプロビジョニングマップを置き換えるには --overwrite-ios-provisioning-map.

例 — 既存の資格情報に拡張プロファイルを追加します:

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

アップデートコマンドは、同じオプションを受け入れる save がすべて省略可能です — 提供されたフィールドのみが更新されます。

クレデンシャルの一覧

現在保存されているクレデンシャルを表示 (パスワードはマスクされています):

bunx @capgo/cli@latest build credentials list

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

クレデンシャルをクリア

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

# Clear all credentials
bunx @capgo/cli@latest build credentials clear

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

Migrate Credentials

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

bunx @capgo/cli@latest build credentials migrate --platform ios

migrateコマンドは、古い BUILD_PROVISION_PROFILE_BASE64 を検出し、 CAPGO_IOS_PROVISIONING_MAPに変換し、レガシーキーを削除します。詳細は Single Profileからマイグレーションの詳細を参照してください。

iOSの保存

完全な例

bunx @capgo/cli@latest 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 つのプロファイルしかない場合、Bundle ID のプレフィックスがなければ、CLI はプロファイルから自動で推測されます。	はい (リリース)
`--apple-key <path>`	App Store Connect の API .p8 キーのパス	注:¹
`--apple-key-id <id>`	App Store Connect API Key ID	See note¹
`--apple-issuer-id <id>`	App Store Connect API Issuer ID (UUID)	See note¹
`--apple-team-id <id>`	App Store Connect Team ID	Yes
`--apple-id <email>`	App Store Connectのアプリ固有のパスワードアップロード用のApple IDメールアドレス（APIキー代替)	See note²
`--apple-app-specific-password <password>`	App Store Connectのアプリ固有のパスワード`xxxx-xxxx-xxxx-xxxx`)	See note²
`--apple-app-id <id>`	数字のApp Store ConnectアプリID（例えば `1234567890`)	See note²
`--ios-distribution <mode>`	配布モード: `app_store` (default) または `ad_hoc`	なし
`--output-upload`	Capgo ダウンロードリンクを有効にする (期間限定)	なし (default: `false`)
`--output-retention <seconds>`	ビルドアウトプットを保持する期間 (例えば `3600s`)	なし (default: `3600s`)
`--skip-build-number-bump`	自動ビルド番号のインクリメントをスキップ	なし

この方法は非推奨であり、対処すべきです。 これは、Ionic Appflow からマイグレーションするチーム向けの互換性のためのパスのみが存在します。 App Store Connect API キー (.p8)、CI/CD用に推奨される、機能が強く、セキュリティが高いオプションが推奨されます。必要な場合は、すべての 3 つのオプション (--apple-id, --apple-app-specific-password、 --apple-app-id) が必要です。数値 (App Store Connect → アプリ → アプリ情報 → Apple ID) は、インタラクティブ 2FA プロンプトなしでアップロードを実行することができます; この方法では、ビルド番号はタイムスタンプにフォールバックします。 App Store Connect がクエリされないためです。 --apple-app-id 何が保存されるか

セクション "何が保存されるか"

When you save iOS credentials, the CLI:

base64 エンコードに変換します
App Store Connect → アプリ → アプリ情報 → Apple ID
保存する ~/.capgo-credentials/credentials.json (または .capgo-credentials.json と --local)
パスワードと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の資格情報を保存する

完全な例

bunx @capgo/cli@latest 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>`	keystore または jks ファイルのパス	はい (リリース)
`--keystore-alias <alias>`	キーストア内のエイリアス	はい (リリース)
`--keystore-key-password <password>`	キーストア内のエイリアスのパスワード	はい (リリース)
`--keystore-store-password <password>`	キーストアのパスワード	はい (リリース)
`--play-config <path>`	Play Store サービスアカウント JSON のパス	はい (提出)

何が保存されるか

When you save Android credentials, the CLI:

キーストアとサービスアカウントのJSONファイルを読み取ります
base64エンコードに変換します
保存します ~/.capgo-credentials/credentials.json （または .capgo-credentials.json と --local)
パスワードとエイリアスをプレーンテキスト（ローカルファイルのみ）で保存します

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

{
  "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/credentials.json
bunx @capgo/cli@latest build request com.example.app --platform ios

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

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

優先順位の順序:

環境変数（最高優先順位）
保存済みの資格情報（~/.capgo-credentials/credentials.json, またはローカル .capgo-credentials.json)
資格情報なし（最低優先順位）

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

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

bunx @capgo/cli@latest 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/credentials.json

🔒 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.

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

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

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

# Global credentials directory + file
chmod 700 ~/.capgo-credentials
chmod 600 ~/.capgo-credentials/credentials.json
# Local (per-project) credentials, if you use --local
chmod 600 .capgo-credentials.json

クレデンシャルをコミットしない
ターミナル画面
```
# Ignore the per-project credentials file (used with --local)
echo ".capgo-credentials.json" >> .gitignore
```
グローバルファイルは、ホームディレクトリの外側のリポジトリの外側にあります。
別々の資格情報
- CI/CD環境とローカル開発用に異なる資格情報を使用します。
- 資格情報を定期的にローテートする
- チームメンバー間で資格情報を共有しない

CI/CD使用

CI/CD環境の場合、環境変数を保存された資格情報よりも優先します。 CI/CD環境の場合、環境変数を保存された資格情報よりも優先します。 CI/CD環境の場合、環境変数を保存された資格情報よりも優先します。

使用可能な .env をエクスポート `.env` (推奨)

各クレデンシャルファイルを手動で base64 エンコードするのではなく (以下を参照)、下記、 build credentials manage ファイルを自動生成してください:

bunx @capgo/cli@latest build credentials manage
# pick your app → choose "Export to .env"

CI/CD プロバイダーに追加するシークレットとして環境変数として保存されているすべてのクレデンシャルを含むファイル (権限 .env.capgo.<appId>.<platform> ) 0600) containing every saved credential as an environment variable — each line is one secret to add to your CI/CD provider. Both platforms are combined by default; add --platform ios または --platform android 一つに絞る

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

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

iOSの資格情報:

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

Android 認証情報:

変数	説明	形式	必要
`ANDROID_KEYSTORE_FILE`	APK/AAB の署名用キーストアファイル	Base64	はい (リリース)
`KEYSTORE_KEY_ALIAS`	キーストア内でのキーアリセス	文字列	Yes (リリース)
`KEYSTORE_KEY_PASSWORD`	キーアリーサliasのパスワード	平文	Yes*
`KEYSTORE_STORE_PASSWORD`	キーストアファイルのパスワード	平文	Yes*
`PLAY_CONFIG_JSON`	Google PlayサービスアカウントJSON	Base64	Yes (提出)

*両方のパスワードが提供されていない場合、どちらも使用されるパスワードが使用されます KEYSTORE_KEY_PASSWORD かつ KEYSTORE_STORE_PASSWORD.

GitHub Actions Example

name: Cloud Build

on:
  push:
    branches: [main]

jobs:
  build-ios:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v6
      - uses: oven-sh/setup-bun@v2
      - run: bun install
      - run: bunx @capgo/cli@latest build request 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: oven-sh/setup-bun@v2
      - run: bun install
      - run: bunx @capgo/cli@latest build request 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値の準備

ターミナル

# 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:
bunx @capgo/cli@latest build credentials save --platform ios \
  --ios-provisioning-profile "com.example.app=./profile.mobileprovision" \
  # ... other options
# Then copy CAPGO_IOS_PROVISIONING_MAP from ~/.capgo-credentials/credentials.json 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プラットフォームによって管理されます
ランナー上の資格情報ファイルが存在しません
資格情報の簡単なローテーションとアクセス制御
シークレットの使用履歴

資格情報のローテーション

資格情報を定期的にローテーションしてください:

iOS: 年に一度新しい証明書とAPIキーを生成する
Android: 年に一度キーストアのパスワードを変更する
チームのメンバーが変更された後: チームのメンバーが退職したときにローテートする

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

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

トラブルシューティング

”資格情報が見つかりません”

ビルドが認証情報が見つからなかったと表示している場合:

認証情報が保存されているか確認してください:
ターミナル画面
```
bunx @capgo/cli@latest build credentials list
```
認証情報が保存されていない場合は保存してください:
ターミナル画面
```
bunx @capgo/cli@latest build credentials save --platform ios ...
```

認証情報ファイルが存在することを確認してください:

ls -la ~/.capgo-credentials/credentials.json   # global
ls -la .capgo-credentials.json                 # local (--local)

認証情報ファイルを読み込む際に “”権限が拒否されました”””というエラーが発生します

ファイルのパーミッションを修正してください

chmod 600 ~/.capgo-credentials/credentials.json   # global
chmod 600 .capgo-credentials.json                 # local

クレデンシャルが使用されていない

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

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

クレデンシャルをクリアして保存

クレデンシャルが不正な場合

# Clear all credentials
bunx @capgo/cli@latest build credentials clear

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

環境変数から移行

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

現在の環境変数を抽出

echo $BUILD_CERTIFICATE_BASE64  # Verify they exist

base64ファイルを元のファイルに復元 必要に応じて

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

保存するにはCLI
ターミナル画面
```
bunx @capgo/cli@latest 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ターミナル画面
クリップボードにコピー
```
bunx @capgo/cli@latest build credentials migrate --platform ios
```
キー CAPGO_IOS_PROVISIONING_MAP キー BUILD_PROVISION_PROFILE_BASE64 テストビルド APPLE_PROFILE_NAME 資格情報の保存には__CAPGO_KEEP_0__

ターミナル画面

bunx @capgo/cli@latest build request com.example.app --platform ios

環境変数を削除 (任意)

unset BUILD_CERTIFICATE_BASE64 BUILD_PROVISION_PROFILE_BASE64

ファイルの場所

クレデンシャルは、単一のJSONファイルに保存されます:

グローバル (デフォルト): ~/.capgo-credentials/credentials.json すべてのプロジェクトに共有されます
ローカル (プロジェクトルート内に) --local): .capgo-credentials.json (プロジェクトルート内に — そのプロジェクトごとにグローバルファイルを上書きします)

ファイルは、最初にクレデンシャルを保存したときに自動的に作成されます。クレデンシャルを追加 .capgo-credentials.json プロジェクト .gitignore プロジェクトごとにクレデンシャルがコミットされることはありません。

次のステップ

短いUIラベルまたはナビゲーションアイテムネイティブビルドビルダークレジット次のステップ
次のステップはじめに
Android ビルド - Android固有のビルド構成
トラブルシューティングコンテキスト: サポート / プレミアムサポートページまたはサポートセクションのフッター。役割: セクションまたはページヘッダー。見られる場所: サポートポリシーページ。メッセージキー `support_policy_troubleshooting_title` (サポートポリシートラブルシューティングタイトル)。

- 共通の問題と解決策

サポート@__CAPGO_KEEP_0__.app

Capgoを使用している場合 資格管理 CI/CDの自動化を計画するには、Cloudflareを接続します。 Capgo CI/CD Capacitorの製品ワークフロー内でCapgo CI/CD Capgo Native Builds Capacitorの製品ワークフロー内でCapgo Native Builds Capgo Integrations Capacitorの製品ワークフロー内でCapgo Integrations CI/CD統合 CapacitorのCI/CD統合の実装詳細 GitHub Actions Integration Capgoの実装詳細についてはGitHubアクション統合で確認してください。

管理用資格情報

概要

コマンド

クレデンシャルをインタラクティブに管理

資格情報を保存

資格情報を更新

クレデンシャルの一覧

クレデンシャルをクリア

Migrate Credentials

iOSの保存

完全な例

iOSオプション

セクション "何が保存されるか"

Androidの資格情報を保存する

完全な例

Android オプション

何が保存されるか

保存済みの資格情報を使用する

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

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

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

CI/CD使用

使用可能な .env をエクスポート .env (推奨)

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

GitHub Actions Example

Base64値の準備

環境変数はなぜ安全か

資格情報のローテーション

トラブルシューティング

”資格情報が見つかりません”

認証情報ファイルを読み込む際に “”権限が拒否されました”””というエラーが発生します

クレデンシャルが使用されていない

クレデンシャルをクリアして保存

環境変数から移行

ファイルの場所

次のステップ

- 共通の問題と解決策

サポート@__CAPGO_KEEP_0__.app

使用可能な .env をエクスポート `.env` (推奨)