Mengelola Kredensial

Kelola kredensial build iOS dan Android Anda secara lokal untuk cloud build yang nyaman.

Gambaran Umum

Capgo CLI memungkinkan Anda menyimpan kredensial build secara lokal di mesin Anda dalam folder .capgo-credentials. Saat Anda menjalankan build, kredensial ini otomatis digunakan dan dikirim dengan aman ke server build Capgo.

Butuh Bantuan Mendapatkan Kredensial?

Jika Anda belum memiliki sertifikat dan kredensial, periksa panduan komprehensif ini:

iOS:

• Cara Mendapatkan Sertifikat iOS - Panduan langkah demi langkah
• Panduan Sertifikat iOS (Capawesome) - Tutorial detail dengan screenshot
• Blog: Build iOS Otomatis - Setup CI/CD lengkap

Android:

• Membuat Keystore - Panduan langkah demi langkah
• Panduan Sertifikat Android (Capawesome) - Tutorial detail dengan screenshot
• Blog: Build Android Otomatis - Setup CI/CD lengkap

Jaminan Keamanan

Kredensial Anda TIDAK PERNAH disimpan secara permanen di server Capgo:

• ✅ Digunakan HANYA selama proses build aktif
• ✅ Otomatis dihapus setelah build selesai
• ✅ Retensi maksimal: 24 jam (bahkan jika build gagal)
• ✅ Aplikasi dikirim langsung ke App Store/Play Store - kami TIDAK menyimpan apa pun
• ✅ Ditransmisikan dengan aman melalui HTTPS

Commands

Simpan Kredensial

Simpan kredensial build Anda secara lokal untuk penggunaan otomatis:

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

Daftar Kredensial

Lihat kredensial yang tersimpan saat ini (password di-mask):

npx @capgo/cli build credentials list

Hapus Kredensial

Hapus kredensial yang tersimpan dari mesin lokal Anda:

# Hapus semua kredensial
npx @capgo/cli build credentials clear

# Hapus hanya kredensial iOS
npx @capgo/cli build credentials clear --platform ios

# Hapus hanya kredensial Android
npx @capgo/cli build credentials clear --platform android

Menyimpan Kredensial iOS

Catatan

Belum punya sertifikat iOS? Lihat panduan build iOS untuk instruksi membuat sertifikat dan provisioning profile.

Contoh Lengkap

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

Opsi iOS

Opsi	Deskripsi	Wajib
--certificate <path>	Path ke file sertifikat .p12	Ya (release)
--p12-password <password>	Password untuk sertifikat .p12	Ya (release)
--provisioning-profile <path>	Path ke file .mobileprovision	Ya (release)
--provisioning-profile-prod <path>	Production provisioning profile (opsional)	Tidak
--apple-key <path>	Path ke API .p8 key App Store Connect	Ya (submission)
--apple-key-id <id>	App Store Connect API Key ID	Ya (submission)
--apple-issuer-id <id>	App Store Connect API Issuer ID (UUID)	Ya (submission)
--apple-team-id <id>	App Store Connect Team ID	Ya (submission)
--apple-id <email>	Email Apple ID (auth alternatif)	Tidak
--apple-app-password <password>	App-specific password (auth alternatif)	Tidak

Apa yang Disimpan

Saat Anda menyimpan kredensial iOS, CLI:

1. Membaca file sertifikat dan provisioning profile
2. Mengkonversi ke encoding base64
3. Menyimpan kredensial ke folder .capgo-credentials
4. Menyimpan password dan ID sebagai plain text (file lokal saja)

Struktur file yang disimpan:

{
  "ios": {
    "BUILD_CERTIFICATE_BASE64": "...",
    "BUILD_PROVISION_PROFILE_BASE64": "...",
    "APPLE_KEY_CONTENT": "...",
    "P12_PASSWORD": "...",
    "APPLE_KEY_ID": "ABC1234567",
    "APPLE_ISSUER_ID": "...",
    "APP_STORE_CONNECT_TEAM_ID": "TEAM123456"
  }
}

Menyimpan Kredensial Android

Catatan

Belum punya keystore? Lihat panduan build Android untuk instruksi membuat keystore dan setup kredensial Play Store.

Contoh Lengkap

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

Opsi Android

Opsi	Deskripsi	Wajib
--keystore <path>	Path ke file .keystore atau .jks	Ya (release)
--keystore-alias <alias>	Key alias di keystore	Ya (release)
--keystore-key-password <password>	Password untuk key alias	Ya (release)
--keystore-store-password <password>	Password untuk keystore	Ya (release)
--play-config <path>	Path ke JSON service account Play Store	Ya (submission)

Apa yang Disimpan

Saat Anda menyimpan kredensial Android, CLI:

1. Membaca file keystore dan service account JSON
2. Mengkonversi ke encoding base64
3. Menyimpan kredensial ke folder .capgo-credentials
4. Menyimpan password dan alias sebagai plain text (file lokal saja)

Struktur file yang disimpan:

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

Menggunakan Kredensial yang Tersimpan

