Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Apple プラットフォームで reCAPTCHA Enterprise を使用して App Check を使ってみる

プラットフォームを選択:

iOS+ Android ウェブ Flutter

このページでは、reCAPTCHA Enterprise プロバイダを使用して、Apple プラットフォームアプリで App Check を設定する方法について説明します。App Check を使用すると、自分のアプリだけがプロジェクトのバックエンドリソースにアクセスできるようになります。詳しくは、App Check の概要をご覧ください。

App Check では、スコアベースの reCAPTCHA キーを使用する必要があります。これにより、ユーザーには表示されなくなります。つまり、reCAPTCHA Enterprise プロバイダがユーザーに問題の解決を求めることはありません。

ユースケースで App Check によって実装されない reCAPTCHA Enterprise 機能を必要とする場合や、独自のカスタムプロバイダで App Check を使用する場合は、App Check カスタムプロバイダを実装するをご覧ください。

1. Firebase プロジェクトを設定する

まだ追加していない場合は、Apple プロジェクトに Firebase を追加します。
Google Cloud コンソールで、[Fraud Defense] ページに移動し、reCAPTCHA Enterprise プロバイダに対して次の操作を行います。
1. 正しいプロジェクトが選択されていることを確認します（画面上部のプロジェクト選択ツールを参照）。
2. プロンプトが表示されたら、reCAPTCHA Enterprise API を有効にします。
3. iOS タイプのキーを作成し、アプリのバンドル ID（com.example.my_app など）を指定します。
  - Firebase プロジェクトで Firebase Apple アプリを作成したときに入力したバンドル ID と同じバンドル ID を入力してください。バンドル ID の値では大文字と小文字が区別されます。
  - App Check の場合、各バンドル ID は 1 つの reCAPTCHA キーにのみ対応できます。
  詳細な手順については、スコアベースの reCAPTCHA キーを作成するをご覧ください。
4. このキーをメモしておきます。Firebase コンソールの登録フローに追加する必要があります。
Firebase コンソールで、[セキュリティ] > [App Check] に移動します。
[アプリ] タブで、reCAPTCHA Enterprise プロバイダで App Check を使用するように Apple プラットフォームアプリを登録します。Google Cloud コンソールで取得したキーを指定する必要があります。

重要: プロジェクトのすべてのアプリを、reCAPTCHA Enterprise などの証明書プロバイダに登録してください。サービスの適用を有効にすると、登録済みのアプリのみがサービスにアクセスできるようになります。
省略可: トークンの有効期間（TTL）を設定します。

アプリの登録設定で、プロバイダが発行する App Check トークンのカスタム有効期間（TTL）を設定します。TTL は 30 分から 7 日までの任意の値に設定できます。この値を変更する場合は、次のトレードオフに注意してください。
- セキュリティ: TTL が短いほど、漏えいしたトークンや傍受されたトークンが攻撃者によって悪用される可能性が低減するため、セキュリティが向上します。
- パフォーマンス: TTL が短いほど、アプリで証明書の取得が頻繁に行われます。アプリで証明書が取得されるたびにネットワークリクエストのレイテンシが増加するため、TTL が短いと、アプリのパフォーマンスに影響する可能性があります。
- 割り当てとコスト: TTL を短くすると、証明書の取得が頻繁に発生し、割り当てが早く消費されます。有料サービスの場合は、費用が増加する可能性があります。割り当てと上限をご覧ください。
通常は、デフォルトの TTL（1 時間）で十分です。App Check ライブラリは TTL の約半分でトークンを更新することに留意してください。
省略可: 詳細設定を構成します。
[保存] をクリックします。

（省略可）詳細設定を構成する

ユーザーがアプリを開くと、reCAPTCHA Enterprise はキーの下でユーザーインタラクションがもたらすリスクレベルを評価し、0.1 刻みの 0.0 ～ 1.0 の範囲でスコアを返します。

スコア 0.0 は、インタラクションのリスクが高く、不正行為の可能性があることを示します。
スコア 1.0 は、インタラクションのリスクが低く、正当である可能性が非常に高いことを示します。

App Check では、アプリのリスクしきい値を設定して、このリスクに対する許容度を調整できます。

ほとんどのユースケースでは、デフォルトのしきい値 0.5 をおすすめします。ユースケースで調整が必要な場合は、Firebase コンソールで各アプリに対してこの値を構成できます（[セキュリティ] > [App Check] に移動します）。以下のアプリのリスクしきい値の構成に関する重要な考慮事項を開いて確認してください。

アプリのリスクしきい値に関する重要な考慮事項を確認する

App Check は、構成されたアプリのリスクしきい値を、ユーザーインタラクションが正当と見なされるために必要な最低限の reCAPTCHA Enterprise スコアとして使用します。構成されたしきい値を厳密に下回る reCAPTCHA Enterprise スコアはすべて拒否されます。アプリのリスクしきい値を調整する際は、次の点に注意してください。

Firebase プロジェクトが無料の Spark のお支払いプランを利用している場合、11 個の reCAPTCHA Enterprise スコアレベルのうち、0.1、0.3、0.7、0.9 の 4 つのスコアレベルのみを使用できます。

この期間、App Check はそれに応じてアプリのリスクしきい値として 0.1、0.3、0.5、0.7、0.9 のみを許可します。ほとんどのユースケースでは、アプリのリスクしきい値には引き続き 0.5 をおすすめします。
- 11 段階の reCAPTCHA Enterprise スコアレベルをすべて有効にするには、Cloud Billing アカウントをプロジェクトにリンクします（つまり、Firebase プロジェクトを従量課金制の Blaze のお支払いプランにアップグレードします）。プロジェクトをアップグレードすると、App Check を使用して、アプリのリスクしきい値を 0.1 刻みの 0.0 ～ 1.0 の範囲で設定できるようになります。
  
  注: Cloud Billing アカウントがプロジェクトにリンクされると、プロジェクトの自動セキュリティレビューがトリガーされます。詳細については、reCAPTCHA Enterprise のドキュメントをご覧ください。
