M365Con 2027 – כנס אונליין חינמי · 11–22 Jan 2027 · 120 sessions m365con.net

בלוג · Mirko Peters

איך פותרים את השגיאה AADSTS900144 (פרמטר חסר) ב-Azure AD

By ·

איש לא אוהב להיתקע מול קיר של שגיאות אימות, אבל השגיאה AADSTS900144 (פרמטר חסר) ב-Azure AD היא אחת מאותן מכשולים קלאסיים שמתסכלים את כולם, מהמפתחים של האפליקציות ועד מנהלי ה-IT. המאמר הזה מסביר בדיוק מה עומד מאחורי השגיאה, מה לבדוק קודם, והצעדים שיחזירו את המשתמשים לעבודה. נעבור על הסיבות והתיקונים, מטעויות נפוצות בפרמטרים ועד לעומק של זרימות OAuth והשילוב עם אפליקציות ענן.

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

עטיפה: תיקון התפשטות הממשל ב-Microsoft Teams באמצעות החלטות מחייבות

איש לא אוהב להיתקע מול קיר של שגיאות אימות, אבל השגיאה AADSTS900144 (פרמטר חסר) ב-Azure AD היא אחת מאותן מכשולים קלאסיים שמתסכלים את כולם, מהמפתחים של האפליקציות ועד מנהלי ה-IT. המאמר הזה מסביר בדיוק מה עומד מאחורי השגיאה, מה לבדוק קודם, והצעדים שיחזירו את המשתמשים לעבודה. נעבור על הסיבות והתיקונים, מטעויות נפוצות בפרמטרים ועד לעומק של זרימות OAuth והשילוב עם אפליקציות ענן.

בין אם אתם תומכים ב-Microsoft 365, ב-Azure, ב-Power Platform או בכל פתרון שמתחבר ל-Entra ID, תמצאו כאן טיפים לתיקונים הן בצד הלקוח והן בצד השרת. פתרון תקלות מהשטח, שיטות עבודה מומלצות מוכנות לארגונים, וקישורים נוספים לתוכן על ממשל ענן – הכול כדי לעזור לכם למנוע כאבי ראש בפעם הבאה שהשגיאה הזו תופיע.

למה מופיעה השגיאה "AADSTS900144" באימות ב-Azure AD?

השגיאה "AADSTS900144: Request body must contain the following parameter" מופיעה כשפרטים קריטיים חסרים בבקשת אימות שנשלחת ל-Azure Active Directory (או ל-Microsoft Entra ID). במילים פשוטות, Azure מחפש מידע כמו grant_type או client_id בבקשת ה-token שלכם, ולא מוצא אותו – או שהפרטים קיימים, אבל הם בפורמט שגוי או במקום הלא נכון.

השגיאה הזו נפוצה במיוחד בזרימות OAuth 2.0, במיוחד כשמשתמשים או אפליקציות מנסים להתחבר דרך שירותי ענן ארגוניים. בדרך כלל הבעיה נובעת מפרמטרים שגויים בגוף הבקשה שנשלחת בעת החלפת קוד ההרשאה ב-token. אם פרמטר חובה הושמט, נכתב בצורה שגויה או נשלח מחוץ לגוף ה-POST הצפוי, Azure AD עוצר את התהליך לגמרי עם הקוד AADSTS900144.

ייתכן שתראו את השגיאה הזו בעת שילוב אפליקציות עסקיות מותאמות אישית, רישום אפליקציות חדשות ב-Azure, או כאשר לקוחות שולחניים (כמו Microsoft Teams) נתקלים בבעיות אימות. לפעמים אפילו טעות העתקה והדבקה או עדכון מהיר של רישום האפליקציה יכולים להוציא את הפרמטר מסנכרון. ההודעה עשויה להיראות מעורפלת, אבל זו הדרך של Azure לומר לכם: "חזרו, בדקו שוב את הבקשה ותקנו את מה שחסר."

לכל מי שעובד עם יישומים מרובי-דיירים, חשוב לדעת שחוסר התאמה בהקשר הדייר או בנקודות הקצה של השירות עלול ליצור בלבול דומה, ולעיתים לגרום לכך שייראה כאילו פרמטר חסר, בעוד שהבעיה היא רק ניתוב שגוי. הבנת המנגנונים האלה מזרזת את פתרון הבעיות ומקלה על צוותי התמיכה.

