M365Con 2027 – бесплатная онлайн-конференция · 11–22 Jan 2027 · 120 sessions→ m365con.net

Блог · Mirko Peters

Разбираем ошибку AADSTS50011: несовпадение redirect URI

By · · Updated

Ошибка AADSTS50011 (redirect URI mismatch) означает, что 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 mismatch) означает, что redirect URI, который отправляет приложение, не совпадает точно с URI, зарегистрированным в Microsoft Entra ID. Сравните запрос приложения с зарегистрированным redirect URI, включая схему, имя хоста, путь, порт и завершающий слеш. Исправьте приложение или регистрацию, затем повторите проверку нужного сценария входа.

Как исправить ошибку AADSTS50011 (redirect URI mismatch)

  1. Скопируйте redirect URI из сообщения об ошибке или из запроса на вход.
  2. Сравните его точно с регистрацией приложения в Entra.
  3. Исправьте утвержденный URI и повторите проверку в нужной среде.

См. Microsoft Learn для Entra.

Если вы хоть раз пытались настроить проверку подлинности Microsoft и упирались в препятствие, скорее всего, ошибка AADSTS50011 (redirect URI mismatch) возникала непрошеным гостем. Эта ошибка печально известна разработчикам и администраторам, которые работают с 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, который использует ваше приложение, в точное соответствие с URI, зарегистрированными в портале Azure в разделе регистрации вашего приложения. Даже небольшие расхождения в протоколе, написании или косых чертах могут вызвать несоответствие, поэтому здесь всё решает внимание к деталям.

Исправление этой ошибки нужно не только для того, чтобы её остановить. Правильно настроенные redirect URI важны для безопасности проверки подлинности Microsoft. Entra ID требует точности, чтобы злоумышленники не могли перехватить токены или использовать слабые места в процессе входа. Поэтому при добавлении или изменении URI стоит проявлять особую осторожность, а проверять их имеет смысл каждый раз, когда вы меняете среду или имя узла.

На практике Microsoft требует, чтобы redirect URI в запросе на вход в точности совпадал с тем, что указано для вашего приложения. Это сравнение учитывает регистр, завершающие косые черты и использование HTTPS, что защищает вас, пользователей и организацию от атак с перенаправлением. Когда задействованы несколько устройств, изменения в коде и разные среды, несоответствия легко проскальзывают незаметно. Но если у вас налажен процесс регистрации и проверки URI, эта ошибка будет появляться очень редко.

Если вы хотите ещё сильнее повысить безопасность, особенно защиту от атак с согласием OAuth, посмотрите материалы вроде этого подробного руководства по злоупотреблению согласием OAuth и средствам контроля Entra ID. Опережать как ошибки в настройке, так и новые угрозы — вот что делает схему аутентификации по-настоящему устойчивой.

Типичные причины ошибок redirect URI AADSTS50011

  • Опечатки: Даже одна неверная буква не даст URI совпасть с зарегистрированным и вызовет ошибку AADSTS50011.
  • Несоответствие протокола (HTTP и HTTPS): Использование http там, где Azure ожидает https, или наоборот, приводит к несоответствию, поскольку Microsoft очень строго относится к безопасности.
  • Лишние или отсутствующие косые черты: Завершающая косая черта в конце URI (или её отсутствие) может сделать точное совпадение невозможным.
  • Проблемы с регистром: URI в Azure чувствительны к регистру. Если запрос идёт на /Callback, а в регистрации указано /callback, появится ошибка.
  • Неверный URL среды: Путаница между URL сред разработки, тестирования и рабочей среды, например использование localhost в рабочей среде, быстро приводит к несоответствиям.

Как зарегистрировать и проверить redirect URI на портале Azure

  • Найдите регистрацию приложения: На портале Azure перейдите в раздел «Регистрации приложений» и выберите нужное приложение.
  • Измените redirect URI: В разделе «Проверка подлинности» найдите блок URI перенаправления и добавьте, удалите или обновите нужные URI.
  • Проверьте точное совпадение: Убедитесь, что каждая деталь совпадает с кодом или развёртыванием: протокол, домен, путь, завершающая косая черта и регистр.
  • Сохраните и подтвердите: После изменений нажмите «Сохранить». Ещё раз проверьте, что все redirect URI совпадают с теми, что используются в конфигурации приложения или в кодовой базе.
  • Проверьте процесс входа: Попробуйте войти ещё раз, чтобы убедиться, что ошибка устранена и перенаправление работает как ожидается.

Дополнительная информация, ресурсы и отзывы сообщества

Итак, с несоответствием redirect URI разобрались? Хорошая новость: действовать наугад не обязательно. Microsoft публикует огромное количество документации и полезных материалов, которые помогут избежать таких проблем в будущем. Если нужны подробности, начните с официальной документации по кодам ошибок для проблем аутентификации и авторизации в Entra ID (ранее Azure AD). В этих руководствах описаны типичные ошибки и способы их исправить, а также есть примеры кода для тех, кто любит экспериментировать.

Конечно, документация не всегда описывает нестандартные ситуации. Здесь незаменимы форумы сообщества. Microsoft Q&A, Stack Overflow и ветки обратной связи полны реальных историй от тех, кто уже сталкивался с печально известной ошибкой AADSTS50011 и справился с ней. Опишите свои симптомы или просмотрите решённые обсуждения и посмотрите, не лежит ли ваше решение прямо на поверхности. Это как поддержка единомышленников, которые тоже разбирались с этими головными болями.

Чтобы узнать больше о том, как держать в безопасности свои приложения и всю организацию, загляните в общую картину управления облаком и безопасности идентификации. Хотите, чтобы дрейф политик и хаос в конфигурациях не выходили из-под контроля? Изучите этот обзор: стратегия корпоративного управления в Azure. Хотите разобраться в надёжных практиках управления идентификацией? Это обсуждение снижения рисков идентификации с помощью условного доступа Entra ID вам подойдёт.

Если этот материал оказался полезным или вы столкнулись с чем-то необычным, поделитесь своим опытом или решением в комментариях. Чем больше людей делятся знаниями, тем проще следующему инженеру выбраться из ловушки с redirect URI. Кто знает, возможно, ваш опыт станет недостающим фрагментом головоломки для кого-то завтра.

🎧 Вам также стоит послушать

Entities in this article

Microsoft Entra ID Microsoft Entra Application registration Microsoft HTTP Microsoft Learn Azure portal Power Platform

Related articles

RSS