Sử dụng tính năng Kiểm tra ứng dụng bằng trình cung cấp gỡ lỗi trong các ứng dụng web

Nếu sau khi đã đăng ký ứng dụng cho App Check, bạn muốn chạy ứng dụng trong một môi trường mà App Check thường không phân loại là hợp lệ (chẳng hạn như cục bộ trong quá trình phát triển) hoặc từ môi trường tích hợp liên tục (CI), thì bạn có thể tạo một bản gỡ lỗi của ứng dụng sử dụng trình cung cấp dịch vụ gỡ lỗi App Check thay vì nhà cung cấp dịch vụ chứng thực thực.

Cảnh báo: Nhà cung cấp gỡ lỗi cho phép truy cập vào tài nguyên Firebase của bạn từ các thiết bị chưa được xác minh. Không sử dụng trình cung cấp gỡ lỗi trong các bản dựng chính thức của ứng dụng và không chia sẻ bản gỡ lỗi với các bên không đáng tin cậy.

Sử dụng trình cung cấp dịch vụ gỡ lỗi trên localhost

Để sử dụng trình cung cấp gỡ lỗi trong khi chạy ứng dụng từ localhost (ví dụ: trong quá trình phát triển), hãy làm như sau:

Cảnh báo: Đừng cố gắng bật tính năng gỡ lỗi localhost bằng cách thêm localhost vào các miền được phép của reCAPTCHA. Làm như vậy sẽ cho phép tất cả mọi người chạy ứng dụng của bạn từ các máy cục bộ của họ!

1. Trong bản gỡ lỗi, hãy bật chế độ gỡ lỗi bằng cách đặt self.FIREBASE_APPCHECK_DEBUG_TOKEN thành true trước khi khởi chạy App Check. Ví dụ:

   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 */);
   

   Lưu ý: Trong các phiên bản SDK Web của Firebase trước phiên bản 9, self.FIREBASE_APPCHECK_DEBUG_TOKEN được đọc tại thời điểm nhập và không được đọc tại thời điểm khởi chạy/kích hoạt. Bạn phải đặt thuộc tính này trong index.html trước khi tải gói mã. Để tránh quy định hạn chế này, hãy nâng cấp lên phiên bản 9.

2. Truy cập vào ứng dụng web của bạn trên máy tính rồi mở công cụ cho nhà phát triển của trình duyệt. Trong bảng điều khiển gỡ lỗi, bạn sẽ thấy một mã thông báo gỡ lỗi:

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

3. Trong phần App Check của bảng điều khiển Firebase, hãy chọn Quản lý mã thông báo gỡ lỗi trong trình đơn mục bổ sung của ứng dụng. Sau đó, hãy đăng ký mã thông báo gỡ lỗi mà bạn đã đăng nhập ở bước trước.

   

Sau khi bạn đăng ký mã thông báo, các dịch vụ phụ trợ của Firebase sẽ chấp nhận mã thông báo đó là hợp lệ.

Vì mã thông báo này cho phép truy cập vào tài nguyên Firebase của bạn mà không cần có thiết bị hợp lệ, nên bạn phải bảo mật mã đó. Đừng cam kết mã thông báo này với một kho lưu trữ công khai và nếu mã thông báo đã đăng ký bị xâm phạm, hãy thu hồi mã thông báo đó ngay lập tức trong bảng điều khiển Firebase.

Mã thông báo này được lưu trữ cục bộ trong trình duyệt và sẽ được dùng bất cứ khi nào bạn sử dụng ứng dụng trong cùng một trình duyệt trên cùng một máy. Nếu bạn muốn sử dụng mã thông báo này trong một trình duyệt khác hoặc trên một máy khác, hãy đặt self.FIREBASE_APPCHECK_DEBUG_TOKEN thành chuỗi mã thông báo thay vì true.

Sử dụng trình cung cấp gỡ lỗi trong môi trường CI

Để sử dụng trình cung cấp gỡ lỗi trong môi trường tích hợp liên tục (CI), hãy làm như sau:

1. Trong phần App Check của bảng điều khiển Firebase, hãy chọn Quản lý mã thông báo gỡ lỗi trong trình đơn mục bổ sung của ứng dụng. Sau đó, hãy tạo một mã gỡ lỗi mới. Bạn sẽ cần mã thông báo này ở bước tiếp theo.

   Vì mã thông báo này cho phép truy cập vào tài nguyên Firebase của bạn mà không cần có thiết bị hợp lệ, nên bạn cần phải bảo mật mã đó. Đừng cam kết mã thông báo này với một kho lưu trữ công khai và nếu mã thông báo đã đăng ký bị xâm phạm, hãy thu hồi mã thông báo đó ngay lập tức trong bảng điều khiển Firebase.

   

2. Thêm mã thông báo gỡ lỗi bạn vừa tạo vào kho khoá bảo mật của hệ thống CI (ví dụ: bí mật đã mã hoá của GitHub Actions hoặc biến đã mã hoá của Travis CI).

3. Nếu cần, hãy định cấu hình hệ thống CI để cung cấp mã thông báo gỡ lỗi trong môi trường CI dưới dạng biến môi trường. Đặt tên cho biến, chẳng hạn như APP_CHECK_DEBUG_TOKEN_FROM_CI.

4. Trong bản dựng gỡ lỗi, hãy bật chế độ gỡ lỗi bằng cách đặt self.FIREBASE_APPCHECK_DEBUG_TOKEN thành giá trị của biến môi trường mã thông báo gỡ lỗi trước khi bạn nhập App Check. Ví dụ:

   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 */);
   

Khi ứng dụng của bạn chạy trong môi trường CI, các dịch vụ phụ trợ của Firebase sẽ chấp nhận mã thông báo mà ứng dụng gửi là hợp lệ.