בעיות נפוצות בפרמטרים של גוף הבקשה ותיקונים מהירים

שגיאת AADSTS900144 כמעט תמיד נובעת ממשהו שהושמט או הוכנס למקום הלא נכון בבקשת ה-token. החשודים הרגילים הם client_id ו-grant_type. אם האפליקציה שלכם מפספסת אפילו פרמטר נדרש אחד, נקודת ה-token של Azure AD דוחה את הבקשה באופן מוחלט. ודאו שאתם משתמשים בשיטת HTTP POST, שכן בקשות GET ופעולות אחרות לא יספיקו כאן.

התחילו באישור שהאפליקציה שולחת בקשות עם סוג התוכן application/x-www-form-urlencoded. מדהים כמה פעמים סוג תוכן שגוי גורם ל-Azure AD לחפש פרמטרים שהוא לא מצליח לקרוא. לאחר מכן, פתחו כלי לבקשות HTTP כלשהו (Postman, curl ואפילו Fiddler) ובדקו את גוף הבקשה הגולמי – האם client_id, grant_type, client_secret וכל השאר באמת נמצאים בתוכן הבקשה, ולא כערכים במחרוזת השאילתה או מוסתרים בכותרות?

אם אתם משנים רישום אפליקציה, זכרו שהפרמטרים הצפויים עשויים להשתנות בהתאם לסוג זרימת ההרשאה. לדוגמה, שימוש במענק קוד ההרשאה (authorization code) מחייב גם לספק את code. זה לא תמיד ברור מאליו, לכן בדקו תמיד את סוג ה-grant מול התיעוד של Azure לפני שאתם מסמנים את העבודה כגמורה.

באפליקציות מרובות דיירים, היזהרו משליחת בקשות לנקודת הקצה /common כאשר הדייר היעד דורש מזהה GUID או ערך ספציפי – אחרת ה"פרמטר החסר" שלכם עלול להיות פשוט בקשה שהופנתה למקום הלא נכון. ניתוב בקשות לכתובת שגויה, במיוחד בתרחישים בין-דייריים, יכול לבלבל גם מפתחים מנוסים, ולכן בדקו תמיד את נקודת הקצה והפרמטרים יחד. תקנו את אלה, וברוב המקרים ה-AADSTS900144 המפחיד ייעלם מול העיניים שלכם.

פתרון תקלות בצד הלקוח: ניקוי אישורים שמורים ואיפוס אפליקציות

לפעמים הבעיה היא לא בקוד שלכם, אלא במחשב המקומי שמשבש את תהליך האימות. אישורי גישה שמורים במטמון ועוגיות ישנות יכולים להחזיק אסימונים מיושנים או לפגוע בנתוני הפרמטרים, במיוחד באפליקציות שולחן עבודה כמו Microsoft Teams או Outlook. במצב כזה, המשתמשים ימשיכו לקבל את ההודעה AADSTS900144 גם לאחר שתיקנתם את בעיות צד השרת.

הצעד הראשון והפשוט ביותר הוא ניקוי של אישורי הגישה השמורים. ב-Windows, השתמשו ב-Credential Manager (מנהל האישורים) כדי להסיר כל אסימון שמור המקושר לחשבון שלכם. באפליקציות web, מחיקת העוגיות ונתוני האתר בדפדפן יכולה להניע תהליך אימות מחדש נקי. במקרים עקשניים, במיוחד ב-Microsoft Teams, נסו איפוס מקומי: התנתקו מכל המכשירים, סגרו את האפליקציה ומחקו את תיקיות המטמון לפני הפעלה מחדש. חלק מהמשתמשים יצטרכו למחוק בכוח את פרופיל חשבון Teams מהגדרות המכשיר, כדי לוודא שלא נותרו שאריות, ולאחר מכן להתקין מחדש את Teams מאפס.

