ใช้ App Check กับผู้ให้บริการแก้ไขข้อบกพร่องในเว็บแอป

หากหลังจากลงทะเบียนแอปสำหรับ App Check แล้ว คุณต้องการเรียกใช้แอปในสภาพแวดล้อมที่ App Check ปกติจะไม่จัดประเภทว่าถูกต้อง เช่น ในเครื่องระหว่างการพัฒนา หรือจากสภาพแวดล้อมการรวมอย่างต่อเนื่อง (CI) คุณสามารถสร้างบิลด์การแก้ไขข้อบกพร่องของแอปที่ใช้ผู้ให้บริการการแก้ไขข้อบกพร่องของ App Check แทนผู้ให้บริการการรับรองจริง

คำเตือน:ผู้ให้บริการการแก้ไขข้อบกพร่องอนุญาตให้เข้าถึงทรัพยากร Firebase จาก อุปกรณ์ที่ไม่ได้ยืนยัน **ห้าม** ใช้ผู้ให้บริการการแก้ไขข้อบกพร่องในบิลด์ที่พร้อมใช้งานจริงของ แอป และ **ห้าม** แชร์บิลด์การแก้ไขข้อบกพร่องกับบุคคลที่สามที่ไม่น่าเชื่อถือ

ใช้ผู้ให้บริการการแก้ไขข้อบกพร่องใน localhost

หากต้องการใช้ผู้ให้บริการการแก้ไขข้อบกพร่องขณะเรียกใช้แอปจาก localhost (เช่น ระหว่างการพัฒนา) ให้ทำดังนี้

คำเตือน: อย่า พยายามเปิดใช้การแก้ไขข้อบกพร่อง localhost โดยการเพิ่ม localhost ลงใน โดเมนที่อนุญาตของ reCAPTCHA การดำเนินการดังกล่าวจะอนุญาตให้ทุกคนเรียกใช้แอปจากเครื่องในเครื่องของตนเอง

1. ในบิลด์การแก้ไขข้อบกพร่อง ให้เปิดใช้โหมดแก้ไขข้อบกพร่องโดยตั้งค่า 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 เวอร์ชันก่อน v9 ระบบจะอ่าน self.FIREBASE_APPCHECK_DEBUG_TOKEN ในเวลาที่นำเข้า ไม่ใช่เวลา เริ่มต้น/เปิดใช้งาน จึงต้องตั้งค่าใน index.html ก่อนที่จะโหลดชุดโค้ด หากต้องการหลีกเลี่ยงข้อจำกัดนี้ ให้อัปเกรดเป็น v9

2. ไปที่เว็บแอปในเครื่องและเปิดเครื่องมือสำหรับนักพัฒนาเว็บของเบราว์เซอร์ คุณจะเห็นโทเค็นการแก้ไขข้อบกพร่องในคอนโซลดีบัก ดังนี้

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

3. ในคอนโซล Firebase ให้ไปที่ความปลอดภัย > App Check

4. ลงทะเบียนโทเค็นการแก้ไขข้อบกพร่องที่คุณเพิ่งบันทึก

   1. ค้นหาแอปในแท็บแอป
   2. จากเมนูรายการเพิ่มเติมของแอป ให้เลือกจัดการโทเค็นการแก้ไขข้อบกพร่อง
   3. ทำตามวิธีการบนหน้าจอเพื่อลงทะเบียนโทเค็นการแก้ไขข้อบกพร่อง

   

หลังจากลงทะเบียนโทเค็นแล้ว บริการแบ็กเอนด์ของ Firebase จะยอมรับโทเค็นดังกล่าวว่าถูกต้อง

เนื่องจากโทเค็นนี้อนุญาตให้เข้าถึงทรัพยากร Firebase ได้โดยไม่ต้องใช้อุปกรณ์ที่ถูกต้อง คุณจึงต้องเก็บโทเค็นนี้ไว้เป็นส่วนตัว อย่าคอมมิตโทเค็นลงในที่เก็บสาธารณะ และหากโทเค็นที่ลงทะเบียนไว้ถูกบุกรุก ให้เพิกถอนโทเค็นนั้น ทันทีในคอนโซล Firebase

ระบบจะจัดเก็บโทเค็นนี้ไว้ในเครื่องในเบราว์เซอร์ และจะใช้โทเค็นนี้ทุกครั้งที่คุณใช้แอปในเบราว์เซอร์เดียวกันบนเครื่องเดียวกัน หากต้องการใช้โทเค็นในเบราว์เซอร์อื่นหรือบนเครื่องอื่น ให้ตั้งค่า self.FIREBASE_APPCHECK_DEBUG_TOKEN เป็นสตริงโทเค็นแทน true

ใช้ผู้ให้บริการการแก้ไขข้อบกพร่องในสภาพแวดล้อม CI

หากต้องการใช้ผู้ให้บริการการแก้ไขข้อบกพร่องในสภาพแวดล้อมการรวมอย่างต่อเนื่อง (CI) ให้ทำดังนี้

1. ในคอนโซล Firebase ให้ไปที่ ความปลอดภัย > App Check > แอป

2. สร้างโทเค็นการแก้ไขข้อบกพร่อง คุณจะต้องใช้โทเค็นนี้ในขั้นตอนถัดไป

   1. จากเมนูรายการเพิ่มเติมของแอป ให้เลือกจัดการโทเค็นการแก้ไขข้อบกพร่อง
   2. ทำตามวิธีการบนหน้าจอเพื่อสร้างโทเค็นการแก้ไขข้อบกพร่องใหม่

   เนื่องจากโทเค็นนี้อนุญาตให้เข้าถึงทรัพยากร Firebase ได้โดยไม่ต้องใช้อุปกรณ์ที่ถูกต้อง คุณจึงต้องเก็บโทเค็นนี้ไว้เป็นส่วนตัว อย่าคอมมิตโทเค็นลงในที่เก็บสาธารณะ และหากโทเค็นที่ลงทะเบียนไว้ถูกบุกรุก ให้เพิกถอนโทเค็นนั้น ทันทีในคอนโซล Firebase

   

3. เพิ่มโทเค็นการแก้ไขข้อบกพร่องที่คุณเพิ่งสร้างลงในที่เก็บคีย์ที่ปลอดภัยของระบบ CI (เช่น ความลับที่เข้ารหัสของ GitHub Actions หรือตัวแปรที่เข้ารหัสของ Travis CI)

4. หากจำเป็น ให้กำหนดค่าระบบ CI เพื่อให้โทเค็นการแก้ไขข้อบกพร่องพร้อมใช้งานภายในสภาพแวดล้อม CI เป็นตัวแปรสภาพแวดล้อม ตั้งชื่อตัวแปร เช่น APP_CHECK_DEBUG_TOKEN_FROM_CI

5. ในบิลด์การแก้ไขข้อบกพร่อง ให้เปิดใช้โหมดแก้ไขข้อบกพร่องโดยตั้งค่า 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 จะยอมรับโทเค็นที่แอปส่งมาว่าถูกต้อง