Bắt đầu sử dụng tính năng Kiểm tra ứng dụng trong ứng dụng C++

Trang này hướng dẫn bạn cách bật tính năng Kiểm tra ứng dụng trong ứng dụng C++, sử dụng các trình cung cấp mặc định: Tính toàn vẹn của Play trên Android và Kiểm tra thiết bị hoặc Chứng thực ứng dụng trên các nền tảng của Apple. 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.

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

  1. Thêm Firebase vào dự án C++ nếu bạn chưa thêm đã làm như vậy.

  2. Đă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 API Tính toàn vẹn của Play, Kiểm tra thiết bị hoặc Chứng thực ứng dụng trong phần Cài đặt dự án > Kiểm tra ứng dụng của bảng điều khiển 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 bật tính năng 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.

    Để xem hướng dẫn chi tiết về cách đăng ký với từng nhà cung cấp, hãy tham khảo tài liệu dành riêng cho Android và iOS.

  3. 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 giúp tăng cường bảo mật vì giảm khoảng thời gian mà kẻ tấn công có thể lợi dụng mã thông báo bị rò rỉ hoặc bị chặn.
    • 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 làm tăng độ trễ cho các yêu cầu mạng mỗi khi quy trình này được thực hiện, nên TTL ngắn có thể ảnh hưởng đến hiệu suất của ứng dụng.
    • 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 giảm hạn mức của bạn nhanh hơn, đồng thời có thể làm tăng chi phí đối với các dịch vụ có tính phí. Xem phần Hạn mức và giới hạn.

    TTL mặc định 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ẽ làm mới mã thông báo ở 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

Đưa thư viện Kiểm tra ứng dụng vào nhóm phần phụ thuộc, làm theo hướng dẫn thiết lập cho Kiểm tra ứng dụng.

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

Thêm mã khởi động sau đây vào ứng dụng để chạy trước bạn sử dụng bất kỳ dịch vụ Firebase nào, bao gồm cả mọi hoạt động tạo Ứng dụng Firebase.

Android

  1. Thêm tệp tiêu đề cho firebase::app_check:

    #include "firebase/app_check.h"

  2. Khởi chạy thư viện Kiểm tra ứng dụng bằng nhà cung cấp API Tính toàn vẹn của Play:

    firebase::app_check::AppCheck::SetAppCheckProviderFactory(
  firebase::app_check::PlayIntegrityProviderFactory::GetInstance());

iOS trở lên

  1. Thêm tệp tiêu đề cho firebase::app_check:

    #include "firebase/app_check.h"

  2. Khởi chạy thư viện Kiểm tra ứng dụng bằng trình cung cấp Kiểm tra thiết bị hoặc Chứng thực ứng dụng:

    firebase::app_check::AppCheck::SetAppCheckProviderFactory(
  firebase::app_check::DeviceCheckProviderFactory::GetInstance());

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:

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

Khi đã hiểu rõ ảnh hưởng của tính năng Kiểm tra ứng dụng đối với người dùng và 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:

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

Sau khi đăng ký ứng dụng của mình cho tính năng Kiểm tra ứng dụng, nếu 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ên máy tính, trình mô phỏng 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 một bản gỡ lỗi của ứng dụng sử dụng trình cung cấp gỡ lỗi Kiểm tra ứng dụng thay vì trình cung cấp chứng thực thực.

Xem phần Sử dụng tính năng Kiểm tra ứng dụng với trình cung cấp gỡ lỗi trong ứng dụng C++.