הבנת שגיאת אי-התאמה של Redirect URI AADSTS50011
By Mirko Peters · · Updated
אי-התאמה של Redirect URI בשגיאה AADSTS50011 פירושה שה-redirect URI שנשלח על ידי אפליקציה אינו זהה במדויק ל-URI שרשום ב-Microsoft Entra ID. יש להשוות בין הבקשה של האפליקציה לבין ה-redirect URI הרשום, כולל הסכמה, שם המארח, הנתיב, הפורט והסלאש הסופי. לאחר מכן יש לתקן את האפליקציה או את הרישום ולבדוק שוב את תהליך הכניסה המיועד…
Automatically translated with AI from the original post. Read the English original

אי-התאמה של Redirect URI בשגיאה AADSTS50011 פירושה שה-redirect URI שנשלח על ידי אפליקציה אינו זהה במדויק ל-URI שרשום ב-Microsoft Entra ID. יש להשוות בין הבקשה של האפליקציה לבין ה-redirect URI הרשום, כולל הסכמה, שם המארח, הנתיב, הפורט והסלאש הסופי. לאחר מכן יש לתקן את האפליקציה או את הרישום ולבדוק שוב את תהליך הכניסה המיועד.
תיקון השגיאה AADSTS50011 – אי-התאמה של Redirect URI
- העתיקו את ה-redirect URI משגיאה או מבקשת הכניסה.
- השוו אותו במדויק לרישום האפליקציה ב-Entra.
- תקנו את ה-URI המאושר ובדקו שוב בסביבה המתאימה.
ראו את Microsoft Learn ל-Entra.
אם ניסיתם אי פעם להגדיר אימות של Microsoft ונתקלתם בחסם, סביר להניח ששגיאת אי-ההתאמה של Redirect URI מסוג AADSTS50011 צצה לכם כמו אורח לא קרוא. השגיאה הזו ידועה לשמצה בקרב מפתחים ומנהלים שעובדים עם Microsoft Entra ID (לשעבר Azure Active Directory), Microsoft 365 ואינטגרציות ב-Azure או ב-Power Platform.
למה זה חשוב? התקלה הזו יכולה לעצור לחלוטין את תהליכי הכניסה, כך שמשתמשים לא יוכלו להיכנס והאפליקציות ייתקעו מחוץ לשערים. אי-התאמות של Redirect URI הן מלכודת נפוצה שפוגעת גם בפרויקטים חדשים וגם בשינויים בהגדרות קיימות. הבנה של מה שמפעיל את AADSTS50011, וידיעה כיצד לתקן אותה, לא רק שומרות על פעולה תקינה של האפליקציות, אלא הן קריטיות לאבטחת האימות וההרשאות בפלטפורמות של Microsoft.
במדריך הזה תראו מה גורם לשגיאה, כיצד לזהות את הסימפטומים שלה, ותקבלו טיפים מעשיים לאיתור ותיקון של ה-redirect URIs הלא תואמים. גם אם אתם חדשים לגמרי באימות של Microsoft, תצאו מכאן מוכנים לפתור תקלות ולאבטח את תהליכי הכניסה בצורה הנכונה.
מה גורם לשגיאה AADSTS50011?
הסיבה המרכזית לשגיאה AADSTS50011 היא אי-התאמה בין ה-redirect URI שבו משתמשת האפליקציה לבין רשימת ה-URIs שרשומים ב-Microsoft Entra ID. כשמישהו מנסה להיכנס, מערכת האימות של Microsoft בודקת שה-redirect URI שנשלח בבקשת OAuth או OpenID Connect זהה במדויק לאחד מה-URIs השמורים ברישום האפליקציה.
הבדיקה המחמירה הזו מונעת מנקודות קצה לא מורשות לירט טוקנים של משתמשים, וזו אבן יסוד בהגנה מודרנית על זהויות. אם יש הבדל כלשהו, גם סלאש מיותר, פרוטוקול שגוי (כמו 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 או ה-redirect, וזה מסמן אי-התאמה שמתרחשת מאחורי הקלעים.
- יומני כשלי אימות: ביומנים של Azure או Entra ID, מנהלים מזהים ניסיונות כניסה שנכשלו עם אזכור מפורש של אי-התאמות ב-redirect URI, לעיתים עם פירוט של ה-URIs הצפויים מול אלה שנשלחו בפועל.
- כשלי כניסה באפליקציות אינטרנט: משתמשי קצה עשויים לדווח על לולאות כניסה, מסכים ריקים, או על כך שהם נזרקים לדף הבית באופן בלתי צפוי, במיוחד מיד אחרי הפנייה אל הכניסה של Microsoft או חזרה ממנה.
- שגיאות במערכות צד-שרת: פלטפורמות אוטומטיות (כמו מעבדי דואר או משימות מתוזמנות) עשויות לרשום או להציג את הקוד AADSTS50011, במיוחד כשהן מנסות תהליכי OAuth מסביבות שונות (פיתוח, סטייджинג, ייצור).
תיקון ה-Redirect URI לפתרון AADSTS50011
הבשורה הטובה היא שפתרון AADSTS50011 הוא בדרך כלל עניין של חקירה ובדיקה כפולה קפדנית, בלי קסמים. ברמה הכללית, תצטרכו ליישר את ה-redirect URI שבו משתמשת האפליקציה שלכם כך שיתאים בדיוק לאלה שרשומים בפורטל Azure תחת רישום האפליקציה שלכם. גם הבדלים זעירים בפרוטוקול, באיות או בלוכסנים יכולים לגרום לאי-התאמה, ולכן תשומת לב לפרטים היא העיקר.
התיקון אינו רק עניין של עצירת שגיאות. שמירה על 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, השגיאה תופיע.
- כתובת סביבה שגויה: ערבוב בין כתובות של סביבות פיתוח, סטייג'ינג או ייצור, כמו שימוש ב-localhost בסביבת ייצור, יכול ליצור אי-התאמות במהירות.
איך לרשום ולאמת redirect URI בפורטל Azure
- איתור רישום האפליקציה שלכם: בפורטל Azure, עברו אל "App registrations" ובחרו את האפליקציה הרלוונטית.
- עריכת redirect URI: תחת "Authentication", אתרו את הקטע Redirect URIs והוסיפו, מחקו או עדכנו את ה-URI הנדרשים.
- התאמה מלאה של הפרטים: ודאו שכל פרט תואם לקוד או לפריסה שלכם: פרוטוקול, דומיין, נתיב, לוכסן בסוף ואותיות גדולות וקטנות.
- שמירה ואישור: לאחר העריכה, לחצו על שמירה. ודאו שכל ה-redirect URI מיושרים כעת עם אלה שבהגדרות היישום או בבסיס הקוד שלכם.
- בדיקת תהליך האימות: נסו להתחבר שוב כדי לוודא שהשגיאה נפתרה וההפניה מתנהגת כצפוי.
מידע נוסף, משאבים ומשוב מהקהילה
סיימתם להתמודד עם אי-התאמה של redirect URI? בשורה טובה: אין צורך לנסות לפתור את זה לבד. Microsoft מספקת כמות גדולה של תיעוד ומקורות מועילים שיעזרו לכם להימנע מבעיות בעתיד. אם אתם מחפשים את הפרטים המדויקים, התחילו מדפי תיעוד קודי השגיאה הרשמיים של Microsoft לבעיות אימות והרשאה ב-Entra ID (לשעבר Azure AD). המדריכים האלה מלווים אתכם בטעויות נפוצות ובדרכים לתקן אותן, וכן מציעים דוגמאות קוד לכל מי שאוהב להתנסות.
כמובן, לפעמים התיעוד אינו מכסה מקרי קצה מוזרים. שם פורומים קהילתיים הופכים לקו החיים שלכם. Microsoft Q&A, Stack Overflow ושרשורי המשוב מלאים בסיפורים אמיתיים של אנשים שנאבקו עם AADSTS50011 המפחיד, ומצאו לו פתרון. הצטרפו עם התסמינים שלכם, או עברו על שרשורים שנפתרו וראו אם התיקון שלכם מסתתר לנגד עיניכם. זה כמו שיש לכם קבוצת תמיכה שלמה שמוקדשת לכאבי הראש שלכם.
לקבלת התמונה הרחבה על שמירה על האפליקציות שלכם, והארגון שלכם, מאובטחים ומסודרים, כדאי לעיין בנושאי ממשל ענן ואבטחת זהויות. רוצים למנוע סחף במדיניות ובלגן בתצורות? עיינו במדריך הקצר הזה על אסטרטגיית ממשל ארגוני ב-Azure. רוצים להכיר לעומק שיטות עבודה הדוקות לניהול זהויות? הדיון הזה על גישה מותנית ב-Entra ID מיועד בדיוק בשבילכם.
אם מצאתם את התוכן מועיל, או נתקלתם במשהו יוצא דופן, שתפו את המשוב שלכם או כתבו את הפתרון העוקף שמצאתם בתגובות. ככל שתתרמו יותר, יהיה קל יותר למהנדס הבא להימלט מהבוץ של כתובות ה-redirect URI. מי יודע, התובנה שלכם עשויה להיות חלק החסר בפאזל של מישהו אחר מחר.
🎧 כדאי גם להאזין ל
- מודל התפעול לממשל Microsoft 365
למדו על הבעלות והבקרות שהופכות שינויים ב-Microsoft 365 לבני קיימא.
- ממשל זהויות ב-Microsoft Entra
הבינו את הקשר של זהויות וגישה לשיתוף פעולה מאובטח.
- סוכני AI – בקצרה
גלו את יסודות הממשל בעבודה מסוייעת בינה מלאכותית.