Sử dụng tính năng Kiểm tra ứng dụng với trình cung cấp gỡ lỗi trên các nền tảng của Apple

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ư trình mô phỏng hoặc thiết 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)), bạn có thể tạo bản gỡ lỗi của ứng dụng sử dụng nhà cung cấp gỡ lỗi App Check thay vì nhà cung cấp 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 các tài nguyên Firebase từ các thiết bị chưa được xác minh. Đừng sử dụng nhà cung cấp gỡ lỗi trong các bản phát hành chính thức của ứng dụng và cẩn thận để không làm rò rỉ mã thông báo gỡ lỗi.

Sử dụng nhà cung cấp gỡ lỗi trong quá trình phát triển

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

1. Trong bản gỡ lỗi, trước khi sử dụng bất kỳ dịch vụ phụ trợ nào của Firebase, hãy tạo và đặt nhà máy nhà cung cấp gỡ lỗi App Check:

   Swift

   let providerFactory = AppCheckDebugProviderFactory()
   AppCheck.setAppCheckProviderFactory(providerFactory)
   
   FirebaseApp.configure()

   Objective-C

   FIRAppCheckDebugProviderFactory *providerFactory =
         [[FIRAppCheckDebugProviderFactory alloc] init];
   [FIRAppCheck setAppCheckProviderFactory:providerFactory];
   
   // Use Firebase library to configure APIs
   [FIRApp configure];

2. Khởi chạy ứng dụng. Mã thông báo gỡ lỗi cục bộ sẽ được ghi lại khi SDK cố gắng gửi yêu cầu đến phần phụ trợ. Ví dụ:

   <Warning> [AppCheckCore][I-GAC004001] App Check debug token:
   '123a4567-b89c-12d3-e456-789012345678'.

3. Trong bảng điều khiển Firebase, hãy chuyển đến phần Bảo mật > Kiểm tra ứng dụng.

4. Đăng ký mã thông báo gỡ lỗi mà bạn vừa ghi lại.

   1. Trong thẻ Ứng dụng, hãy tìm ứng dụng của bạn.
   2. Trong trình đơn khác của ứng dụng, hãy chọn Quản lý mã thông báo gỡ lỗi.
   3. Làm theo hướng dẫn trên màn hình để đăng ký mã thông báo gỡ lỗi.

   

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 các tài nguyên Firebase mà không cần thiết bị hợp lệ, nên bạn phải giữ mã thông báo này ở chế độ riêng tư. Đừng cam kết mã thông báo này vào 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 ngay mã thông báo đó trong bảng điều khiển Firebase.

Mẹo: Bạn cần mã thông báo gỡ lỗi mới? Nếu bạn cần tạo lại mã thông báo gỡ lỗi (ví dụ: nếu bạn đã thu hồi mã thông báo trước đó trong Firebase bảng điều khiển), hãy gỡ cài đặt rồi cài đặt lại ứng dụng trên thiết bị hoặc trình mô phỏng. Thao tác này sẽ xoá bộ nhớ cục bộ và nhắc SDK tạo mã thông báo mới trong lần khởi chạy tiếp theo.

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

Để sử dụng 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 bảng điều khiển Firebase, hãy chuyển đến phần Bảo mật > Kiểm tra ứng dụng > Ứng dụng.

2. Tạo mã thông báo gỡ lỗi. Bạn sẽ cần mã thông báo này trong bước tiếp theo.

   1. Trong trình đơn khác của ứng dụng, hãy chọn Quản lý mã thông báo gỡ lỗi.
   2. Làm theo hướng dẫn trên màn hình để tạo mã thông báo gỡ lỗi mới.

   Vì mã thông báo này cho phép truy cập vào các tài nguyên Firebase mà không cần thiết bị hợp lệ, nên bạn phải giữ mã thông báo này ở chế độ riêng tư. Đừng cam kết mã thông báo này vào 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 ngay mã thông báo đó trong bảng điều khiển Firebase.

   

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

4. 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 biến là APP_CHECK_DEBUG_TOKEN_FROM_CI.

5. Trong Xcode, hãy thêm biến môi trường vào giản đồ kiểm thử có tên là AppCheckDebugToken và giá trị như $(APP_CHECK_DEBUG_TOKEN).

6. Định cấu hình kịch bản kiểm tra CI để truyền mã thông báo gỡ lỗi dưới dạng biến môi trường. Ví dụ:

   xcodebuild test -scheme YourTestScheme -workspace YourProject.xcworkspace \
   APP_CHECK_DEBUG_TOKEN=$(APP_CHECK_DEBUG_TOKEN_FROM_CI)

7. Trong bản gỡ lỗi, trước khi sử dụng bất kỳ dịch vụ phụ trợ nào của Firebase, hãy tạo và đặt nhà máy nhà cung cấp gỡ lỗi App Check:

   Swift

   let providerFactory = AppCheckDebugProviderFactory()
   AppCheck.setAppCheckProviderFactory(providerFactory)
   
   FirebaseApp.configure()

   Objective-C

   FIRAppCheckDebugProviderFactory *providerFactory =
         [[FIRAppCheckDebugProviderFactory alloc] init];
   [FIRAppCheck setAppCheckProviderFactory:providerFactory];
   
   // Use Firebase library to configure APIs
   [FIRApp configure];

Khi ứng dụng 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ệ.