Provisioning Profile: apa itu, apa saja jenisnya, dan cara kerjanya

Apa itu Provisioning Profile

Provisioning Profile adalah file konfigurasi digital berformat .mobileprovision (untuk iOS) atau .provisionprofile (untuk macOS) yang digunakan Apple untuk mengontrol pemasangan dan peluncuran aplikasi di perangkat. Profil berisi metadata penandatanganan kode yang tanpanya aplikasi tidak dapat diluncurkan di iPhone, iPad, atau Apple Watch fisik — simulator tidak memerlukan profil karena kode tidak ditandatangani untuk dijalankan di prosesor sungguhan.

Profil diterbitkan melalui Apple Developer Portal dan memiliki masa berlaku — biasanya satu tahun untuk profil Development dan Distribution. Menurut kebijakan Apple, profil otomatis terhubung dengan sertifikat Apple Developer Program yang digunakan untuk menandatanganinya: jika sertifikat dicabut atau kedaluwarsa, profil berhenti berfungsi.

Setiap profil berisi UUID unik yang digunakan Xcode untuk mengidentifikasi profil di keychain. Xcode otomatis memilih profil yang sesuai saat build, tetapi pengembang dapat mengubah pilihan di pengaturan Signing & Capabilities. Di satu perangkat dapat diinstal profil dalam jumlah tidak terbatas — sistem manajemen perangkat Apple (MDM) memanfaatkannya untuk distribusi aplikasi korporat.

Untuk apa Provisioning Profile dibutuhkan

Penandatanganan kode adalah alasan utama keberadaan profil. Apple mengharuskan setiap aplikasi yang dijalankan di perangkat iOS ditandatangani dengan sertifikat yang diterbitkan oleh Apple. Provisioning Profile berperan sebagai penghubung: ia mengonfirmasi bahwa pengembang berhak menjalankan aplikasi di perangkat tersebut. Menurut Apple Security Guide (2025), mekanisme profil mencegah pemasangan perangkat lunak berbahaya di perangkat pengguna bahkan jika sertifikat pengembang dikompromikan.

Profil juga menentukan layanan sistem apa saja yang tersedia untuk aplikasi. Jika aplikasi menggunakan notifikasi Push, Apple Push Notification service (APNs) memerlukan entitlements yang benar di dalam profil. Tanpa ini, notifikasi server tidak akan terkirim ke perangkat. Aturan serupa berlaku untuk iCloud, App Groups, Wallet, HealthKit, dan framework Apple lainnya.

Perbedaannya dengan sertifikat

Pengembang sering mencampuradukkan Provisioning Profile dengan Apple Certificate. Sertifikat adalah dokumen digital yang mengonfirmasi identitas (siapa yang menandatangani), sedangkan profil adalah konfigurasi (aplikasi apa, di perangkat apa, dengan hak apa). Satu sertifikat dapat digunakan di beberapa profil, dan satu profil terikat tepat pada satu sertifikat. Apple merekomendasikan membuat profil terpisah untuk setiap aplikasi dan setiap skenario — Development, Ad Hoc, App Store.

Cara kerja Provisioning Profile

Proses penandatanganan aplikasi terdiri dari beberapa langkah yang dilakukan berurutan. Xcode mengambil file biner aplikasi (App Bundle), menandatanganinya dengan kunci privat pengembang, menyisipkan Provisioning Profile ke dalamnya, dan mengirimkannya ke perangkat. Perangkat memverifikasi tanda tangan dengan kunci publik Apple, membandingkan UUID profil dengan daftar profil tepercaya di sistem, dan meluncurkan aplikasi hanya jika semua pemeriksaan berhasil.

Saat pengguna mengunduh aplikasi dari App Store, mekanismenya berbeda. App Store Connect menandatangani ulang aplikasi dengan sertifikat Distribution milik Apple, mengganti profil pengembang dengan profil Store. Ini berarti aplikasi yang diterbitkan melalui App Store secara teknis ditandatangani oleh Apple, bukan pengembang — meskipun tanda tangan awal pengembang diverifikasi pada tahap pengunggahan build ke App Store Connect.