Setelah Anda menyimpan kredensial, mereka otomatis digunakan saat Anda build:

# Kredensial otomatis dimuat dari folder .capgo-credentials
npx @capgo/cli build com.example.app --platform ios

Anda juga dapat override kredensial yang tersimpan menggunakan environment variables:

# Environment variables memiliki prioritas lebih tinggi dari kredensial yang tersimpan
BUILD_CERTIFICATE_BASE64="..." \
P12_PASSWORD="different-password" \
npx @capgo/cli build com.example.app --platform ios

Urutan prioritas:

1. Environment variables (prioritas tertinggi)
2. Kredensial yang tersimpan di folder .capgo-credentials
3. Tidak ada kredensial (prioritas terendah)

Melihat Kredensial yang Tersimpan

Daftar kredensial apa yang telah Anda simpan:

npx @capgo/cli build credentials list

Contoh output:

📋 Saved Build Credentials:

iOS Credentials:
  ✓ Certificate (base64)
  ✓ Provisioning Profile (base64)
  ✓ 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 (max 24 hours).

Best Practices Keamanan

Keamanan Penyimpanan Lokal

1. Permission File

   # Pastikan folder credentials tidak dapat dibaca oleh orang lain
   chmod 700 .capgo-credentials
   chmod 600 .capgo-credentials/*

2. Jangan Commit Kredensial

   # Tambahkan ke .gitignore
   echo ".capgo-credentials/" >> .gitignore

3. Pisahkan Kredensial

   • Gunakan kredensial berbeda untuk development lokal vs CI/CD
   • Rotasi kredensial secara teratur
   • Jangan bagikan kredensial antar anggota tim

Penggunaan CI/CD

Untuk lingkungan CI/CD, lebih baik gunakan environment variables daripada kredensial yang tersimpan:

# GitHub Actions
env:
  BUILD_CERTIFICATE_BASE64: ${{ secrets.IOS_CERTIFICATE }}
  P12_PASSWORD: ${{ secrets.P12_PASSWORD }}
  # ... secrets lainnya

Ini lebih aman karena:

• Secrets dikelola oleh platform CI/CD Anda
• Tidak ada file kredensial di runners
• Rotasi mudah dan kontrol akses
• Audit trails untuk penggunaan secret

Rotasi Kredensial

Rotasi kredensial Anda secara teratur:

1. iOS: Generate sertifikat dan API key baru setiap tahun
2. Android: Ubah password keystore setiap tahun
3. Setelah perubahan tim: Rotasi saat anggota tim keluar

Update kredensial yang tersimpan:

# Jalankan ulang command save dengan kredensial baru
npx @capgo/cli build credentials save --platform ios --certificate ./new-cert.p12 ...

Troubleshooting

”No credentials found”

Jika build mengatakan tidak ada kredensial yang ditemukan:

1. Periksa apakah kredensial tersimpan:

   npx @capgo/cli build credentials list

2. Simpan kredensial jika hilang:

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

3. Verifikasi folder credentials ada:

   ls -la .capgo-credentials/

“Permission denied” saat membaca kredensial

Perbaiki permission file:

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

Kredensial tidak digunakan

Periksa bahwa platform yang benar sudah dispesifikasikan:

# Pastikan --platform cocok dengan kredensial yang tersimpan
npx @capgo/cli build com.example.app --platform ios  # Menggunakan kredensial ios
npx @capgo/cli build com.example.app --platform android  # Menggunakan kredensial android

Hapus dan simpan ulang kredensial

Jika kredensial tampak rusak:

# Hapus semua kredensial
npx @capgo/cli build credentials clear

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

Migrasi dari Environment Variables

Jika Anda saat ini menggunakan environment variables, Anda dapat migrasi ke kredensial yang tersimpan:

1. Ekstrak environment variables Anda saat ini

   echo $BUILD_CERTIFICATE_BASE64  # Verifikasi mereka ada

2. Decode file base64 kembali ke file asli (jika diperlukan)

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

3. Simpan menggunakan CLI

   npx @capgo/cli build credentials save \
     --platform ios \
     --certificate ./cert.p12 \
     --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"

4. Test build

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

5. Hapus environment variables (opsional)

   unset BUILD_CERTIFICATE_BASE64 BUILD_PROVISION_PROFILE_BASE64

Lokasi File

Kredensial disimpan di folder .capgo-credentials:

• macOS/Linux: .capgo-credentials/ (di root proyek atau home directory Anda)
• Windows: .capgo-credentials\ (di root proyek atau home directory Anda)

Folder otomatis dibuat saat Anda menyimpan kredensial untuk pertama kalinya.

Langkah Selanjutnya

• Getting Started - Buat build pertama Anda
• Build iOS - Konfigurasi build spesifik iOS
• Build Android - Konfigurasi build spesifik Android
• Troubleshooting - Masalah umum dan solusi

Butuh Bantuan?

• 📚 Panduan troubleshooting
• 💬 Komunitas Discord
• 📧 Email: support@capgo.app