Entitlements dalam pengembangan iOS: apa itu, jenis apa saja dan cara konfigurasinya

Apa itu Entitlements?

Entitlements (diterjemahkan dari bahasa Inggris — "hak") — adalah pasangan kunci-nilai yang disertakan dalam tanda tangan kode aplikasi pada tahap pembangunan dan menentukan fungsi serta data sistem apa yang dapat diakses aplikasi. Entitlements telah tertanam dalam model keamanan Apple sejak kemunculan iOS SDK dan wajib untuk semua aplikasi yang didistribusikan melalui App Store.

Konsep Entitlements berbeda dari izin tradisional (permissions) di Android. Jika izin Android diminta dari pengguna saat pertama kali menggunakan fitur, Entitlements di iOS diperiksa oleh sistem saat startup aplikasi berdasarkan tanda tangan digital. Pengguna tidak dapat mencabut atau mengubah entitlement — hak ini diberikan kepada pengembang melalui App Store Connect dan ditetapkan dalam profil penandatanganan.

Setiap entitlement memiliki tujuan dan format yang ditentukan secara ketat. Misalnya, com.apple.security.application-groups mengizinkan akses ke wadah bersama untuk kumpulan aplikasi dari pengembang yang sama, dan aps-environment mengaktifkan dukungan untuk Pemberitahuan Push. Apple meninjau permintaan entitlement secara manual dalam proses App Review, yang mencegah penyalahgunaan hak.

Jenis Entitlements di iOS

Entitlements diklasifikasikan berdasarkan tujuan fungsional ke dalam beberapa kategori. Layanan Sistem — iCloud, Push Notifications, Siri. Keamanan dan Data — Keychain Access Groups, App Groups, Data Protection. Jaringan dan Komunikasi — Multipath TCP, VPN, Hotspot Configuration. Kemampuan Perangkat Keras — Camera, Microphone, Bluetooth (melalui capabilities terkait).

Capabilities dan Entitlements Layanan

Xcode mengelompokkan entitlements terkait ke dalam Capabilities — sakelar tingkat tinggi di tab Signing & Capabilities. Mengaktifkan Capability secara otomatis menambahkan entitlements yang diperlukan ke file .entitlements. Misalnya, mengaktifkan Capability Push Notifications menambahkan entitlement aps-environment dengan nilai development atau production, dan mengaktifkan iCloud menambahkan kumpulan entitlements untuk CloudKit dan Key-Value storage.

Beberapa capabilities memerlukan konfigurasi tambahan di portal Apple Developer. Misalnya, untuk App Groups perlu mendaftarkan ID grup di portal, setelah itu tersedia untuk dipilih di Xcode. Untuk Push Notifications perlu menghasilkan kunci APNs atau sertifikat. Tanpa langkah awal ini, entitlement tidak akan berfungsi meskipun dengan file .entitlements yang benar.

App Groups dan Keychain Access

Entitlement com.apple.security.application-groups memungkinkan beberapa aplikasi dari pengembang yang sama memiliki wadah bersama di sistem file. Ini digunakan untuk berbagi data antara aplikasi utama dan ekstensi (Widget, Watch App, Share Extension). Semua aplikasi dari satu grup dapat membaca dan menulis file di direktori bersama /Library/Group Containers/.

Keychain Access Groups (kunci keychain-access-groups) — entitlement penting lainnya yang memungkinkan aplikasi dari satu grup memiliki akses bersama ke elemen Keychain. Ini sangat penting untuk implementasi autentikasi terpadu: pengguna masuk di satu aplikasi dan secara otomatis mendapatkan akses ke akun yang sama di aplikasi lain tanpa memasukkan ulang kata sandi.

Cara Konfigurasi Entitlements

Konfigurasi Entitlements dilakukan di Xcode pada tab Signing & Capabilities di pengaturan target. Pengembang memilih Capabilities yang diperlukan dari daftar, dan Xcode secara otomatis membuat atau memperbarui file .entitlements. File ini disimpan di proyek dalam format XML dengan struktur plist dan berisi semua kunci entitlements untuk target ini.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>com.apple.security.application-groups</key>
    <array>
        <string>group.com.example.shared</string>
    </array>
    <key>aps-environment</key>
    <string>development</string>
    <key>keychain-access-groups</key>
    <array>
        <string>$(AppIdentifierPrefix)com.example.keychain</string>
    </array>
</dict>
</plist>

Saat membuat file entitlement secara manual, penting untuk mematuhi format kunci dan prefiks. Entitlements Apple menggunakan gaya domain terbalik (com.apple.*). Entitlements kustom untuk keperluan sendiri juga dimungkinkan, tetapi harus didaftarkan di portal pengembang. Xcode menyediakan pelengkapan otomatis untuk semua kunci entitlement standar.