Untuk distribusi Ad Hoc, profil mendaftarkan UDID perangkat tertentu yang diizinkan menjalankan aplikasi. Akun gratis Apple Developer Program dibatasi 100 perangkat per tahun untuk pengujian. Profil Enterprise (untuk distribusi internal dalam organisasi) tidak memiliki batasan jumlah perangkat, tetapi memerlukan langganan aktif Apple Developer Enterprise Program dengan biaya $299 per tahun.

Siklus hidup profil

Masa berlaku Provisioning Profile adalah satu tahun sejak dibuat. 30 hari sebelum kedaluwarsa, Apple mulai mengirim notifikasi push kepada pengembang melalui Xcode dan Developer Portal. Jika profil kedaluwarsa, aplikasi di perangkat tetap berfungsi (jika sudah terpasang), tetapi build baru dengan profil ini tidak dapat diinstal. Xcode saat mencoba build dengan profil yang kedaluwarsa akan menampilkan error penandatanganan kode dengan kode -402620394. Apple merekomendasikan mengatur perpanjangan otomatis profil melalui Xcode Accounts Preferences — dengan begitu Xcode memperbarui profil 24 jam sebelum kedaluwarsa.

Jenis Provisioning Profile

Apple menyediakan empat jenis utama Provisioning Profile, masing-masing dirancang untuk tahap tertentu dalam siklus hidup aplikasi. Profil Development memungkinkan menjalankan aplikasi di perangkat fisik yang ditambahkan ke Apple Developer Portal dan digunakan pada tahap pengembangan dan pengujian QA. Untuk membuat profil Development, akun pengembang gratis Apple sudah cukup.

Profil Ad Hoc dirancang untuk mendistribusikan aplikasi kepada kalangan terbatas penguji tanpa menggunakan App Store. Profil mendaftarkan hingga 100 perangkat berdasarkan UDID, dan aplikasi dapat diinstal langsung melalui iTunes, Apple Configurator, atau solusi MDM. Build Ad Hoc memiliki masa berlaku 12 bulan dan tidak memerlukan tinjauan Apple.

Profil App Store digunakan khusus untuk mempublikasikan aplikasi di App Store dan tidak berisi daftar perangkat — Apple sendiri yang mengelola distribusi setelah build disetujui. Saat mengunggah arsip ke App Store Connect, Xcode otomatis menggunakan profil App Store jika terpasang di sistem. Profil Enterprise dirancang untuk organisasi dengan Apple Developer Enterprise Program dan memungkinkan distribusi aplikasi di dalam perusahaan tanpa batasan jumlah perangkat dan tanpa tinjauan Apple.

Struktur Provisioning Profile

Provisioning Profile adalah file berformat DER yang ditandatangani oleh Apple, yang isinya dapat dilihat melalui baris perintah. Security framework macOS memungkinkan mendekode .mobileprovision menjadi plist XML yang dapat dibaca. Di dalam profil terdapat: UUID profil, App ID (prefiks tim + Bundle Identifier), daftar sertifikat, daftar perangkat yang diizinkan (khusus Development dan Ad Hoc), entitlements, dan masa berlaku.

App ID — identifikasi unik aplikasi yang terdiri dari Team ID (10 karakter yang diberikan oleh Apple) dan Bundle Identifier (misalnya, com.example.myapp). App ID dapat bersifat explicit (cocok persis dengan Bundle Identifier) atau wildcard (pola *.example.com untuk beberapa aplikasi). Apple tidak merekomendasikan penggunaan wildcard untuk aplikasi yang menggunakan notifikasi Push atau iCloud — layanan ini memerlukan App ID eksplisit.

Entitlements — blok XML di dalam profil yang menentukan hak akses aplikasi ke sumber daya sistem. Entitlements umum meliputi: aps-environment (notifikasi Push), com.apple.developer.icloud-services (iCloud), com.apple.security.application-groups (App Groups untuk Widget dan Share Extension). Apple otomatis menambahkan entitlements ke profil berdasarkan Capabilities yang diaktifkan di Xcode. Ketidakcocokan apa pun antara entitlements di profil dan yang diminta dalam kode menyebabkan error penandatanganan.

