Bắt đầu sử dụng tính năng Kiểm tra ứng dụng bằng App Attest (Chứng thực ứng dụng) trên các nền tảng của Apple

Trang này cho bạn biết cách bật tính năng Kiểm tra ứng dụng trong một ứng dụng của Apple bằng tích hợp sẵn tính năng Kiểm thử ứng dụng. Khi bật tính năng Kiểm tra ứng dụng, bạn sẽ giúp đảm bảo rằng chỉ ứng dụng của bạn mới có thể truy cập vào tài nguyên Firebase của dự án. Xem Tổng quan về tính năng này.

Tính năng Kiểm tra ứng dụng sử dụng App Attest (Kiểm chứng ứng dụng) để xác minh rằng các yêu cầu đối với dịch vụ Firebase đến từ ứng dụng chính thống của bạn. Tính năng Kiểm tra ứng dụng hiện không sử dụng tính năng Chứng thực ứng dụng để phân tích rủi ro gian lận.

Nếu bạn muốn sử dụng tính năng Kiểm tra ứng dụng với nhà cung cấp tuỳ chỉnh của riêng mình, hãy xem Triển khai một trình cung cấp tính năng Kiểm tra ứng dụng tuỳ chỉnh.

1. Thiết lập dự án Firebase

1. Bạn sẽ cần Xcode 12.5 trở lên để sử dụng App Attest.

2. Thêm Firebase vào dự án Apple của bạn nếu bạn chưa thêm đã làm như vậy.

3. Đăng ký ứng dụng của bạn để sử dụng tính năng Kiểm tra ứng dụng với nhà cung cấp Kiểm thử ứng dụng trong Phần Kiểm tra ứng dụng của bảng điều khiển của Firebase.

   Thông thường, bạn cần đăng ký tất cả các ứng dụng trong dự án của mình, vì một khi bạn cho phép thực thi cho một sản phẩm Firebase, thì chỉ những ứng dụng đã đăng ký mới có thể để truy cập vào tài nguyên phụ trợ của sản phẩm.

4. Không bắt buộc: Trong phần cài đặt đăng ký ứng dụng, hãy đặt thời gian tồn tại tuỳ chỉnh (TTL) cho mã thông báo Kiểm tra ứng dụng do nhà cung cấp cấp. Bạn có thể đặt TTL thành bất kỳ giá trị nào trong khoảng từ 30 phút đến 7 ngày. Khi thay đổi giá trị này, hãy cũng cần lưu ý những yếu tố đánh đổi sau:

   • Bảo mật: TTL ngắn hơn mang lại khả năng bảo mật mạnh mẽ hơn vì giúp giảm trong đó một mã thông báo bị rò rỉ hoặc bị chặn có thể bị kẻ tấn công lạm dụng kẻ tấn công.
   • Hiệu suất: TTL ngắn hơn đồng nghĩa với việc ứng dụng của bạn sẽ thực hiện quy trình chứng thực nhiều hơn thường xuyên. Vì quy trình chứng thực ứng dụng sẽ làm tăng độ trễ của mạng mỗi khi được thực hiện, thì một TTL ngắn có thể ảnh hưởng đến hiệu suất ứng dụng của bạn.
   • Hạn mức và chi phí: TTL ngắn hơn và việc chứng thực lại thường xuyên sẽ làm cạn kiệt tài nguyên hạn mức nhanh hơn. Còn đối với các dịch vụ có tính phí, chi phí có thể cao hơn. Xem phần Hạn mức và .

   TTL mặc định của 1 giờ là hợp lý với hầu hết các ứng dụng. Xin lưu ý rằng thư viện Kiểm tra ứng dụng sẽ được làm mới mã thông báo với thời lượng khoảng một nửa thời lượng TTL.

2. Thêm thư viện Kiểm tra ứng dụng vào ứng dụng của bạn

1. Thêm phần phụ thuộc cho tính năng Kiểm tra ứng dụng vào Podfile của dự án:

   pod 'FirebaseAppCheck'

   Hoặc, bạn có thể sử dụng Gói Swift Manager.

   Đảm bảo rằng bạn cũng đang sử dụng phiên bản mới nhất của bất kỳ Firebase SDK nào khác mà bạn phụ thuộc.

2. Chạy pod install và mở tệp .xcworkspace đã tạo.

3. Trong Xcode, hãy thêm tính năng Chứng thực ứng dụng vào ứng dụng của bạn.

4. Trong tệp .entitlements của dự án, hãy đặt môi trường Kiểm thử ứng dụng thành production

3. Chạy tính năng Kiểm tra ứng dụng

Bạn sẽ cần chạy tính năng Kiểm tra ứng dụng trước khi sử dụng bất kỳ Firebase nào khác SDK.