Untuk men-debug Entitlements, gunakan perintah codesign di terminal macOS. Perintah codesign -d --entitlements :- <path_ke_aplikasi> menampilkan semua entitlements yang digunakan untuk menandatangani aplikasi. Ini berguna untuk mendiagnosis masalah: jika entitlement tidak ada dalam output, aplikasi tidak akan mendapatkan akses ke fungsi terkait terlepas dari pengaturan di Xcode.

Membuat file entitlement secara manual

Meskipun Xcode menghasilkan file entitlement secara otomatis saat mengaktifkan Capabilities, pengembang berpengalaman sering membuat atau mengeditnya secara manual untuk penyesuaian yang lebih presisi. File ini memiliki ekstensi .entitlements dan format plist (XML). Di dalamnya dapat ditambahkan kunci entitlement kustom yang tidak tersedia di antarmuka Xcode, atau menggabungkan entitlements dari berbagai capabilities dalam satu file.

Saat mengedit secara manual, penting untuk memantau kebenaran sintaksis XML. Kesalahan dalam struktur plist akan menyebabkan entitlements tidak diterapkan saat penandatanganan. Xcode memeriksa file .entitlements pada tahap kompilasi dan menampilkan kesalahan jika format tidak benar. Untuk proyek kompleks dengan banyak target dan ekstensi, disarankan untuk menyimpan kunci entitlement bersama di file terpisah dan mengimpornya melalui Build Settings.

// cli: memeriksa entitlements aplikasi yang terinstal
codesign -d --entitlements :- /Applications/Safari.app

// Contoh keluaran berisi daftar entitlements aktif
<dict>
    <key>com.apple.security.ts.apple-wifi</key>
    <true/>
    <key>com.apple.security.network.client</key>
    <true/>
</dict>

Entitlements dan Keamanan Aplikasi

Entitlements memainkan peran kunci dalam model keamanan Apple. Karena entitlements adalah bagian dari tanda tangan digital aplikasi, pemalsuannya tidak mungkin dilakukan tanpa menandatangani ulang kode. Apple memeriksa entitlements di beberapa tingkat: saat pembangunan, Xcode menandatangani entitlements bersama file yang dapat dieksekusi; saat instalasi, sistem memeriksa integritas tanda tangan; saat startup, memverifikasi entitlements kembali.

Salah satu persyaratan keamanan penting adalah prinsip entitlement minimal. Pengembang harus hanya mengaktifkan entitlements yang benar-benar digunakan dalam aplikasi. Entitlements berlebihan meningkatkan permukaan serangan dan dapat menyebabkan penolakan aplikasi di App Review. Apple secara eksplisit memeriksa kesesuaian entitlements dengan fungsionalitas aplikasi.

Beberapa entitlements dianggap sensitif (sensitive) dan memerlukan persetujuan tambahan dari Apple. Ini termasuk: com.apple.developer.healthkit (HealthKit), com.apple.developer.passkit (Wallet), com.apple.developer.authentication-services.authentication (Sign in with Apple) dan com.apple.developer.nfc.readersession.formats (NFC). Untuk mendapatkan entitlements ini, perlu menjelaskan kebutuhannya dalam proses App Review.

Saat bekerja dengan entitlements, penting untuk mempertimbangkan perbedaan antara iOS dan macOS. Aplikasi desktop macOS (Sandboxed) memiliki kumpulan entitlements yang lebih luas dibandingkan iOS. Misalnya, entitlement com.apple.security.temporary-exception.* memungkinkan untuk sementara melewati sandbox untuk operasi tertentu — di iOS, entitlements semacam itu tidak ada sama sekali.

Entitlements dan Provisioning Profile

Entitlements terkait erat dengan profil penandatanganan (Provisioning Profiles). Profil penandatanganan adalah file yang menghubungkan sertifikat pengembang, daftar perangkat yang diizinkan, dan kumpulan entitlements untuk aplikasi tertentu. Saat instalasi aplikasi, sistem membandingkan entitlements dalam kode dengan entitlements dalam profil penandatanganan. Jika entitlement ada dalam kode tetapi tidak ada dalam profil, aplikasi tidak akan mendapatkan akses ke fungsi terkait.

Untuk mendiagnosis masalah dengan entitlements, pertama-tama periksa profil penandatanganan. Xcode secara otomatis menghasilkan profil berdasarkan capability yang dipilih di portal Apple Developer. Jika capability ditambahkan di Xcode tetapi tidak aktif di portal, aplikasi akan crash dengan kesalahan penandatanganan saat mencoba menggunakan fungsi yang dilindungi.