Cara membuat kunci API App Store Connect
Shipcue membaca status review dan merilis versi lewat API App Store Connect dari Apple. Untuk itu Shipcue memerlukan kunci API dari setiap akun yang ingin Anda ikuti. Berikut cara membuatnya, langkah demi langkah.
Kunci Team atau kunci Individual?
App Store Connect memiliki dua jenis kunci API. Shipcue bekerja dengan keduanya.
- Kunci Team (disarankan). Dibuat oleh Admin tim. Bisa melihat semua aplikasi tim, dengan peran yang Anda pilih untuk kunci tersebut. Disertai Issuer ID.
- Kunci Individual. Dibuat di profil pengguna Anda sendiri. Memiliki peran dan akses aplikasi yang sama dengan pengguna Anda, jadi hanya melihat aplikasi yang bisa Anda lihat. Tidak memiliki Issuer ID. Anda memerlukan izin "Generate Individual API Keys", yang bisa diberikan oleh Admin tim.
Jika Anda bekerja untuk klien, kunci Individual sering kali jalur yang lebih mudah: Anda tidak perlu meminta Admin membuatkan kunci, cukup izin tersebut.
Peran apa yang sebaiknya dimiliki kunci?
Pilih peran terkecil yang memenuhi kebutuhan Anda:
- App Manager: yang paling cocok untuk Shipcue. Bisa merilis dan menarik versi, mengendalikan rilis bertahap, dan menyiapkan webhook yang dibutuhkan push, tetapi tidak bisa mengelola pengguna.
- Admin: juga bisa, tetapi dapat pula menambah dan menghapus pengguna. Hindari untuk kunci yang berada di ponsel Anda.
- Developer: hanya melihat. Shipcue menampilkan status terkini saat Anda membukanya atau menarik untuk menyegarkan, tetapi tidak bisa menyiapkan push dan tidak bisa merilis atau menarik.
Buat kunci baru khusus untuk Shipcue. Jangan pakai ulang kunci yang menjadi tumpuan CI atau alat lain Anda, agar Anda bisa mencabut yang satu tanpa merusak yang lain.
Membuat kunci Team
-
Buka halaman kunci API
Masuk ke App Store Connect di browser sebagai Admin. Buka Users and Access, pilih tab Integrations, lalu App Store Connect API di kolom kiri. Jika halaman menampilkan tombol Request Access, Account Holder harus meminta akses API satu kali.
-
Buat kuncinya
Pastikan Team Keys terpilih dan klik Generate API Key (atau tombol +). Beri nama yang mudah Anda kenali nanti, misalnya "Shipcue". Di bawah Access, pilih App Manager. Klik Generate.
-
Unduh file .p8
Klik Download API Key di samping kunci baru. Apple hanya mengizinkan satu kali unduh dan tidak menyimpan salinan. File ini bernama AuthKey_ diikuti Key ID, misalnya AuthKey_ABCD123456.p8. Simpan di tempat aman, seperti pengelola kata sandi Anda.
-
Salin Issuer ID
Issuer ID ditampilkan di atas daftar kunci. Bentuknya seperti 69a6de8f-3c2e-47e3-e053-5b8c7c11a4d1. Shipcue memerlukannya untuk kunci Team.
Membuat kunci Individual
-
Buka profil Anda
Di App Store Connect, buka profil pengguna Anda dan gulir ke bawah ke Individual API Key. Jika tidak ada tombol Generate API Key, minta izin "Generate Individual API Keys" kepada Admin tim.
-
Buat dan unduh
Klik Generate API Key, lalu Download API Key. Seperti kunci Team, file .p8 hanya bisa diunduh satu kali. Kunci Individual tidak memiliki Issuer ID.
Tambahkan kunci ke Shipcue
-
Mulai Add Account
Di Shipcue, ketuk Add Account. Pilih file .p8 dari File, kirim lewat AirDrop dari Mac Anda dan pilih Shipcue, atau tempel teks kunci.
-
Periksa detailnya
Jika file masih memakai nama AuthKey_, Shipcue mengisi Key ID untuk Anda. Tempel Issuer ID untuk kunci Team, atau kosongkan untuk kunci Individual. Beri akun nama yang mudah Anda kenali, seperti "Client: Acme".
-
Biarkan Shipcue memeriksanya ke Apple
Shipcue bertanya ke App Store Connect aplikasi mana yang bisa dilihat kunci tersebut. Kunci yang baru dibuat bisa membutuhkan satu atau dua menit untuk mulai berfungsi; Shipcue terus mencoba.
-
Pilih aplikasi Anda
Pilih aplikasi yang ingin diikuti. Dengan Shipcue Pro, Shipcue menambahkan satu webhook per aplikasi di Apple agar perubahan status sampai kepada Anda sebagai push. Apple mengizinkan 10 webhook per aplikasi, dan Shipcue memakai 1.
Perlu diketahui
- Secara default kunci disimpan di iCloud Keychain Anda, dienkripsi ujung ke ujung oleh Apple, agar iPhone dan iPad bisa sama-sama memakainya. Anda bisa menyimpan kunci di satu perangkat saja. Di mode Private kunci tidak pernah sampai ke server kami.
- Setiap akun App Store Connect yang Anda tambahkan memerlukan kunci sendiri.
- Untuk menghentikan kunci di mana pun, cabut di App Store Connect: Users and Access › Integrations › App Store Connect API, pilih kunci, Revoke. Itu juga langkah pertama jika Anda kehilangan perangkat (lihat Perangkat hilang?).
- Jangan pernah mengirim file .p8 atau isinya kepada siapa pun, termasuk kami.
Pertanyaan
Bisakah saya mengunduh file .p8 lagi?
Tidak. Apple hanya menyediakan unduhan satu kali. Jika file hilang, cabut kunci itu di App Store Connect dan buat yang baru. Di Shipcue, gunakan Replace Key pada akun agar aplikasi dan pengaturannya tetap ada.
Di mana saya menemukan Issuer ID?
Di App Store Connect pada Users and Access › Integrations › App Store Connect API, di atas daftar kunci Team. Kunci Individual tidak memilikinya.
Bisakah saya memakai kunci dengan peran Developer?
Bisa, tetapi hanya untuk melihat status. Kunci Developer tidak bisa membuat webhook, jadi tidak ada push untuk aplikasi tersebut, dan tidak bisa merilis atau menarik. Gunakan App Manager untuk fungsi lengkap.
Apakah Shipcue memerlukan kata sandi Akun Apple saya?
Tidak. Shipcue hanya memakai kunci API. Tidak ada login dengan Akun Apple Anda dan tidak ada kode dua faktor.
Terkait
Ikuti setiap akun di satu tempat
Shipcue mengirim push saat status App Review berubah, untuk setiap akun App Store Connect yang Anda tambahkan. Gratis selama 14 hari.
Lihat cara kerja Shipcue