Розуміємо помилку AADSTS50011: невідповідність redirect URI

By Mirko Peters · 2026-04-20 · Updated 2026-07-28

Невідповідність redirect URI у AADSTS50011 означає, що redirect URI, який надсилає застосунок, не збігається точно з URI, зареєстрованим у Microsoft Entra ID. Порівняйте запит застосунку із зареєстрованим redirect URI, зокрема схему, ім’я хоста, шлях, порт і кінцевий слеш. Виправте застосунок або реєстрацію, а потім повторно перевірте потрібний сценарій входу.

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

Cover: Stop OAuth Consent Attacks in Microsoft Entra ID

Виправлення помилки AADSTS50011: невідповідність redirect URI

Скопіюйте redirect URI з повідомлення про помилку або із запиту на вхід.
Порівняйте його точно з реєстрацією застосунку в Entra.
Виправте затверджений URI і повторно перевірте в належному середовищі.

Див. Microsoft Learn для Entra.

Якщо ви коли-небудь намагалися налаштувати автентифікацію Microsoft і натрапляли на перешкоду, ймовірно, помилка AADSTS50011 «невідповідність redirect URI» з’являлася несподівано, мов незваний гість. Ця помилка добре відома розробникам і адміністраторам, які працюють із Microsoft Entra ID (раніше Azure Active Directory), Microsoft 365 та інтеграціями в Azure або Power Platform.

Чому це важливо? Цей збій може зупинити ваші сценарії входу: користувачі не зможуть увійти, а застосунки опиняться поза доступом. Невідповідності redirect URI є поширеною пасткою, яка вражає як нові проєкти, так і зміни в наявних налаштуваннях. Розуміння того, що спричиняє AADSTS50011, і знання, як це виправити, не лише підтримує стабільну роботу застосунків, а й критично важливе для безпеки автентифікації та авторизації на платформах Microsoft.

У цьому посібнику ви дізнаєтеся, що спричиняє помилку, як її розпізнати за симптомами та отримаєте практичні поради, як знайти й виправити невідповідні redirect URI. Навіть якщо ви щойно починаєте працювати з автентифікацією Microsoft, після цього ви зможете діагностувати та надійно налаштувати сценарії входу.

Що спричиняє помилку AADSTS50011?

Першопричина помилки AADSTS50011 полягає в невідповідності між redirect URI, який використовує ваш застосунок, і списком URI, зареєстрованих у Microsoft Entra ID. Коли хтось намагається увійти, система автентифікації Microsoft перевіряє, чи redirect URI, надісланий у запиті OAuth або OpenID Connect, точно збігається з одним із URI, збережених для реєстрації застосунку.

Ця сувора перевірка безпеки не дає неавторизованим кінцевим точкам перехоплювати токени користувачів, і це один із наріжних каменів сучасного захисту ідентифікації. Якщо є будь-яка різниця, навіть зайва риска, неправильний протокол (наприклад, http замість https) або друкарська помилка, Entra ID одразу блокує вхід і показує помилку AADSTS50011. Розуміння цього механізму допоможе вам не лише швидше усувати помилки, а й уникати ризикованих неправильних налаштувань надалі.

Симптоми проблеми та повідомлення про помилки, на які варто звернути увагу

Помилки на екрані входу Microsoft: після спроби входу користувачі бачать виділене повідомлення «AADSTS50011: The reply URL specified in the request does not match...». Зазвичай воно відображається на сторінці входу Microsoft і повністю зупиняє автентифікацію.
Коди помилок OAuth у викликах API: застосунки, які інтегруються з API Microsoft, отримують об’єкти помилок, що містять «error=invalid_request» або «error=AADSTS50011» у відповідях API чи перенаправлень, що свідчить про невідповідність у фоновому режимі.
Журнали помилок автентифікації: у журналах Azure або Entra ID адміністратори бачать невдалі спроби входу з явними згадками про невідповідність redirect URI, часто з деталями щодо очікуваного та фактичного URI.
Збої входу у веб-застосунках: кінцеві користувачі можуть повідомляти про циклічні входи, порожні екрани або несподіване повернення на головну сторінку, особливо одразу після переходу на сторінку входу Microsoft або з неї.
Помилки серверних систем: автоматизовані платформи (наприклад, обробники електронної пошти або заплановані завдання) можуть записувати в журнал або відображати код AADSTS50011, особливо під час спроб виконати потоки OAuth із різних середовищ (dev, staging, production).

Виправлення redirect URI для усунення помилки AADSTS50011

Хороша новина: усунути помилку AADSTS50011 зазвичай означає ретельно перевірити деталі та уважно все звірити, магії тут не потрібно. Загалом вам потрібно привести redirect URI, який використовує ваш застосунок, у точну відповідність до тих, що зареєстровані в Azure portal для реєстрації вашого застосунку. Навіть найменша різниця в протоколі, написанні чи косих рисках може спричинити невідповідність, тож уважність до дрібниць тут вирішує все.

