Mengatasi Error AADSTS900144 Missing Parameter di Azure AD

By Mirko Peters · 2026-04-21

Tidak ada yang suka terbentur tembok saat menghadapi error autentikasi, tetapi error AADSTS900144 missing parameter di Azure AD adalah salah satu hambatan klasik yang membuat frustrasi, mulai dari pengembang aplikasi hingga admin TI. Artikel ini menjelaskan secara jelas apa penyebab error tersebut, apa yang perlu diperiksa lebih dulu, dan langkah-langkah agar pengguna bisa kembali masuk. Kita akan

Automatically translated with AI from the original post. Read the English original

Tidak ada yang suka terbentur tembok saat menghadapi error autentikasi, tetapi error AADSTS900144 missing parameter di Azure AD adalah salah satu hambatan klasik yang membuat frustrasi, mulai dari pengembang aplikasi hingga admin TI. Artikel ini menjelaskan secara jelas apa penyebab error tersebut, apa yang perlu diperiksa lebih dulu, dan langkah-langkah agar pengguna bisa kembali masuk. Kita akan membahas penyebabnya dan solusinya, mulai dari kesalahan parameter yang umum hingga alur OAuth dan integrasi aplikasi cloud secara mendalam.

Apa pun solusi Microsoft 365, Azure, Power Platform, atau layanan lain yang terhubung ke Entra ID yang Anda dukung, Anda akan menemukan tips untuk perbaikan di sisi klien maupun server. Troubleshooting berbasis kasus nyata, praktik terbaik yang siap untuk perusahaan, serta tautan tambahan ke konten tata kelola cloud tersedia di sini untuk membantu Anda mencegah masalah serupa saat error ini muncul kembali.

Mengapa “AADSTS900144” Muncul dalam Autentikasi Azure AD?

Error “AADSTS900144: Request body must contain the following parameter” muncul saat detail penting tidak ada dalam permintaan autentikasi yang dikirim ke Azure Active Directory (atau Microsoft Entra ID). Secara sederhana, Azure mencari informasi seperti grant_type atau client_id dalam permintaan token Anda, dan tidak menemukannya. Atau, detailnya memang ada tetapi formatnya salah atau letaknya keliru.

Error ini paling sering terjadi selama alur OAuth 2.0, terutama saat pengguna atau aplikasi mencoba masuk dengan layanan cloud perusahaan. Biasanya, masalahnya ada pada parameter body permintaan yang dikirim saat menukar kode otorisasi dengan token. Jika parameter wajib dihilangkan, salah eja, atau ditempatkan di luar body POST yang diharapkan, Azure AD akan menghentikan proses dan menampilkan kode AADSTS900144.

Anda mungkin menemui error ini saat mengintegrasikan aplikasi bisnis kustom, mendaftarkan aplikasi baru di Azure, atau ketika klien desktop (seperti Microsoft Teams) mengalami kendala autentikasi. Kadang, bahkan salah salin-tempel atau pembaruan singkat pada pendaftaran aplikasi dapat membuat parameter tidak sinkron. Pesan error ini mungkin terlihat membingungkan, tetapi sebenarnya itu cara Azure memberi tahu Anda: “Periksa kembali permintaan Anda dan perbaiki bagian yang hilang.”

Bagi yang bekerja dengan aplikasi multi-penyewa, perlu diingat bahwa ketidaksesuaian konteks penyewa atau endpoint layanan dapat menimbulkan kebingungan serupa, kadang membuat parameter tampak hilang padahal sebenarnya hanya salah arah. Memahami mekanisme ini membuat troubleshooting lebih cepat dan mengurangi tekanan bagi tim dukungan.

Masalah Umum Parameter Body Permintaan dan Solusi Cepat

Error AADSTS900144 hampir selalu berasal dari sesuatu yang terlewat atau diletakkan di tempat yang salah dalam permintaan token Anda. Parameter utama seperti client_id dan grant_type adalah tersangka utama. Jika aplikasi Anda melewatkan satu saja parameter wajib, endpoint token Azure AD akan langsung menolak permintaan tersebut. Pastikan Anda menggunakan metode HTTP POST, karena GET dan kata kerja HTTP lainnya tidak akan berfungsi di sini.

Mulailah dengan memastikan aplikasi Anda mengirim permintaan dengan content type application/x-www-form-urlencoded. Sering kali content type yang keliru membuat Azure AD mencari parameter yang tidak dapat dibacanya. Selanjutnya, buka alat permintaan HTTP apa pun (Postman, curl, atau bahkan Fiddler) dan periksa body mentah. Apakah client_id, grant_type, client_secret, dan lainnya benar-benar ada di payload, bukan sebagai nilai query string atau tersembunyi di header?

Jika Anda mengubah pendaftaran aplikasi, ingat bahwa parameter yang diharapkan dapat berubah tergantung pada grant flow. Misalnya, menggunakan authorization code grant berarti Anda juga harus menyertakan code. Hal ini tidak selalu jelas, jadi selalu periksa silang grant type Anda dengan dokumentasi Azure sebelum menganggap masalah selesai.

