AADSTS50011 리디렉션 URI 불일치 오류 이해하기
By Mirko Peters · · Updated
AADSTS50011 리디렉션 URI 불일치는 애플리케이션이 보낸 리디렉션 URI가 Microsoft Entra ID에 등록된 URI와 정확히 일치하지 않는다는 뜻입니다. 체계(scheme), 호스트 이름, 경로, 포트, 끝에 붙는 슬래시까지 포함해 애플리케이션 요청과 등록된 리디렉션 URI를 비교합니다. 그다음 애플리케이션 또는 등록 정보를 수정하고, 의도한 로그인 흐름을 다시 테스트합니다.
Automatically translated with AI from the original post. Read the English original

AADSTS50011 리디렉션 URI 불일치는 애플리케이션이 보낸 리디렉션 URI가 Microsoft Entra ID에 등록된 URI와 정확히 일치하지 않는다는 뜻입니다. 체계(scheme), 호스트 이름, 경로, 포트, 끝에 붙는 슬래시까지 포함해 애플리케이션 요청과 등록된 리디렉션 URI를 비교합니다. 그다음 애플리케이션 또는 등록 정보를 수정하고, 의도한 로그인 흐름을 다시 테스트합니다.
AADSTS50011 리디렉션 URI 불일치 수정하기
- 오류 또는 로그인 요청에서 리디렉션 URI를 복사합니다.
- Entra 앱 등록 정보와 정확히 비교합니다.
- 승인된 URI를 수정하고 해당 환경에서 다시 테스트합니다.
Microsoft Learn for Entra에서 자세히 확인합니다.
Microsoft 인증 설정을 시도하다가 막힌 적이 있다면, AADSTS50011 리디렉션 URI 불일치 오류가 초대하지 않은 손님처럼 불쑥 나타났을 가능성이 높습니다. 이 오류는 Microsoft Entra ID(이전 명칭 Azure Active Directory), Microsoft 365, 그리고 Azure 또는 Power Platform의 통합 기능을 다루는 개발자와 관리자 사이에서 악명이 높습니다.
왜 중요할까요? 이 문제는 로그인 흐름을 순식간에 멈춰 세워, 사용자가 로그인하지 못하고 애플리케이션이 문밖에 갇힌 상태로 만들 수 있습니다. 리디렉션 URI 불일치는 새 프로젝트와 기존 구성 변경 모두에서 자주 걸리는 함정입니다. AADSTS50011을 유발하는 원인을 이해하고 해결 방법을 아는 것은 앱을 원활하게 운영할 뿐 아니라, Microsoft 플랫폼의 인증 및 권한 부여를 안전하게 지키는 데에도 매우 중요합니다.
이 가이드에서는 오류의 원인, 증상을 식별하는 방법, 그리고 불일치하는 리디렉션 URI를 찾아 수정하는 실용적인 팁을 살펴봅니다. Microsoft 인증을 처음 접하더라도, 로그인 흐름을 문제 해결하고 올바른 방식으로 보호할 준비를 갖추게 될 것입니다.
AADSTS50011 오류의 원인은 무엇일까요?
AADSTS50011 오류의 근본 원인은 애플리케이션이 사용하는 리디렉션 URI와 Microsoft Entra ID에 등록된 URI 목록 사이의 불일치입니다. 사용자가 로그인을 시도하면 Microsoft 인증 시스템은 OAuth 또는 OpenID Connect 요청에 담긴 리디렉션 URI가 앱 등록 정보에 저장된 URI 중 하나와 정확히 일치하는지 확인합니다.
이 엄격한 보안 검사는 승인되지 않은 엔드포인트가 사용자 토큰을 가로채는 것을 막으며, 이는 최신 ID 보호의 핵심 요소입니다. 슬래시 하나, 잘못된 프로토콜(https 대신 http), 오타 등 아주 작은 차이라도 있으면 Entra ID는 즉시 로그인을 차단하고 AADSTS50011 오류를 표시합니다. 이 보호 장치를 이해하면 오류를 더 빨리 해결할 수 있을 뿐 아니라, 앞으로 위험한 잘못된 구성을 피하는 데도 도움이 됩니다.
주의해야 할 증상과 오류 메시지
- Microsoft 로그인 화면 오류: 사용자가 로그인을 시도한 후 굵은 글씨의 “AADSTS50011: The reply URL specified in the request does not match...” 메시지가 표시됩니다. 이 메시지는 대개 Microsoft 로그인 시작 페이지에 나타나며 인증을 완전히 중단시킵니다.
- API 호출의 OAuth 오류 코드: Microsoft API와 통합된 앱은 API 또는 리디렉션 응답에 “error=invalid_request” 또는 “error=AADSTS50011”이 포함된 오류 객체를 받으며, 이는 내부에서 불일치가 발생했음을 나타냅니다.
- 인증 실패 로그: Azure 또는 Entra ID 로그에서 관리자는 리디렉션 URI 불일치가 명시된 로그인 실패 시도를 발견하며, 종종 예상 URI와 실제 URI에 대한 세부 정보가 함께 기록되어 있습니다.
- 웹 앱 로그인 실패: 최종 사용자는 로그인이 반복되거나 빈 화면이 나타나는 현상, 또는 특히 Microsoft 로그인으로 이동했다가 돌아온 직후 예기치 않게 홈 페이지로 되돌아가 버리는 현상을 보고할 수 있습니다.
- 백엔드 시스템 오류: 자동화된 플랫폼(이메일 처리기나 예약 작업 등)은 특히 다른 환경(개발, 스테이징, 운영)에서 OAuth 흐름을 시도할 때 AADSTS50011 코드를 기록하거나 표시할 수 있습니다.
AADSTS50011 해결을 위한 리디렉션 URI 수정
좋은 소식은 AADSTS50011 오류를 해결하는 일이 보통 탐정 작업처럼 꼼꼼히 확인하는 과정이라는 점입니다. 특별한 마법은 필요하지 않습니다. 큰 틀에서 보면, 애플리케이션이 사용하는 리디렉션 URI를 Azure Portal의 앱 등록에 등록된 값과 정확히 일치시켜야 합니다. 프로토콜, 철자, 슬래시 하나만 달라도 불일치가 발생할 수 있으므로 세부 사항에 주의를 기울이는 것이 핵심입니다.
이 문제를 해결하는 일은 단순히 오류를 없애는 데 그치지 않습니다. 리디렉션 URI를 정확하게 관리하는 것은 Microsoft 인증 보안에도 필수적입니다. Entra ID는 공격자가 토큰을 가로채거나 로그인 흐름의 취약점을 악용하지 못하도록 정확성을 요구합니다. 그래서 URI를 추가하거나 편집할 때 특히 주의해야 하며, 환경이나 호스트 이름을 변경할 때마다 검토하는 것이 좋습니다.
내부적으로 Microsoft는 로그인 시도에 전송되는 리디렉션 URI가 애플리케이션에 등록된 값과 정확히 일치해야 한다고 요구합니다. 이 일치 여부는 대소문자, 끝에 붙는 슬래시, HTTPS 사용 여부까지 모두 확인합니다. 이런 검사는 리디렉션 공격으로부터 사용자와 조직을 보호하기 위한 것입니다. 여러 기기, 코드 변경, 여러 환경이 얽혀 있으면 불일치가 쉽게 생길 수 있지만, URI를 등록하고 검토하는 체계적인 절차를 갖추면 이 오류를 다시 보는 일은 드물어질 것입니다.
OAuth 동의 공격에 대비해 보안 수준을 더 높이고 싶다면, OAuth 동의 남용과 Entra ID 제어에 관한 이 상세 가이드와 같은 자료를 살펴보시기 바랍니다. 구성상의 실수와 진화하는 위협을 모두 앞서 대비하면 인증 환경을 더 탄탄하게 만들 수 있습니다.
리디렉션 URI AADSTS50011 오류의 주요 원인
- 오타: 글자 하나만 잘못되어도 리디렉션 URI가 등록된 값과 일치하지 않아 AADSTS50011 오류가 발생합니다.
- 프로토콜 불일치(HTTP와 HTTPS): Azure에서 https를 기대하는데 http를 사용하거나 그 반대의 경우 불일치가 발생합니다. Microsoft는 보안에 엄격하기 때문입니다.
- 슬래시 누락 또는 추가: URI 끝의 슬래시가 있거나 없는 것만으로도 정확한 일치 여부가 결정될 수 있습니다.
- 대소문자 구분 문제: Azure의 URI는 대소문자를 구분합니다. 요청은 /Callback인데 등록된 값이 /callback이면 오류가 발생합니다.
- 잘못된 환경 URL: 개발, 스테이징, 운영 URL을 혼동하면(예: 운영 환경에서 localhost 사용) 금방 불일치가 생길 수 있습니다.
Azure Portal에서 리디렉션 URI를 등록하고 확인하는 방법
- 앱 등록 찾기: Azure Portal에서 "앱 등록"으로 이동한 후 해당 애플리케이션을 선택합니다.
- 리디렉션 URI 편집: "인증"에서 리디렉션 URI 섹션을 찾아 필요한 URI를 추가, 삭제 또는 수정합니다.
- 세부 사항 정확히 일치시키기: 프로토콜, 도메인, 경로, 끝의 슬래시, 대소문자 등 모든 항목이 코드나 배포 설정과 일치하는지 확인합니다.
- 저장 및 확인: 편집 후 저장을 누릅니다. 모든 리디렉션 URI가 애플리케이션 구성이나 코드베이스에서 사용하는 값과 일치하는지 다시 확인합니다.
- 인증 흐름 테스트: 다시 로그인을 시도하여 오류가 해결되었고 리디렉션이 예상대로 동작하는지 확인합니다.
추가 정보, 리소스 및 커뮤니티 피드백
리디렉션 URI 불일치 문제를 마무리하셨나요? 혼자 해결할 필요는 없습니다. Microsoft는 다음번에 같은 문제를 피할 수 있도록 방대한 문서와 유용한 참고 자료를 제공합니다. 자세한 내용이 필요하다면 Entra ID(이전 명칭 Azure AD)의 인증 및 권한 부여 문제에 대한 공식 오류 코드 문서부터 살펴보시기 바랍니다. 이 가이드에서는 흔히 발생하는 실수와 이를 바로잡는 방법을 설명하며, 직접 시도해 보는 분들을 위한 코드 샘플도 제공합니다.
물론 문서로는 다루지 않는 특이한 사례도 있습니다. 이럴 때는 커뮤니티 포럼이 큰 도움이 됩니다. Microsoft Q&A, Stack Overflow, 피드백 게시판에는 골치 아픈 AADSTS50011 오류와 씨름하고 해결한 사람들의 실제 경험담이 가득합니다. 증상을 남기고 질문하거나 해결된 글을 살펴보면 해결책이 바로 눈앞에 있을 수도 있습니다. 머리 아픈 문제를 함께 나눌 수 있는 지원 모임이 곁에 있는 셈입니다.
앱과 조직을 안전하고 체계적으로 유지하는 방법에 대해 더 알고 싶다면, 클라우드 거버넌스와 ID 보안의 전체적인 그림을 살펴보시기 바랍니다. 정책 드리프트와 구성 혼선을 막고 싶으신가요? Azure 엔터프라이즈 거버넌스 전략에 대한 이 입문 자료를 참고해 보세요. 빈틈없는 ID 관리 방법이 궁금하신가요? Entra ID 조건부 액세스로 ID 위험을 줄이는 방법을 다룬 이 토론이 도움이 될 것입니다.
이 내용이 도움이 되셨거나 특이한 문제를 겪으셨다면, 의견을 남기시거나 댓글에 해결 방법을 공유해 주십시오. 여러분이 더 많이 공유할수록 다음 엔지니어가 리디렉션 URI 문제에서 더 쉽게 빠져나올 수 있습니다. 여러분의 통찰이 내일 누군가에게 필요한 마지막 퍼즐 조각이 될지도 모릅니다.
🎧 함께 들어보면 좋은 에피소드
- Microsoft 365 거버넌스 운영 모델
Microsoft 365 변경 작업을 지속 가능하게 만드는 소유권과 통제 방식을 알아봅니다.
- Microsoft Entra의 ID 거버넌스
안전한 공동 작업을 위한 ID 및 액세스 맥락을 이해합니다.
- AI 에이전트 – 쉽게 설명
AI 지원 업무의 거버넌스 기반을 살펴봅니다.