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 trình cung cấp gỡ lỗi App Check thay vì trình cung cấp chứng thực thực.

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

Để sử dụng trình cung cấp gỡ lỗi trong khi chạy ứng dụng theo 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 dựng gỡ lỗi, trước khi sử dụng bất kỳ dịch vụ phụ trợ Firebase nào, hãy tạo và thiết lập nhà máy trì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. Bật tính năng ghi nhật ký gỡ lỗi trong dự án Xcode (phiên bản 11.0 trở lên):

    1. Mở Product (Sản phẩm) > Scheme (Lược đồ) > Edit scheme (Chỉnh sửa lược đồ).
    2. Chọn Run (Chạy) trong trình đơn bên trái, rồi chọn thẻ Arguments (Đối số).
    3. Trong phần Arguments Passed on Launch (Đối số được truyền khi khởi chạy), hãy thêm -FIRDebugEnabled.

  3. 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ụ:

    [Firebase/AppCheck][I-FAA001001] Firebase App Check Debug Token:
123a4567-b89c-12d3-e456-789012345678

  4. 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.

    Ảnh chụp màn hình mục trong trình đơn Manage Debug Tokens (Quản lý 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 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ớ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.

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ã thông báo 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 mà không cần thiết bị hợp lệ, nên bạn cần phải giữ bí mật mã thông báo này. Đừ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.

    Ảnh chụp màn hình mục trong trình đơn Manage Debug Tokens (Quản lý mã thông báo gỡ lỗi)

  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 như APP_CHECK_DEBUG_TOKEN_FROM_CI.

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

  5. Định cấu hình tập lệnh kiểm thử 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)

  6. Trong bản dựng gỡ lỗi, trước khi sử dụng bất kỳ dịch vụ phụ trợ Firebase nào, hãy tạo và thiết lập nhà máy trì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 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ệ.