Memahami Galat AADSTS50011 Redirect URI Mismatch
By Mirko Peters · · Updated
AADSTS50011 redirect URI mismatch berarti redirect URI yang dikirim oleh aplikasi tidak sama persis dengan URI yang terdaftar di Microsoft Entra ID. Bandingkan permintaan aplikasi dengan redirect URI yang terdaftar, termasuk skema, nama host, path, port, dan garis miring di akhir. Perbaiki aplikasi atau pendaftarannya, lalu uji ulang alur sign-in yang dimaksud.
Automatically translated with AI from the original post. Read the English original

AADSTS50011 redirect URI mismatch berarti redirect URI yang dikirim oleh aplikasi tidak sama persis dengan URI yang terdaftar di Microsoft Entra ID. Bandingkan permintaan aplikasi dengan redirect URI yang terdaftar, termasuk skema, nama host, path, port, dan garis miring di akhir. Perbaiki aplikasi atau pendaftarannya, lalu uji ulang alur sign-in yang dimaksud.
Memperbaiki AADSTS50011 redirect URI mismatch
- Salin redirect URI dari galat atau permintaan sign-in.
- Bandingkan secara persis dengan pendaftaran aplikasi di Entra.
- Perbaiki URI yang disetujui dan uji ulang di lingkungan yang sesuai.
Lihat Microsoft Learn untuk Entra.
Jika Anda pernah mencoba menyiapkan autentikasi Microsoft dan terhambat di tengah jalan, besar kemungkinan galat AADSTS50011 redirect URI mismatch muncul begitu saja seperti tamu yang tidak diundang. Galat ini terkenal di kalangan developer dan admin yang bekerja dengan Microsoft Entra ID (sebelumnya Azure Active Directory), Microsoft 365, serta integrasi di Azure atau Power Platform.
Mengapa ini penting? Gangguan ini dapat menghentikan alur login secara mendadak, membuat pengguna tidak bisa masuk dan aplikasi terhenti di luar. Redirect URI mismatch adalah jebakan umum yang sering menghambat proyek baru maupun perubahan pada pengaturan yang sudah ada. Memahami apa yang memicu AADSTS50011 dan cara memperbaikinya tidak hanya menjaga aplikasi Anda tetap berjalan lancar, tetapi juga sangat penting untuk mengamankan autentikasi dan otorisasi di platform Microsoft.
Dalam panduan ini, Anda akan melihat penyebab galat, cara mengenali gejalanya, serta tips praktis untuk menemukan dan memperbaiki redirect URI yang tidak cocok. Meskipun baru mengenal autentikasi Microsoft, Anda akan siap melakukan troubleshooting dan mengamankan alur sign-in dengan cara yang benar.
Apa Penyebab Galat AADSTS50011?
Akar penyebab galat AADSTS50011 adalah ketidakcocokan antara redirect URI yang digunakan aplikasi Anda dan daftar URI yang terdaftar di Microsoft Entra ID. Saat seseorang mencoba sign-in, sistem autentikasi Microsoft memeriksa apakah redirect URI yang dikirim dalam permintaan OAuth atau OpenID Connect sama persis dengan salah satu URI yang tercatat untuk pendaftaran aplikasi.
Pemeriksaan ketat ini mencegah endpoint yang tidak sah menyadap token pengguna, yang merupakan fondasi perlindungan identitas modern. Jika ada perbedaan sekecil apa pun, misalnya garis miring yang terselip, protokol yang salah (seperti http alih-alih https), atau salah ketik, Entra ID langsung memblokir sign-in dan menampilkan galat AADSTS50011. Dengan memahami pengamanan ini, Anda tidak hanya dapat menyelesaikan galat lebih cepat, tetapi juga menghindari salah konfigurasi yang berisiko di kemudian hari.
Gejala Masalah dan Pesan Galat yang Perlu Diwaspadai
- Galat di Layar Sign-In Microsoft: Pengguna melihat pesan tebal “AADSTS50011: The reply URL specified in the request does not match...” setelah mencoba login. Pesan ini sering muncul di halaman sign-in Microsoft dan menghentikan autentikasi seketika.
- Kode Galat OAuth pada Panggilan API: Aplikasi yang terintegrasi dengan API Microsoft menerima objek galat yang berisi “error=invalid_request” atau “error=AADSTS50011” dalam respons API atau redirect, yang menandakan adanya ketidakcocokan di balik layar.
- Log Kegagalan Autentikasi: Di log Azure atau Entra ID, admin melihat percobaan login yang gagal dengan penyebutan eksplisit tentang redirect URI mismatch, sering kali dengan detail URI yang diharapkan dibandingkan URI yang sebenarnya.
- Kegagalan Login Aplikasi Web: Pengguna akhir mungkin melaporkan login yang berputar-putar, layar kosong, atau tiba-tiba kembali ke halaman utama, terutama segera setelah diarahkan ke atau dari login Microsoft.
- Galat Sistem Backend: Platform otomatis (seperti pemroses email atau tugas terjadwal) mungkin mencatat atau menampilkan kode AADSTS50011, terutama saat mencoba alur OAuth dari lingkungan yang berbeda (dev, staging, production).
Memperbaiki Redirect URI untuk Mengatasi AADSTS50011
Kabar baiknya, mengatasi AADSTS50011 biasanya soal investigasi dan pengecekan ulang yang teliti—tidak perlu trik khusus. Secara garis besar, Anda perlu menyelaraskan redirect URI yang digunakan aplikasi Anda agar persis sama dengan yang terdaftar di Azure portal pada registrasi aplikasi Anda. Perbedaan kecil pada protokol, ejaan, atau garis miring dapat menyebabkan ketidakcocokan, jadi ketelitian adalah kunci utamanya.
Memperbaiki masalah ini bukan hanya soal menghentikan error. Menjaga redirect URI tetap tepat sangat penting untuk keamanan autentikasi Microsoft. Entra ID menuntut ketepatan untuk mencegah penyerang menyadap token atau memanfaatkan celah dalam alur login Anda. Karena itu, berhati-hatilah saat menambah atau mengubah URI, dan sebaiknya tinjau kembali URI setiap kali Anda mengganti lingkungan atau nama host.
Di balik layar, Microsoft mensyaratkan agar redirect URI yang dikirim pada setiap percobaan login sama persis dengan yang tercantum untuk aplikasi Anda. Pencocokan ini mencakup huruf besar-kecil, garis miring di akhir, dan penggunaan HTTPS, yang melindungi Anda, pengguna, dan organisasi dari serangan redirect. Dengan banyaknya perangkat, perubahan kode, dan lingkungan yang berjalan bersamaan, ketidakcocokan mudah terselip. Namun, dengan proses registrasi dan peninjauan URI yang solid, error ini jarang muncul kembali.
Jika Anda ingin memperketat keamanan lebih jauh—terutama terhadap serangan persetujuan OAuth—pelajari sumber seperti panduan mendalam tentang penyalahgunaan persetujuan OAuth dan kontrol Entra ID ini. Mengantisipasi kesalahan konfigurasi sekaligus ancaman yang terus berkembang membuat pengaturan autentikasi Anda lebih tangguh.
Penyebab Umum Error AADSTS50011 pada Redirect URI
- Kesalahan Ketik: Satu huruf yang salah saja sudah cukup membuat redirect URI tidak cocok dengan yang terdaftar, sehingga memicu error AADSTS50011.
- Ketidakcocokan Protokol (HTTP vs HTTPS): Menggunakan http ketika Azure mengharapkan https, atau sebaliknya, menghasilkan ketidakcocokan karena Microsoft sangat ketat soal keamanan.
- Garis Miring yang Hilang atau Berlebih: Garis miring di akhir URI (atau tidak adanya garis miring) dapat menentukan berhasil atau gagalnya kecocokan persis.
- Masalah Sensitivitas Huruf Besar-Kecil: URI di Azure bersifat case-sensitive. Jika permintaan Anda menggunakan /Callback sedangkan registrasi mencantumkan /callback, error akan muncul.
- URL Lingkungan yang Salah: Tertukar antara URL development, staging, atau production—misalnya menggunakan localhost di production—dapat dengan cepat menimbulkan ketidakcocokan.
Cara Mendaftarkan dan Memverifikasi Redirect URI di Azure Portal
- Temukan Registrasi Aplikasi Anda: Di Azure portal, buka “App registrations” lalu pilih aplikasi yang bersangkutan.
- Ubah Redirect URI: Di bawah “Authentication”, temukan bagian Redirect URIs lalu tambahkan, hapus, atau perbarui URI yang diperlukan.
- Cocokkan Detail Secara Persis: Pastikan setiap detail sesuai dengan kode atau deployment Anda—protokol, domain, path, garis miring di akhir, dan huruf besar-kecil.
- Simpan dan Konfirmasi: Setelah mengubah, klik simpan. Periksa ulang bahwa semua redirect URI kini selaras dengan yang digunakan dalam konfigurasi atau basis kode aplikasi Anda.
- Uji Alur Autentikasi: Coba masuk kembali untuk memastikan error sudah teratasi dan redirect berjalan sebagaimana mestinya.
Informasi Lebih Lanjut, Sumber Daya, dan Masukan Komunitas
Sudah selesai mengatasi ketidakcocokan redirect URI? Kabar baiknya, Anda tidak perlu menghadapinya sendirian. Microsoft menyediakan banyak dokumentasi dan referensi yang berguna agar Anda terhindar dari masalah serupa di kemudian hari. Jika Anda membutuhkan detail teknis, mulailah dari dokumentasi kode error resmi untuk masalah autentikasi dan otorisasi di Entra ID (sebelumnya Azure AD). Panduan tersebut menjelaskan kesalahan umum beserta cara memperbaikinya, dan juga menyediakan contoh kode bagi Anda yang senang bereksperimen.
Tentu saja, terkadang dokumentasi tidak membahas kasus-kasus aneh. Di sinilah forum komunitas menjadi penyelamat. Microsoft Q&A, Stack Overflow, dan utas masukan dipenuhi pengalaman nyata dari orang-orang yang pernah berjuang menghadapi AADSTS50011 yang menyebalkan itu. Ajukan gejala Anda, atau telusuri utas yang sudah terselesaikan dan lihat apakah solusinya ada di depan mata. Rasanya seperti memiliki kelompok dukungan khusus untuk menangani masalah Anda.
Untuk informasi lebih lanjut tentang menjaga aplikasi Anda, dan organisasi Anda, tetap aman dan teratur, lihat gambaran besarnya seputar tata kelola cloud dan keamanan identitas. Ingin mencegah penyimpangan kebijakan dan kekacauan konfigurasi? Pelajari panduan singkat ini tentang strategi tata kelola perusahaan Azure. Ingin tahu praktik identitas yang benar-benar ketat? Diskusi ini tentang mengurangi risiko identitas dengan akses bersyarat Entra ID cocok untuk Anda.
Jika Anda merasa artikel ini membantu, atau menemukan sesuatu yang tidak biasa, bagikan masukan Anda atau tuliskan solusi sementara Anda di kolom komentar. Semakin banyak Anda berkontribusi, semakin mudah bagi engineer berikutnya untuk keluar dari jebakan redirect URI. Siapa tahu, wawasan Anda bisa menjadi potongan teka-teki yang hilang bagi orang lain esok hari.
🎧 Anda Juga Sebaiknya Mendengarkan
- Model Operasi Tata Kelola Microsoft 365
Pelajari kepemilikan dan kontrol yang membuat perubahan di Microsoft 365 berkelanjutan.
- Tata Kelola Identitas di Microsoft Entra
Pahami konteks identitas dan akses untuk kolaborasi yang aman.
- AI Agents – Simply Explained
Jelajahi fondasi tata kelola untuk pekerjaan yang dibantu AI.