アプリの reCAPTCHA Enterprise の高スコアと低スコアの分布をモニタリングするには、Google Cloud コンソールの [reCAPTCHA Enterprise] ページに移動し、アプリで使用されているキーを選択します。
許容度に応じてアプリのリスクしきい値を適切に設定します。
- アプリのリスク許容度が高い場合は、スライダーを右に移動して、アプリのリスクしきい値を下げます。
  - 値 0.0 に設定することはおすすめしません。というのは、この設定では不正行為に対する保護が無効になるためです。
- アプリのリスク許容度が低い場合は、スライダーを左に移動して、アプリのリスクしきい値を上げます。
  - 値 1.0 に設定することはおすすめしません。というのは、この設定では、正規ユーザーであっても、この高い信頼性基準を満たさない場合はアクセスが拒否される可能性があるためです。
  警告: 正規ユーザーの混乱を避けるため、App Check が適用されている場合は、アプリのリスクしきい値を段階的に引き上げてください。常に App Check リクエストの指標をモニタリングして、トラフィックが中断されていないことを確認してください。

詳細については、reCAPTCHA Enterprise のドキュメントをご覧ください。

2. アプリに App Check SDK を追加する

Swift Package Manager（SPM）を使用して Firebase の依存関係のインストールと管理を行います。すでに Firebase を使用している場合は、Firebase パッケージが v12.17.0 以降であることを確認してください。

Xcode でアプリプロジェクトを開きます。
Firebase ライブラリを追加します。
1. [File] > [Add Packages] の順に移動します。
2. プロンプトが表示されたら、Firebase Apple プラットフォーム SDK リポジトリを追加します。
```
https://github.com/firebase/firebase-ios-sdk
```
3. 最新の SDK バージョン（v12.17.0 以降）を選択します。
4. FirebaseAppCheck ライブラリを選択します。
5. [Add Package] をクリックします。Xcode が依存関係を解決してダウンロードします。
6. プロンプトが表示されたら、アプリターゲットにライブラリを追加します。
reCAPTCHA Enterprise ライブラリを追加します。
1. [File] > [Add Packages] に戻ります。
2. プロンプトが表示されたら、reCAPTCHA Enterprise SDK リポジトリを追加します。
```
https://github.com/GoogleCloudPlatform/recaptcha-enterprise-mobile-sdk
```
3. RecaptchaEnterprise ライブラリを選択します。
4. [Add Package] をクリックします。プロンプトが表示されたら、ライブラリをアプリターゲットに追加します。

3. App Check を初期化する

アプリで他の Firebase サービスを使用する前に、App Check を初期化する必要があります。

reCAPTCHA キーを渡して RecaptchaProviderFactory のインスタンスを作成し、それを使用するように App Check を構成します。

let providerFactory = RecaptchaProviderFactory(siteKey: "SITE_KEY")
AppCheck.setAppCheckProviderFactory(providerFactory)

FirebaseApp.configure()

4. 指標をモニタリングして適用を有効にする

アプリで App Check を設定したら、更新されたアプリのユーザーへの配布を開始します。

更新されたクライアントアプリは、Firebase にリクエストを送信するたびに App Check トークンを送信します。ただし、App Check は、App Check が適用されるまで、無効なトークンを含むリクエストをブロックしません。

指標をモニタリングする

適用を有効にする前に、既存の正規ユーザーを中断しないように対策を行う必要があります。一方、アプリリソースの不審な使用に気づいた場合は、すぐに適用を有効にすることもできます。

使用するサービスの App Check 指標を確認すると、この決定を行ううえで役立ちます。

Firebase AI Logic、SQL Connect、Realtime Database、Cloud Firestore、Cloud Storage、Authentication、Google Identity for iOS、Maps JavaScript API、Places API（新規）の App Check リクエスト指標をモニタリングします。
Cloud Functions に対して App Check リクエスト指標をモニタリングします。

App Check 適用を有効にする

App Check がユーザーに与える影響を理解し、続行する準備ができたら、App Check の適用を有効にできます。

Firebase AI Logic、SQL Connect、Realtime Database、Cloud Firestore、Cloud Storage、Authentication、Google Identity for iOS、Maps JavaScript API、Places API（新規）の App Check の適用を有効にします。
Cloud Functions に対して App Check の適用を有効にします。

デバッグ環境で App Check を使用する

App Check は、開発中のエミュレータ / シミュレータからのリクエストや、継続的インテグレーション（CI）環境からのリクエストなど、一部の環境を無効として分類します。

App Check が適用された後にこのような環境でアプリを実行するには、本番環境の証明書プロバイダの代わりに App Check デバッグプロバイダを使用するアプリのデバッグビルドを作成する必要があります。

詳細については、Apple プラットフォーム上でデバッグプロバイダと一緒に App Check を使用するをご覧ください。

料金

App Check は、アプリが App Check トークンを更新するたびに、ユーザーのレスポンストークンを検証するために、ユーザーに代わって評価を作成します。無料割り当て枠を超えて作成された評価ごとに、Firebase プロジェクトに課金されます。詳細については、reCAPTCHA の料金をご覧ください。

デフォルトでは、アプリはこのトークンを 1 時間に 2 回更新します。アプリで App Check トークンの更新頻度（つまり、新しい評価を作成する頻度）を制御するには、トークンの TTL を構成します。