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

אם אחרי הרשמת האפליקציה ל-App Check, אתם רוצים להריץ את האפליקציה בסביבה שבדרך כלל App Check לא מסווגת כתקינה, למשל בסביבה המקומית במהלך הפיתוח או מסביבת שילוב רצוף (CI), תוכלו ליצור גרסה לניפוי באגים של האפליקציה שמשתמשת בספק ניפוי הבאגים של App Check במקום בספק אימות אמיתי.

אזהרה: ספק ניפוי הבאגים מאפשר גישה למשאבי Firebase ממכשירים לא מאומתים. לא מומלץ להשתמש בספק ניפוי הבאגים בגרסאות build של האפליקציה בסביבת הייצור, ולא לשתף את גרסאות ה-build של ניפוי הבאגים עם גורמים לא מהימנים.

שימוש בספק ניפוי הבאגים ב-localhost

כדי להשתמש בספק ניפוי הבאגים בזמן הפעלת האפליקציה מ-localhost (לדוגמה, במהלך הפיתוח), מבצעים את הפעולות הבאות:

אזהרה: אין לנסות להפעיל את ניפוי הבאגים של localhost על ידי הוספת localhost לדומיינים המורשים של reCAPTCHA. כך כולם יוכלו להריץ את האפליקציה שלכם מהמכונות המקומיות שלהם.

1. ב-debug build, מפעילים את מצב ניפוי הבאגים על ידי הגדרת self.FIREBASE_APPCHECK_DEBUG_TOKEN ל-true לפני שמפעילים את App Check. לדוגמה:

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
   initializeAppCheck(app, { /* App Check options */ });
   

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;
   firebase.appCheck().activate(/* site key or provider */);
   

   הערה: בגרסאות קודמות של Firebase Web SDK, הערך של self.FIREBASE_APPCHECK_DEBUG_TOKEN נקרא בזמן הייבוא ולא בזמן האינטראליזציה או ההפעלה. לשם כך, צריך להגדיר אותו ב-index.html לפני טעינת חבילת הקוד. כדי להימנע מההגבלה הזו, צריך לשדרג לגרסה 9.

2. נכנסים לאפליקציית האינטרנט באופן מקומי ופותחים את הכלי למפתחים בדפדפן. במסוף ניפוי הבאגים יופיע אסימון ניפוי באגים:

   AppCheck debug token: "123a4567-b89c-12d3-e456-789012345678". You will
   need to safelist it in the Firebase console for it to work.

3. בקטע App Check במסוף Firebase, בוחרים באפשרות Manage debug tokens בתפריט ההזזה למעלה של האפליקציה. לאחר מכן רושמים את האסימון לניפוי באגים שיצרתם בשלב הקודם.

   

לאחר רישום האסימון, השירותים לקצה העורפי של Firebase יקבלו אותו כחוקי.

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

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

שימוש בספק ניפוי הבאגים בסביבת CI

כדי להשתמש בספק ניפוי הבאגים בסביבת אינטגרציה רציפה (CI):

1. בקטע App Check במסוף Firebase, בוחרים באפשרות Manage debug tokens בתפריט ההזזה למעלה של האפליקציה. לאחר מכן, יוצרים טוקן ניפוי באגים חדש. האסימון נדרש בשלב הבא.

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

   

2. מוסיפים את אסימון ניפוי הבאגים שיצרתם למאגר המפתחות המאובטח של מערכת ה-CI (לדוגמה, סודות מוצפנים של GitHub Actions או משתנים מוצפנים של Travis CI).

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

4. ב-build של ניפוי הבאגים, מפעילים את מצב ניפוי הבאגים על ידי הגדרת self.FIREBASE_APPCHECK_DEBUG_TOKEN לערך של משתנה הסביבה של האסימון לניפוי באגים לפני הייבוא של App Check. לדוגמה:

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = process.env.APP_CHECK_DEBUG_TOKEN_FROM_CI;
   initializeAppCheck(app, { /* App Check options */ });
   

   Web

   self.FIREBASE_APPCHECK_DEBUG_TOKEN = process.env.APP_CHECK_DEBUG_TOKEN_FROM_CI;
   firebase.appCheck().activate(/* site key or provider */);
   

כשהאפליקציה שלכם פועלת בסביבת CI, השירותים לקצה העורפי של Firebase יקבלו את האסימון שהוא שולח כתקף.