תיקון שגיאות JWT לא תקין (AADSTS700025) ב-Azure AD
By Mirko Peters ·
אם נתקלתם בשגיאה AADSTS700025 – המוכרת גם כהודעת “invalid JWT” המעוררת חרדה – במהלך אימות ב-Azure Active Directory, אתם לא לבד. הבעיה הזו פוגעת בכניסות למערכת ובגישה ל-API, וחוסמת התחברויות כאשר הטוקנים אינם עוברים בדיקה. הבנת השגיאה הזו חיונית לכל מי שבונה, מנהל או מאבטח יישומים של Microsoft, בין שאתם מפעילים כלים פנימיים ובין שאתם מפעילים פורטלים הפונים ללקוחות.
Automatically translated with AI from the original post. Read the English original

כאן תקבלו סקירה מלאה של המשמעות האמיתית של AADSTS700025, הסיבות המעשיות והטעויות הנפוצות שמפילות את בדיקת האישורים, והנחיות מעשיות לפענוח ולאימות ה-JWT שלכם. המטרה: לאתר את שורש הבעיה מהר יותר, לפתור אותה לצמיתות ולמנוע את התקלות האלה בעתיד. בואו נתחיל ונפרק את שגיאות האימות, כדי שהכול יחזור לעבוד – בצורה מאובטחת וחכמה.
כאן תקבלו את העיקר על מה שAADSTS700025 באמת אומר, הסיבות המעשיות והטעויות שמפילות אימות אישורים, והנחיות מעשיות לפענוח ולאימות ה-JWT שלכם. המטרה? לעזור לכם לאתר את שורש הבעיה מהר יותר, לתקן אותה סופית ולמנוע את התקלות האלה בעתיד. בואו נתחיל לעבוד ונפרק את שגיאות האימות, כדי שתוכלו להחזיר הכול לפעולה – בצורה מאובטחת וחכמה.
שגיאת AADSTS700025 היא הדרך של Azure AD לומר: “רגע, הטוקן הזה לא עובר בדיקה.” היא מופיעה כאשר היישום או השירות שלכם מנסים להתחבר באמצעות JWT (JSON Web Token) שאין ל-Azure AD סיבה לתת בו אמון. בפרוטוקול האימות, המשמעות בדרך כלל היא שחתימת הטוקן אינה תקפה, ולכן Azure מסמן זאת כאירוע אבטחה וסוגר את הדלת בפני הכניסה או בפני קריאת ה-API שלכם.
סביר מאוד שתראו את השגיאה הזו בזרימות OAuth 2.0 או OpenID Connect, ממש ברגע שבו Azure AD מקבל טוקן ומנסה לאמת אותו. Microsoft משתמשת בקודי “aadsts” כקיצור שמסמן בדיוק מה השתבש, והקוד 700025 מתייחס במפורש לכישלון באימות חתימת ה-JWT. אם הלקוח, ה-API או ה-middleware שלכם אינם מייצרים טוקן ש-Azure מזהה ומכיר כמהימן, זו השגיאה שתקבלו.
“חתימת JWT לא תקינה” כמעט תמיד מעידה על משהו שקרה בדרך שבה הטוקן נוצר, עוצב או נחתם. או שהסוד, התעודה או אלגוריתם החתימה אינם תואמים למה ש-Azure AD מצפה לו – או שהתוכן (payload) שונה בדרך. ניתן לחפש את הקודים האלה באתר חיפוש השגיאות של Microsoft או בתיעוד שלה, אך האבחון תמיד זהה: הטוקן אינו ניתן לאימות, ולכן האימות נעצר לגמרי.
בקצרה, אם משתמש או שירות נתקלים ב-AADSTS700025, Azure AD אומר בעצם: “אני לא מאמין שהאדם הזה הוא מי שהוא טוען שהוא, אז אין מצב.” לכן איתור הסיבה לטוקן JWT לא תקין הוא קריטי כדי לשמור על האפליקציות והנתונים שלכם מאובטחים – וכדי שהמשתמשים שלכם ימשיכו להיות מרוצים.
בקצרה, אם המשתמש או השירות שלכם נתקלים ב-AADSTS700025, Azure AD אומרת לכם: "אני לא מאמינה שהאדם הזה הוא מי שהוא טוען שהוא, ולכן אין אישור." לכן איתור הסיבה לאסימון JWT לא תקין הוא קריטי לשמירה על האפליקציות והנתונים שלכם מאובטחים – וגם על שביעות הרצון של המשתמשים.
רוב הכשלים של AADSTS700025 נובעים from מספר קטן של טעויות קלות לפספוס בדרך שבה היישום שלכם מטפל באישורים. אם אתם משתמשים בסודות לקוח, בתעודות או ב-assertions, גם החלקה קלה יכולה להוביל לטוקן ש-Azure AD דוחה על הסף. שגיאות הקלדה, סודות שפג תוקפם או טביעות אצבע של תעודות שאינן תואמות הם הגורמים המובילים לטוקנים פגומים – או פשוט לא תקינים.
רוב הכשלים של AADSTS700025 נובעים from מספר קטן של טעויות קלות לפספוס באופן שבו האפליקציה מטפלת באישורים. אם אתם משתמשים ב-client secrets, בתעודות או ב-assertions, גם טעות קטנה עלולה לגרום לכך ש-Azure AD תדחה את האסימון מיד. שגיאות הקלדה, סודות שפג תוקפם, או טביעות אצבע של תעודות שאינן תואמות הן הגורמים העיקריים ל-JWT פגום או פשוט לא תקין.
בתהליכים כמו clientsecretcredential, clientcertificatecredential או clientassertioncredential, חשוב מאוד להגדיר נכון את תצורת האישורים. רווח מיותר אחד, מפתח שאינו תואם או אי-התאמה באלגוריתם החתימה – ו-Azure תפסול את הבקשה. מפתחים נוטים לטעות גם בקידוד קשיח או בהעתקה של סודות, בשינויים בספריות, או בכתיבת קוד מותאם אישית להנפקת טוקנים שמתעלם מ-claims נדרשים או מהגדרות רישום האפליקציה.
לפתרון תקלות, התחילו מבדיקה כפולה של מקור האישורים: ודאו שהסודות לא פגי תוקף, שהתעודות בתוקף ושהן מאוחסנות במקום שהקוד שלכם מצפה לו. בדקו את רישום האפליקציה לאיתור שינויים או שגיאות בהגדרות הפורטל של Azure, במיוחד כתובות הפניה מחדש ותאריכי תפוגה של מפתחות. הבדיקות האלה פותרות את רוב המקרים, וחוסכות שעות של ניפוי שגיאות מתיש בהמשך הדרך.
לצורך פתרון תקלות, התחילו בבדיקה כפולה של מקור האישורים: ודאו שהסודות לא פג תוקפם ושהתעודות תקפות ומאוחסנות במקום שהקוד שלכם מצפה לו. סרקו את רישום האפליקציה לאיתור שינויים או שגיאות בהגדרות פורטל Azure, במיוחד כתובות הפניה מחדש ותוקף המפתחות. הבדיקות האלה פותרות את רוב המקרים, וחוסכות מכם סשנים ארוכים של דיבוג בהמשך.
פענוח ואימות של JWT של Azure AD בזמן אמת
אחת הטעויות הנפוצות היא לנחש מה לא בסדר עם ה-JWT שלכם. אפשר לקחת את הטוקן ולבדוק אותו בעצמכם, עכשיו ממש. כלים כמו jwt.io מקלים על כך: מעתיקים את הטוקן שהונפק על ידי Azure, מדביקים אותו, ומיד רואים את ה-payload ומאמתים את החתימה, ה-claims, האלגוריתמים ותאריכי התפוגה. זו הדרך המהירה ביותר לזהות claims חסרים או לבדוק אם יש אי-התאמה ברורה בחתימה.
צעד אחד קדימה, למי שמעדיף עבודה ידנית: אפשר לפענח ולאמת טוקנים גם באופן תכנותי. ב-Node.js אפשר להשתמש בספריות כמו jsonwebtoken כדי לנתח את הטוקן ולבדוק אותו מול המפתחות הציבוריים של Azure, שנמצאים בהגדרות ה-OpenID שלה. מפתחי Python יכולים להשתמש ב-PyJWT לאותה מטרה. מורידים את ה-JWKs (JSON Web Keys), ואז מוודאים שהטוקן חתום כראוי ושלא פג תוקפו.
הטכניקות האלה עוזרות לזהות בעיות כמו clock skew (מצב שבו זמני ה-iat או ה-exp בטוקן אינם תואמים לשעון השרת), authority שגוי או חתימה פגומה. ואם שעון המערכת שלכם לא מסונכרן, למשל כשאתם מריצים Docker או Kubernetes, טוקנים שנראים תקינים במקום אחר עלולים עדיין להיכשל באימות מבחינתה של Azure. בדקו תמיד גם את השעון וגם את ה-claims!
בשורה התחתונה, פענוח הטוקנים בעצמכם מעמיד אתכם בשליטה. אפשר לאתר בעיות ולתקן אותן הרבה יותר מהר מאשר לנסות לגעת בהגדרות או באישורי הגישה באופן אקראי, ולהימנע מסבבים של דיבוג "ניסוי וטעייה" שמוציא את הסבלנות שלכם ושל כל מי שבצוות.
מניעת AADSTS700025: שיטות עבודה מומלצות, טיפול בשגיאות וקבלת עזרה מהקהילה
רוצים להימנע מבעיות JWT לא תקינות עוד לפני שהן מתחילות? הדרך החכמה ביותר היא להסתמך על ספריות רשמיות של Microsoft, כמו MSAL או ה-Azure SDKs, לטיפול ביצירת הטוקנים. בכלים האלה כבר מובנות כל דרישות החתימה, הפורמט וה-claims, כך שלא תצטרכו להמציא מחדש את הגלגל (או לטעות בתיקון גלגל).
הקוד שלכם צריך תמיד לזהות ולטפל בשגיאות אימות בצורה מחושבת. בנו לוגים מובנים לכל כניסה שנכשלה, וודאו שבלוקי ה-catch חושפים את aadsts codes כדי שתוכלו לפעול לפיהם. אל תבלעו חריגות בשקט ואל תציגו הודעות כשל גנריות. כך תחסכו זמן יקר כשמשהו משתבש, ותקבלו תיעוד שאפשר להציג למנהלים או לתמיכה של Microsoft.
הרגל מרכזי נוסף הוא בדיקות תדירות של אישורי הגישה ורישומי האפליקציות. סבבו סודות ותעודות לפני פקיעת תוקפם, אמתו כתובות Reply URL, ושימו לב לאי-התאמות באלגוריתמי החתימה (RS256 לעומת HS256). לארגונים גדולים יותר כדאי להקים תהליכים אוטומטיים או מדיניות ממשל, כמו אלה שנדונו במדריך אסטרטגיית הממשל של Azure הזה, כדי לשמור על רישומי האפליקציות והטוקנים מאובטחים ומעודכנים.
ואם נתקעתם, אתם בהחלט לא לבד. ל-GitHub יש ים של קוד לדוגמה מבית Microsoft ומהקהילה. חפשו בעיות שדווחו או שתפו את ה-stacktrace שלכם כדי לגלות תיקונים מהירים. הפורומים של Microsoft וערוצי המשוב שלה מאפשרים לדווח על דפוסי שגיאות AADSTS ולעיין בבעיות ידועות. השתמשו ברשתות האלה כדי לגייס פתרונות מהקהל, לחדד את כישורי פתרון הבעיות שלכם, ולוודא שה-JWTs שלכם נקיים לגמרי בפעם הבאה.