בדף הזה מוסבר איך להשתמש בפרמטרים של שאילתות ובכותרות של שרת proxy לאימות זהות (IAP) כדי לשפר את ממשק המשתמש של האפליקציה או לספק אפשרויות לפתרון בעיות.
פרמטרים של שאילתה
אפשר לבצע פעולות שונות על ידי הגדרת הפרמטר gcp-iap-mode במחרוזת השאילתה של כתובת ה-URL.
אפשר לכלול את הפרמטרים האלה של השאילתה בכל נתיב, לא רק בכתובת ה-URL הבסיסית.
העברת זהות המשתמש
העברת ערך הפרמטר הבא מחזירה מילון JSON עם זהות המשתמש:
YOUR_APP_URL?gcp-iap-mode=IDENTITY
{"email":"accounts.google.com:USER_EMAIL","sub":"accounts.google.com:118133858486581853996"}
הערך הזה יכול לעזור לכם להתאים אישית את האפליקציה, למשל להציג את שם המשתמש, להעביר את הזהות לדף אחר או לתעד את נתוני השימוש ביומנים.
ניקוי פרטי ההתחברות של המשתמש
ערך הפרמטר הבא מוחק את קובץ ה-cookie של ההתחברות ל-IAP:
YOUR_APP_URL?gcp-iap-mode=CLEAR_LOGIN_COOKIE
העברת הפרמטר הזה מנקה את כל קובצי ה-Cookie שהונפקו על ידי IAP לאפליקציה, ומעבירה את הדפדפן אל YOUR_APP_URL. אם בדפדפן יש סשן תקין עם ספק הזהויות (IdP) של האפליקציה, יכול להיות שתתבצע כניסה שקטה אם יש רק חשבון אחד בשימוש עם ספק הזהויות. אם אתם משתמשים בכמה חשבונות, ייפתח דף לבחירת חשבון כדי שתוכלו להחליף פרופיל.
בדיקת אימות JWT
כדי לעזור לכם לבדוק את לוגיקת האימות של ה-JWT, IAP מעביר אסימוני JWT לא תקינים לדפי אינטרנט לבדיקה.
לדוגמה, IAP מעביר JWT עם חתימה לא חוקית לכל בקשה שמכילה את הפרמטרים של השאילתה gcp-iap-mode=SECURE_TOKEN_TEST ו-iap-secure-token-test-type=SIGNATURE.
לוגיקת האימות אמורה לזהות את החתימה הלא חוקית.
כדי לבדוק את לוגיקת האימות מול כל אחד מהתרחישים הבאים, צריך להוסיף את הפרמטרים המתאימים לבקשה.
| פרמטרים | מקרה בדיקה |
|---|---|
| ?gcp-iap-mode=SECURE_TOKEN_TEST&iap-secure-token-test-type=NOT_SET | JWT תקין. |
| ?gcp-iap-mode=SECURE_TOKEN_TEST&iap-secure-token-test-type=FUTURE_ISSUE | תאריך ההנפקה הוא תאריך עתידי. |
| ?gcp-iap-mode=SECURE_TOKEN_TEST&iap-secure-token-test-type=PAST_EXPIRATION | תאריך התפוגה שהוגדר כבר עבר. |
| ?gcp-iap-mode=SECURE_TOKEN_TEST&iap-secure-token-test-type=ISSUER | המנפיק שגוי. |
| ?gcp-iap-mode=SECURE_TOKEN_TEST&iap-secure-token-test-type=AUDIENCE | קהל לא נכון. |
| ?gcp-iap-mode=SECURE_TOKEN_TEST&iap-secure-token-test-type=SIGNATURE | החתימה בוצעה באמצעות חותם שגוי. |
כותרות מיוחדות
זיהוי תשובות מ-IAP
כש-IAP יוצר תגובת HTTP, למשל כשהוא דוחה גישה (403) או מבקש אימות (302 או 401), הוא מוסיף את כותרת תגובת ה-HTTP X-Goog-IAP-Generated-Response. אם מזהים את הכותרת הזו, אפשר לבצע פעולות כמו:
להבחין בין הודעות שגיאה שנוצרו על ידי IAP לבין הודעות שגיאה שנוצרו על ידי האפליקציה.
זיהוי מקרים שבהם צריך להוסיף פרטי כניסה של IAP לבקשה.