Pada aplikasi multi-penyewa, berhati-hatilah saat mengirim permintaan ke endpoint /common ketika penyewa target Anda memerlukan GUID atau nilai tertentu. Jika tidak, “parameter yang hilang” Anda mungkin hanya permintaan yang salah arah. Mengarahkan permintaan ke URL yang keliru, terutama dalam skenario lintas penyewa, dapat menjebak pengembang berpengalaman sekalipun, jadi selalu verifikasi endpoint dan parameter secara bersamaan. Perbaiki keduanya, dan dalam banyak kasus, AADSTS900144 yang menyebalkan itu akan hilang seketika.

Troubleshooting di Sisi Klien: Menghapus Kredensial Cache dan Mereset Aplikasi

Terkadang bukan kode Anda yang bermasalah, melainkan mesin lokal yang mengacaukan alur autentikasi. Kredensial yang tersimpan di cache dan cookie lama dapat menyimpan token yang sudah usang atau merusak data parameter, terutama di aplikasi desktop seperti Microsoft Teams atau Outlook. Ketika itu terjadi, pengguna akan terus mendapatkan pesan AADSTS900144 meskipun masalah di sisi back-end sudah diperbaiki.

Langkah pertama yang paling mudah adalah menghapus kredensial yang tersimpan. Di Windows, gunakan Credential Manager untuk menghapus token yang di-cache dan terkait dengan akun Anda. Di aplikasi web, menghapus cookie dan data situs di browser dapat memulai proses autentikasi ulang yang bersih. Untuk masalah yang membandel, khususnya di Microsoft Teams, coba lakukan reset lokal dengan keluar dari semua sesi, menutup aplikasi, dan menghapus folder cache sebelum memulai ulang. Sebagian pengguna mungkin perlu menghapus profil akun Teams secara paksa dari pengaturan perangkat agar tidak ada jejak yang tersisa, lalu instal ulang Teams dari awal.

Jika Anda membantu pengguna lain, sediakan daftar periksa yang sederhana: hapus kredensial, tutup aplikasi, bersihkan cache, lalu masuk kembali. Cara ini meminimalkan waktu henti dan kebingungan bagi pengguna bisnis yang hanya ingin aplikasinya kembali berfungsi. Tim dukungan TI sebaiknya selalu memastikan bahwa semua data autentikasi lama sudah benar-benar hilang sebelum menelusuri masalah lebih dalam, karena data sisa yang tertinggal merupakan penyebab utama error AADSTS900144 yang terus berulang.

Bagi Anda yang menangani tata kelola Microsoft Teams atau masalah autentikasi yang berulang, perlu disadari bahwa perbaikan teknis saja tidak serta-merta "menyelesaikan" tata kelola. Untuk pembahasan lebih dalam tentang mengapa tata kelola tidak pernah benar-benar selesai dan cara menjalankannya dalam praktik, silakan baca panduan tentang tata kelola Teams dan ilusi kontrol ini, atau pelajari playbook otomatisasi siklus hidup Teams ini untuk strategi praktis.

Praktik Terbaik untuk Mencegah AADSTS900144 pada Aplikasi Perusahaan

Mencegah error AADSTS900144 sebenarnya bergantung pada disiplin dalam permintaan OAuth dan konfigurasi aplikasi. Biasakan untuk memvalidasi semua parameter wajib—terutama client_id dan grant_type—sebelum mengirim permintaan ke endpoint token Azure AD. Pemeriksaan otomatis dalam pipeline deployment Anda dapat menangkap parameter yang hilang atau tidak valid sebelum masuk ke produksi, sehingga menghemat banyak tiket dukungan di kemudian hari.

Gunakan alat pengembang Microsoft Entra ID untuk mensimulasikan permintaan autentikasi dan melihat apa yang dilihat Azure AD. Cara ini membantu menemukan bukan hanya parameter yang hilang, tetapi juga endpoint atau kebijakan yang tidak cocok dan dapat memblokir permintaan valid di penyewa tertentu. Menyiapkan unit test dengan endpoint Entra ID tiruan dapat lebih mengurangi kejutan dengan memunculkan masalah parameter di tahap pengembangan, bukan saat peluncuran.

Untuk organisasi dengan tata kelola yang ketat atau banyak tim pengembang, integrasikan validasi Anda ke dalam praktik infrastructure-as-code. Gunakan pemeriksaan skema pada templat deployment ARM atau Bicep untuk memastikan seluruh parameter OAuth yang wajib disertakan saat pendaftaran aplikasi. Hal ini memperkecil risiko drift dan kesalahan konfigurasi, terutama seiring aplikasi berkembang.

Untuk pendekatan yang berfokus pada keamanan, perhatikan dengan saksama hibah persetujuan OAuth dan penegakan kebijakan. Penyerang senang mengeksploitasi pengaturan persetujuan yang longgar, sehingga kunci persetujuan pengguna, wajibkan penerbit yang disetujui, dan terapkan alur kerja admin. Untuk pengantar yang solid mengenai ancaman ini dan tips mitigasinya, baca analisis serangan persetujuan OAuth Entra ID ini. Jika Anda sedang menyempurnakan proses tata kelola, ada manfaatnya menggunakan otomatisasi, RBAC, dan Azure Policy—lihat panduan strategi untuk tata kelola perusahaan Azure ini untuk wawasan desain dan kontrol yang dapat ditindaklanjuti.