Membuat Provisioning Profile di Apple Developer

Pembuatan profil dapat dilakukan dengan dua cara: melalui antarmuka web Apple Developer Portal atau otomatis melalui Xcode. Untuk proyek umum, Xcode mengelola profil secara otomatis saat opsi Automatically manage signing diaktifkan. Xcode membuat sertifikat, profil, dan App ID dalam hitungan detik, tersinkronisasi dengan Apple Developer Portal. Namun, untuk pipeline CI/CD diperlukan pengelolaan manual.

Untuk membuat profil secara manual di Apple Developer Portal, perlu: masuk ke bagian Certificates, Identifiers & Profiles, pilih Profiles, dan klik "+". Kemudian pilih jenis profil (Development, Ad Hoc, App Store, atau Enterprise), pilih App ID dari daftar terdaftar, pilih sertifikat pengembang, dan (untuk Development dan Ad Hoc) pilih perangkat. Setelah dibuat, profil diunduh dalam format .mobileprovision dan diinstal dengan klik dua kali di Xcode.

Server CI/CD memerlukan pendekatan khusus: profil dan sertifikat harus disimpan di repositori yang aman (misalnya, di secret GitHub Actions). Saat build, profil dimuat ke agen, ditempatkan di folder ~/Library/MobileDevice/Provisioning Profiles, dan sertifikat diimpor ke keychain. Fastlane — alat populer untuk mengotomatiskan penandatanganan — menyediakan perintah match yang menyinkronkan profil dan sertifikat antar pengembang melalui repositori git terenkripsi.

Contoh: memeriksa profil melalui baris perintah

Untuk mendiagnosis masalah penandatanganan kode, Anda dapat mendekode .mobileprovision dan memeriksa isinya. Perintah di bawah ini mengekstrak plist XML dari profil dan menyimpannya dalam format yang dapat dibaca:

# Mendekode .mobileprovision menjadi XML
security cms -D -i "path/to/embedded.mobileprovision" \
  -o "profile.plist"

# Memeriksa masa berlaku profil
plist -convert xml1 profile.plist -o -
grep -A 1 "ExpirationDate" profile.plist

Utilitas Security dari macOS Command Line Tools mendekode file CMS bertanda tangan milik profil. Bendera -D berarti mendekode, -i — file masukan. Setelah didekode, utilitas plist mengonversi plist biner menjadi XML, dan grep mengekstrak tanggal kedaluwarsa. Metode ini berguna di CI/CD untuk memastikan profil tidak kedaluwarsa sebelum build rilis dibuat.

Kesalahan umum dengan Provisioning Profile

Kesalahan paling umum adalah "No matching provisioning profiles found" saat build di Xcode. Kesalahan ini muncul ketika Xcode tidak dapat menemukan profil yang sesuai dengan konfigurasi build: Bundle Identifier tidak cocok dengan App ID di profil, sertifikat tidak terpasang di keychain, atau profil kedaluwarsa. Solusinya — periksa pengaturan Signing & Capabilities di target dan jika perlu alihkan ke Automatically manage signing.

Kesalahan "Provisioning profile doesn't include the selected device" muncul saat mencoba menjalankan build Development atau Ad Hoc di perangkat yang UDID-nya belum ditambahkan ke profil. Apple Developer Portal memungkinkan menambahkan perangkat ke profil yang ada — setelah itu profil perlu diunduh ulang dan diinstal kembali. Xcode dengan manajemen penandatanganan otomatis akan menambahkan perangkat yang terhubung ke profil secara otomatis.

Masalah dengan entitlements muncul melalui error "The executable was signed with invalid entitlements" saat mengunggah ke App Store Connect. Penyebabnya — ketidakcocokan entitlements di profil dengan file .entitlements proyek. Apple mengharuskan set hak di profil menjadi superset dari hak yang diminta aplikasi. Solusinya — periksa Capabilities di target Xcode dan pastikan semua layanan yang diaktifkan memiliki entitlements yang sesuai di profil. Fastlane menyertakan perintah produce yang menyinkronkan App ID dan profil dengan entitlements terbaru.