App Check 使用入门（C++ 应用）

本页介绍了如何使用以下默认的提供程序在 C++ 应用中启用 App Check：Android 上的 Play Integrity，以及 Apple 平台上的 Device Check 或 App Attest。启用 App Check 有助于确保只有您的应用可以访问项目的 Firebase 资源。请查看此功能的概览。

1. 设置您的 Firebase 项目

  1. 将 Firebase 添加到您的 C++ 项目（如果尚未添加）。

  2. 在 Firebase 控制台的项目设置 > App Check 部分中注册您的应用，以便将 App Check 与 Play Integrity、Device Check 或 App Attest 提供程序搭配使用。

    您通常需要注册项目的所有应用，因为在您为 Firebase 产品启用强制执行后，只有注册的应用才能访问产品的后端资源。

    如需详细了解如何向每个提供程序注册您的应用，请参阅 Android 和 iOS 专用文档。

  3. 可选：在应用注册设置中，为提供方颁发的 App Check 令牌设置自定义存留时间 (TTL)。您可以将 TTL 设置为 30 分钟到 7 天之间的任何值。更改此值时，请注意权衡以下几个方面：

    • 安全性：较短的 TTL 可以提供更强的安全性，因为它可以缩短攻击者可能滥用已泄露或者已被拦截的令牌的时长。
    • 性能：较短的 TTL 意味着您的应用将更频繁地执行证明操作。由于每次执行应用证明过程都会增加网络请求的延迟时间，因此短 TTL 可能会影响应用的性能。
    • 配额和费用：较短的 TTL 和频繁的重新证明会更快地耗尽您的配额，而对于付费服务，费用可能更高。请参阅配额和限制。

    对于大多数应用而言，默认的 TTL 比较合理。请注意，App Check 库会在大约一半 TTL 时长时刷新令牌。

2. 将 App Check 库添加到您的应用

按照 App Check 的设置说明操作，将 App Check 库添加到您的一组依赖项中。

3. 初始化 App Check

将以下初始化代码添加到您的应用，使其在您使用任何 Firebase 服务（以及创建任何 Firebase 应用）之前运行。

Android

  1. 包含 firebase::app_check 的头文件：

    #include "firebase/app_check.h"

  2. 使用 Play Integrity 提供程序初始化 App Check 库：

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