אם אתם מסייעים למשתמשים אחרים, ספקו רשימת בדיקה פשוטה: נקו את אישורי הגישה, סגרו את האפליקציה, נקו את המטמון, והתחברו שוב. כך מצמצמים זמן השבתה ובלבול עבור משתמשי העסק, שרוצים פשוט שהאפליקציות שלהם יחזרו לפעול. צוותי תמיכה ב-IT צריכים תמיד לוודא שכל נתוני האימות הישנים נמחקו לפני שהם מתעמקים יותר, שכן שאריות כאלה הן אחת הסיבות המובילות לשגיאות AADSTS900144 מתמשכות.

למי שמתמודד עם ממשל (governance) של Microsoft Teams או עם בעיות אימות חוזרות, כדאי להבין שתיקונים טכניים לבדם לא "פותרים" את נושא הממשל. להעמקה בשאלה מדוע ממשל אף פעם אינו נקודת סיום ואיך להפוך אותו לפרקטי, קראו את המדריך הזה על ממשל Teams ואשליית השליטה, או עיינו במדריך האוטומציה של מחזור החיים של Teams לקבלת אסטרטגיות מעשיות.

שיטות עבודה מומלצות למניעת AADSTS900144 באפליקציות ארגוניות

מניעת השגיאה AADSTS900144 מסתכמת למעשה במשמעת בבקשות OAuth ובתצורת האפליקציות. הפכו להרגל לוודא את כל הפרמטרים הנדרשים, במיוחד client_id ו-grant_type, לפני שליחת בקשות לנקודת הקצה של הטוקנים ב-Azure AD. בדיקות אוטומטיות בצינור הפריסה יכולות לזהות פרמטרים חסרים או פגומים לפני שהם מגיעים לסביבת הייצור, וכך לחסוך הרבה פניות תמיכה בהמשך.

השתמשו בכלי הפיתוח של Microsoft Entra ID כדי לדמות בקשות אימות ולראות מה Azure AD רואה. כך אפשר לאתר לא רק פרמטרים חסרים, אלא גם נקודות קצה לא תואמות או מדיניות שעלולה לחסום בקשות תקינות בדיירים מסוימים. הגדרת בדיקות יחידה עם נקודות קצה מדומות של Entra ID יכולה לצמצם עוד יותר הפתעות, על ידי חשיפת בעיות בפרמטרים בשלב הפיתוח ולא בעת ההשקה.

לארגונים עם ממשל מורכב או צוותי פיתוח מרובים, כדאי לשלב את הבדיקות בפרקטיקות של תשתית כקוד (infrastructure-as-code). השתמשו בבדיקות סכמה בתבניות הפריסה של ARM או Bicep כדי לאכוף הכללה של כל פרמטרי OAuth הנדרשים ברישום האפליקציה. כך מצטמצם הסיכון לסטייה (drift) ולתצורה שגויה, במיוחדככל שהאפליקציות מתפתחות.

לגישה המתמקדת באבטחה, יש להישאר ערניים להענקות הסכמה של OAuth ולאכיפת מדיניות. תוקפים אוהבים לנצל הגדרות הסכמה רופפות, ולכן נעלו את הסכמת המשתמשים, דרשו מפרסמים מאושרים, ואכפו תהליכי אישור של מנהלים. לסקירה מעמיקה של האיומים האלה ושל דרכי ההפחתה, קראו את הניתוח הזה של התקפות הסכמה ב-OAuth בְּ-Entra ID. אם אתם מחדדים תהליכי ממשל, כדאי להשתמש באוטומציה, ב-RBAC ובמדיניות Azure. ראו את מדריך האסטרטגיה הזה לממשל Azure ברמת הארגון לתובנות תכנון ובקרות מעשיות.

Entities in this article

הנושאים של המאמר הזה:

Microsoft Entra ID – כלי זהות ואבטחה של Microsoft Microsoft Azure – פלטפורמת ענן של Microsoft Microsoft Teams – כלי לשיתוף פעולה של Microsoft Application registration – נושא משנה של Microsoft Entra ID Power Platform – כלי Low-Code של Microsoft Governance – מושג HTTP – מושג OAuth 2.0 – מושג

Related articles

מאמרים נוספים על Microsoft Entra ID:

RSS