Виправлення цієї помилки стосується не лише усунення збоїв. Коректні redirect URI є важливою частиною безпеки автентифікації Microsoft. Entra ID вимагає точності, щоб зловмисники не могли перехопити токени чи використати слабкі місця у процесі входу. Тому додаючи або змінюючи URI, будьте особливо уважні, а переглядати їх варто щоразу, коли ви змінюєте середовища чи імена хостів.

Під капотом Microsoft вимагає, щоб redirect URI у запиті на вхід точно збігався з тим, що вказано для вашого застосунку. Ця перевірка стосується навіть регістру символів, кінцевих косих рисок і використання HTTPS, а це захищає вас, ваших користувачів і вашу організацію від атак через перенаправлення. Коли в роботі одночасно задіяні різні пристрої, зміни коду й середовища, невідповідності легко пропустити, але продумана процедура реєстрації та перегляду URI майже виключить повторення цієї помилки.

Якщо ви хочете ще посилити захист, особливо від атак згоди OAuth, зверніться до матеріалів на кшталт цього детального посібника про зловживання згодою OAuth і засоби керування в Entra ID. Випереджати як помилки конфігурації, так і нові загрози означає мати стійкішу схему автентифікації.

Поширені причини помилок AADSTS50011 через redirect URI

Друкарські помилки: Навіть одна зайва чи пропущена літера не дасть redirect URI збігтися із зареєстрованим, і з'явиться помилка AADSTS50011.
Невідповідність протоколів (HTTP і HTTPS): Використання http там, де Azure очікує https, або навпаки, призводить до невідповідності, адже Microsoft суворо дотримується вимог безпеки.
Зайві або відсутні косі риски: Коса риска в кінці URI (або її відсутність) може визначити, чи буде точний збіг.
Чутливість до регістру: URI в Azure чутливі до регістру. Якщо запит надсилається на /Callback, а в реєстрації вказано /callback, з'явиться помилка.
Неправильна URL-адреса середовища: Плутанина між середовищами розробки, тестування та продуктивним середовищем, наприклад використання localhost у продуктиві, може швидко призвести до невідповідностей.

Як зареєструвати й перевірити redirect URI в Azure portal

Знайдіть свою реєстрацію застосунку: В Azure portal перейдіть до розділу «App registrations» («Реєстрації застосунків») і виберіть потрібний застосунок.
Змініть redirect URI: У розділі «Authentication» («Автентифікація») знайдіть секцію Redirect URIs і додайте, видаліть або оновіть потрібні URI.
Перевірте точні деталі: Переконайтеся, що кожна деталь збігається з вашим кодом або розгортанням: протокол, домен, шлях, кінцева коса риска та регістр.
Збережіть і підтвердьте: Після змін натисніть «Save» («Зберегти»). Ще раз перевірте, що всі redirect URI тепер відповідають тим, що використовуються в конфігурації застосунку або кодовій базі.
Перевірте процес входу: Спробуйте увійти знову, щоб переконатися, що помилку усунено і перенаправлення працює як очікується.

Додаткова інформація, ресурси та відгуки спільноти

Завершуючи розбір невідповідності redirect URI, пам'ятайте: вам не доведеться розбиратися самотужки. Microsoft надає великий обсяг документації та корисних довідкових матеріалів, які допоможуть уникнути проблем у майбутньому. Якщо потрібні детальні відомості, почніть із офіційної документації щодо кодів помилок для проблем автентифікації й авторизації в Entra ID (раніше Azure AD). Ці матеріали розповідають про типові помилки та способи їх виправлення, а також містять приклади коду для тих, хто любить експериментувати.

Звісно, документація не завжди охоплює рідкісні випадки. Саме тут на допомогу приходять форуми спільноти. Microsoft Q&A, Stack Overflow і обговорення у фідбеку містять справжні історії від людей, які боролися з AADSTS50011 і перемогли її. Опишіть свою проблему або перегляньте вирішені теми, можливо, ваше рішення вже є на виду. Це наче власна група підтримки для ваших головних болів.

Щоб дізнатися більше про те, як захистити свої застосунки та організацію й зберегти в них порядок, зверніться до ширшої картини навколо управління хмарою та безпеки ідентичності. Хочете уникнути дрейфу політик і хаосу в конфігураціях? Ознайомтеся з цим короткім оглядом: Стратегія управління Azure для великих організацій. Хочете детальніше розібратися в надійних практиках роботи з ідентичністю? Ця дискусія про зниження ризиків ідентичності за допомогою умовного доступу Entra ID саме для вас.

Якщо ця стаття була корисною або ви натрапили на щось незвичайне, поділіться відгуком або опишіть свій обхідний варіант у коментарях. Чим більше ви долучаєтеся, тим легше наступному інженеру вибратися з пастки з redirect URI. Хто знає, можливо, ваш досвід буде тим бракуючим фрагментом пазла для когось іншого вже завтра.

🎧 Вам також варто послухати

Операційна модель управління Microsoft 365
Дізнайтеся про відповідальність і механізми контролю, які роблять зміни в Microsoft 365 стійкими.
Управління ідентичностями в Microsoft Entra
Розберіться в контексті ідентичності та доступу, необхідному для безпечної спільної роботи.
AI-агенти – просто про складне
Ознайомтеся з основами управління для роботи, що спирається на ШІ.