Service Principal di Entra ID: Praktik Terbaik dan Masalah yang Sering Terjadi
By Mirko Peters ·
Apa itu service principal, bagaimana bedanya dengan app registration, dan praktik keamanan yang didokumentasikan Microsoft: managed identity, sertifikat, least privilege, owner, serta jebakan yang sudah diketahui.
Automatically translated with AI from the original post. Read the English original
Service principal adalah identitas yang digunakan aplikasi di dalam satu penyewa Microsoft Entra. Identitas ini menentukan apa saja yang dapat diakses aplikasi di penyewa tersebut. Praktik keamanan yang didokumentasikan Microsoft cukup singkat: utamakan managed identity, hindari secret, berikan least privilege, batasi jumlah owner, dan tinjau semuanya secara berkala.
Poin Penting
- Application object adalah cetak biru global di penyewa asal. Service principal adalah instance lokal di setiap penyewa yang menentukan apa yang dapat dilakukan aplikasi di penyewa tersebut.
- Microsoft mengurutkan kredensial dari yang paling diutamakan hingga yang paling kurang diutamakan: managed identity, federated credential, sertifikat. Microsoft menyatakan agar Anda tidak menggunakan secret (password).
- Minta hanya izin dengan hak akses paling terbatas, utamakan akses delegated daripada akses app-only, dan hapus izin yang sudah tidak dibutuhkan aplikasi.
- Batasi owner pada kumpulan minimal, tinjau daftar owner setiap beberapa bulan, dan pastikan setiap service principal memiliki minimal dua owner.
- Aplikasi dan service principal yang dihapus dapat dipulihkan hingga 30 hari. Pengguna non-admin hanya dapat membuat paling banyak 250 objek aplikasi dan service principal, termasuk yang sudah dihapus.
Artikel ini mengikuti halaman Microsoft Learn tentang application object dan service principal object, keamanan app registration, serta menghapus dan memulihkan aplikasi. Jika halaman-halaman tersebut tidak sejalan atau tidak membahas suatu hal, hal itu dinyatakan secara eksplisit.
Application object dibandingkan dengan service principal
Microsoft menjelaskan dua objek:
- Application object. Representasi global dari aplikasi. Objek ini berada di penyewa tempat aplikasi didaftarkan, yang disebut penyewa asal. Objek ini berfungsi seperti templat bagi service principal yang dibuat darinya.
- Service principal. Representasi lokal aplikasi di satu penyewa. Ini adalah security principal yang menentukan kebijakan akses dan izin aplikasi di penyewa tersebut.
Aplikasi single-tenant memiliki satu service principal, yaitu di penyewa asalnya. Aplikasi multitenant memiliki satu service principal di penyewa asal ditambah satu di setiap penyewa tempat seseorang memberikan persetujuan. Mendaftarkan aplikasi di portal akan membuat kedua objek tersebut. Jika Anda mendaftarkan melalui Microsoft Graph, pembuatan service principal merupakan langkah terpisah.
Perubahan pada application object hanya tercermin pada service principal-nya di penyewa asal. Perubahan tersebut tidak diteruskan ke service principal di penyewa lain.
Tiga jenis service principal
| Jenis | Objek aplikasi tertaut | Bisakah Anda mengeditnya? | |---|---|---| | Application | Ya | Diatur oleh objek aplikasi, dengan pengaturan khusus penyewa | | Managed identity | Tidak | Dapat diberi akses, tetapi tidak dapat diubah secara langsung | | Legacy | Tidak | Memiliki properti yang dapat diedit, seperti kredensial dan URL balasan |
Legacy service principal hanya digunakan di penyewa tempat mereka dibuat. Di Microsoft Graph, jenisnya muncul sebagai properti servicePrincipalType. Referensinya mencantumkan lebih banyak nilai daripada ketiga nilai ini, termasuk ServiceIdentity (identitas agen) dan SocialIdp (untuk penggunaan internal). Microsoft Graph mendokumentasikan bahwa service principal Application yang registrasi aplikasinya tidak ada tidak akan menerima token yang diterbitkan.
Buat satu dengan cara yang didokumentasikan
- Masuk ke Microsoft Entra admin center sebagai Cloud Application Administrator, minimal.
- Buka Entra ID > App registrations lalu pilih New registration.
- Masukkan nama dan pilih Accounts in this organizational directory only jika aplikasinya single tenant.
- Pilih Register. Service principal dibuat secara otomatis.
Untuk mengelola izin, persetujuan, dan informasi masuk setelahnya, gunakan Enterprise applications. Untuk akses Azure, halaman yang sama menjelaskan penetapan peran pada cakupan langganan, grup sumber daya, atau sumber daya, dengan izin yang diwarisi oleh cakupan yang lebih rendah. Memilih cakupan paling sempit yang masih berfungsi adalah praktik umum least privilege, bukan persyaratan yang dinyatakan di halaman tersebut.
Praktik terbaik dari Microsoft
Pilih jenis identitas yang tepat
Pertimbangkan managed identity sebagai pengganti app registration jika layanan berjalan di Azure, tidak melakukan sign-in pengguna, bukan web API, dan tidak memerlukan banyak penyewa.
Urutkan kredensial Anda
Microsoft mencantumkan opsi dari yang paling disukai hingga yang paling tidak disukai. Halaman tersebut tidak menyebutnya sebagai peringkat resmi:
- Managed identity sebagai kredensial. Microsoft menyebutnya sangat direkomendasikan karena tidak memerlukan pengelolaan kredensial.
- Federated credential dari platform yang Anda percaya. Microsoft menyarankan kehati-hatian dan meminta agar federated credential hanya dikonfigurasi dari platform yang tepercaya.
- Sertifikat. Simpan di key vault seperti Azure Key Vault dan utamakan sertifikat dari otoritas sertifikat tepercaya.
- Secret. Halaman tersebut menyatakan: "Jangan gunakan password credential."
Aturan terkait dari halaman yang sama: gunakan kebijakan manajemen aplikasi untuk membatasi masa berlaku secret atau memblokir secret, jangan letakkan kredensial pada klien publik atau klien yang diinstal, perbarui kredensial secara rutin, jangan pernah membagikan kredensial antar-aplikasi, dan hindari banyak kredensial pada satu aplikasi. Halaman ini juga merekomendasikan pemindai kredensial di pipeline build agar kredensial tidak berakhir di repositori. Halaman tersebut tidak memberikan interval rotasi yang pasti.
Kendalikan redirect URI
Pastikan Anda memiliki setiap redirect URI, pantau catatan DNS di baliknya, hindari wildcard dan skema tidak aman seperti http, serta pangkas daftarnya. Halaman tersebut menyatakan bahwa kelalaian dalam kepemilikan satu URI dapat menyebabkan kompromi aplikasi.
Batasi izin
Minta hanya izin paling tidak permisif, tinjau izin secara berkala, dan hapus izin yang tidak lagi dibutuhkan aplikasi. Utamakan akses delegated dibanding akses app-only bila memungkinkan.
Kunci instance dan batasi pemilik
Admin penyewa dapat menyesuaikan service principal di penyewa mana pun, yang dapat menambahkan perubahan tak terduga seperti kredensial yang seharusnya dikontrol oleh pemilik aplikasi. Microsoft merekomendasikan untuk mengonfigurasi app instance property lock dan mengunci setiap properti sensitif yang tersedia. Hal ini sangat penting terutama untuk aplikasi multitenant.
Batasi kepemilikan aplikasi pada sekelompok kecil orang. Administrator sebaiknya meninjau daftar pemilik beberapa bulan sekali. Microsoft Entra access reviews dapat mengotomatiskan proses ini. Referensi Microsoft Graph menambahkan rekomendasi minimal dua pemilik per service principal.
Gunakan identifier URI dengan benar
Untuk aplikasi yang menerima token v1.0, gunakan hanya URI default, api://<appId> dan api://<tenantId>/<appId>. Untuk token v2.0, format api://<appId> direkomendasikan. Nilainya harus unik di penyewa dan tidak boleh diakhiri dengan garis miring. Resource app dengan identifier URI kustom sebaiknya menggunakan format access token v2.0.
Masalah umum dan yang dikatakan dokumentasi
Sign-in sulit dilacak. Entra memiliki log sign-in terpisah untuk service principal dan managed identity, di luar sign-in pengguna. Buka Microsoft Entra admin center minimal sebagai Reports Reader, lalu buka Entra ID > Monitoring & health > Sign-in logs. Halaman yang saya baca tidak menyebutkan tab mana yang menampilkan sign-in service principal.
Aplikasi berhenti mendapatkan token. Pastikan registrasi aplikasi masih ada. Periksa juga properti accountEnabled dan appRoleAssignmentRequired pada service principal. Jika accountEnabled bernilai false, tidak ada pengguna yang dapat sign-in, meskipun sudah ditetapkan. Jika appRoleAssignmentRequired bernilai true, penetapan app role harus dilakukan lebih dahulu.
Error kuota saat pembuatan. Pengguna non-admin tidak dapat membuat lebih dari 250 aplikasi dan service principal secara gabungan. Objek aktif maupun objek yang dihapus namun masih dapat dipulihkan sama-sama dihitung, dan kuota hanya bebas jika Anda menghapusnya secara permanen dari kontainer item yang dihapus.
Pemulihan tidak mengembalikan semuanya. Microsoft Learn memberikan dua pernyataan. Halaman objek aplikasi menyatakan bahwa memulihkan objek aplikasi di UI App registrations tidak memulihkan service principal-nya. FAQ hapus dan pulihkan menyatakan bahwa jika keduanya dihapus, memulihkan registrasi juga memulihkan service principal. Periksa hasilnya setelah setiap pemulihan. FAQ tersebut juga menyatakan bahwa kebijakan service principal tidak dapat dipulihkan dan harus dikonfigurasi ulang, serta data provisioning dapat membutuhkan waktu 40 menit hingga 1 hari untuk muncul kembali.
Anda perlu menjeda aplikasi, bukan menghapusnya. Microsoft Learn menjelaskan proses menonaktifkan aplikasi. Langkah ini menghentikan penerbitan token baru dan mempertahankan objek untuk investigasi atau pengaktifan kembali di kemudian hari.
Rutinitas tinjauan singkat
- Daftarkan aplikasi yang menggunakan secret, lalu pindahkan ke sertifikat atau managed identity.
- Hapus izin yang tidak digunakan siapa pun.
- Periksa owner dan tanggal kedaluwarsa.
- Pastikan domain redirect URI masih milik Anda.
- Tinjau log sign-in service principal untuk mengidentifikasi aplikasi yang tidak lagi digunakan.
Terkait
Sumber
- Microsoft Learn: Praktik terbaik keamanan untuk properti aplikasi di Microsoft Entra ID
- Microsoft Learn: Objek aplikasi dan perwakilan layanan di Microsoft Entra ID
- Microsoft Learn: Mendaftarkan aplikasi Microsoft Entra dan membuat perwakilan layanan
- Microsoft Learn: Menghapus dan memulihkan aplikasi dan perwakilan layanan
- Microsoft Learn: servicePrincipal resource type (Microsoft Graph)
- Microsoft Learn: Log masuk di Microsoft Entra ID
FAQ
Apa perbedaan antara app registration dan service principal?
Menurut Microsoft Learn, application object (app registration) adalah representasi global dari sebuah aplikasi dan berada di penyewa asalnya. Service principal adalah representasi lokal di penyewa tertentu dan menentukan kebijakan akses serta izin di penyewa tersebut. Mendaftarkan aplikasi di portal akan membuat kedua objek itu di penyewa asal.
Sebaiknya saya menggunakan client secret atau sertifikat untuk service principal?
Panduan keamanan Microsoft menempatkan managed identity sebagai pilihan yang sangat direkomendasikan, lalu federated credential hanya dari platform yang Anda percayai, dan terakhir kredensial sertifikat jika kedua opsi itu tidak memungkinkan. Panduan tersebut juga menyatakan agar Anda tidak menggunakan password credential, yang disebut juga secret.
Kapan saya sebaiknya menggunakan managed identity alih-alih service principal?
Microsoft Learn menyebutkan empat kondisi: layanan berjalan di Azure, layanan tidak melakukan sign-in pengguna, layanan tidak bertindak sebagai resource web API, dan layanan tidak perlu berjalan di banyak penyewa. Jika keempatnya terpenuhi, pertimbangkan managed identity. Managed identity sendiri merupakan jenis service principal yang tidak bisa Anda ubah secara langsung.
Bisakah saya memulihkan service principal yang sudah dihapus?
Menurut FAQ hapus dan pulihkan di Microsoft Learn, aplikasi dan service principal yang dihapus sementara dapat dipulihkan hingga 30 hari, setelah itu dihapus permanen. Application registration dipulihkan melalui Microsoft Entra admin center. Service principal dipulihkan menggunakan PowerShell atau Microsoft Graph, karena service principal yang dihapus tidak ditampilkan di admin center.
Mengapa saya mendapatkan error Directory_QuotaExceeded saat membuat aplikasi?
FAQ Learn menyebutkan bahwa pengguna non-admin hanya dapat membuat paling banyak 250 aplikasi dan service principal, dan objek yang aktif maupun yang dihapus namun masih dapat dipulihkan dihitung dalam kuota tersebut. Menghapus objek saja tidak otomatis membebaskan kuota. Anda harus menghapusnya secara permanen dari kontainer item yang dihapus.