Trước tiên, hãy viết mã triển khai AppCheckProviderFactory. Thông tin cụ thể về việc triển khai sẽ tuỳ thuộc vào trường hợp sử dụng của bạn.

Ví dụ: Nếu chỉ có người dùng chạy iOS 14 trở lên, bạn chỉ cần có thể tạo đối tượng AppAttestProvider:

class YourSimpleAppCheckProviderFactory: NSObject, AppCheckProviderFactory {
  func createProvider(with app: FirebaseApp) -> AppCheckProvider? {
    return AppAttestProvider(app: app)
  }
}

@interface YourSimpleAppCheckProviderFactory : NSObject <FIRAppCheckProviderFactory>
@end

@implementation YourSimpleAppCheckProviderFactory

- (nullable id<FIRAppCheckProvider>)createProviderWithApp:(nonnull FIRApp *)app {
  return [[FIRAppAttestProvider alloc] initWithApp:app];
}

@end

Hoặc bạn có thể tạo đối tượng AppAttestProvider trên iOS 14 trở lên và mùa thu quay lại DeviceCheckProvider trên các phiên bản trước:

class YourAppCheckProviderFactory: NSObject, AppCheckProviderFactory {
  func createProvider(with app: FirebaseApp) -> AppCheckProvider? {
    if #available(iOS 14.0, *) {
      return AppAttestProvider(app: app)
    } else {
      return DeviceCheckProvider(app: app)
    }
  }
}

@interface YourAppCheckProviderFactory : NSObject <FIRAppCheckProviderFactory>
@end

@implementation YourAppCheckProviderFactory

- (nullable id<FIRAppCheckProvider>)createProviderWithApp:(nonnull FIRApp *)app {
  if (@available(iOS 14.0, *)) {
    return [[FIRAppAttestProvider alloc] initWithApp:app];
  } else {
    return [[FIRDeviceCheckProvider alloc] initWithApp:app];
  }
}

@end

Sau khi bạn triển khai lớp AppCheckProviderFactory, hãy định cấu hình Kiểm tra ứng dụng để sử dụng:

let providerFactory = YourAppCheckProviderFactory()
AppCheck.setAppCheckProviderFactory(providerFactory)

FirebaseApp.configure()

YourAppCheckProviderFactory *providerFactory =
        [[YourAppCheckProviderFactory alloc] init];
[FIRAppCheck setAppCheckProviderFactory:providerFactory];

[FIRApp configure];

Các bước tiếp theo

Sau khi cài đặt thư viện Kiểm tra ứng dụng trong ứng dụng, hãy bắt đầu phân phối được cập nhật ứng dụng cho người dùng của mình.

Ứng dụng khách sau khi cập nhật sẽ bắt đầu gửi mã thông báo Kiểm tra ứng dụng cùng với mỗi yêu cầu gửi mã đó đến Firebase, nhưng các sản phẩm của Firebase sẽ không yêu cầu mã có hiệu lực cho đến khi bạn cho phép thực thi trong phần Kiểm tra ứng dụng của bảng điều khiển của Firebase.

Theo dõi các chỉ số và cho phép thực thi

Tuy nhiên, trước khi bật tính năng thực thi, bạn nên đảm bảo rằng việc bật chế độ thực thi sẽ không làm gián đoạn những người dùng hợp lệ hiện tại. Mặt khác, nếu bạn thấy sử dụng tài nguyên ứng dụng của bạn một cách đáng ngờ, bạn có thể muốn cho phép thực thi sớm hơn.

Để đưa ra quyết định này, bạn có thể xem xét các chỉ số Kiểm tra ứng dụng cho dịch vụ bạn sử dụng:

• Theo dõi các chỉ số về yêu cầu Kiểm tra ứng dụng cho Cơ sở dữ liệu theo thời gian thực, Cloud Firestore, Cloud Storage và Xác thực (beta).
• Theo dõi chỉ số yêu cầu Kiểm tra ứng dụng cho Cloud Functions.

Bật chế độ thực thi tính năng Kiểm tra ứng dụng

Khi bạn hiểu cách tính năng Kiểm tra ứng dụng sẽ ảnh hưởng đến người dùng của mình và bạn đã sẵn sàng tiếp tục, bạn có thể bật tính năng thực thi Kiểm tra ứng dụng:

• Bật chế độ thực thi tính năng Kiểm tra ứng dụng cho Cơ sở dữ liệu theo thời gian thực, Cloud Firestore, Cloud Storage và Xác thực (beta).
• Bật chế độ thực thi tính năng Kiểm tra ứng dụng cho Cloud Functions.

Sử dụng tính năng Kiểm tra ứng dụng trong môi trường gỡ lỗi

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

Xem bài viết 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.