1.はじめに
Firebase App Checkは、リクエストが本物のアプリやデバイスからのものであることを確認することで、請求詐欺やフィッシングなどの悪用からバックエンドリソースを保護するのに役立ちます。 Firebaseサービスと独自のバックエンドサービスの両方と連携して、リソースを安全に保ちます。あなたは、詳細について学ぶことができFirebaseドキュメントのFirebaseのAppチェック。
App Checkは、プラットフォーム固有のサービスを使用して、認証プロバイダーと呼ばれるアプリを識別します。アップルの開発のために、アプリケーションのチェックは、Appleの使用のApp証明のアプリケーションとデバイスが本物であることを確認するために、サービスを。
構築するもの
あなたはするであろう：
- Firebase App Checkを既存のiOSアプリと統合して、Firebase RealtimeDatabaseのデータを悪用から保護します
- 実稼働用にAppleApp Attestプロバイダーを構成し、開発用にAppCheckデバッグ認証プロバイダーを構成します。
あなたが学ぶこと
- Firebase AppCheckを既存のアプリに追加する方法
- さまざまなFirebaseAppCheck認証プロバイダーをインストールする方法
- アプリのAppAttestを構成する方法
- アプリ開発中にシミュレーターでアプリをテストするようにデバッグ認証プロバイダーを構成する方法
必要なもの
- Xcode 12.5+
- App Attestテストの場合：
- 新しいアプリ識別子を作成できるAppleDeveloperアカウント
- AppAttest機能が有効になっている明示的なAppIDを持つアプリケーション。参照してください登録のApp IDをし、アプリの機能を有効にしますが、プロセスのヘルプが必要な場合は記事を。
- アプリの証明をサポートしているアンのiOS / iPadOSデバイス（利用可能なアプリケーションの証明のAPIを参照してくださいここ）
- iOSアプリが構成されたFirebaseプロジェクト：
2.既存のアプリコードを取得します
Firebaseクイックスタートリポジトリには、さまざまなFirebase製品をデモンストレーションするためのサンプルアプリが含まれています。 Firebase RealtimeDatabaseクイックスタートアプリをベースとして使用します。
クイックスタートリポジトリをチェックアウトします。
git clone https://github.com/firebase/quickstart-ios.git cd quickstart-ios
リアルタイムデータベースSwiftUIクイックスタートアプリプロジェクトを開きます。
cd database/DatabaseExampleSwiftUI/DatabaseExample open DatabaseExample.xcodeproj
3.アプリターゲットにアプリチェックの依存関係を追加します
- Swift Package Managerが依存関係を解決し、チェックアウトするのを待ちます。
- 開き、
Build PhasesのタブDatabaseExample (iOS)アプリのターゲットを：
- プレス
+FirebaseAppCheckライブラリを追加するためのボタン：
4. AppCheckプロバイダーファクトリを作成してインストールします
- 別のファイルにファクトリクラスを作成し、例えば
MyCustomAppCheckProvider.swift：
import Firebase
class MyAppCheckProviderFactory: NSObject, AppCheckProviderFactory {
func createProvider(with app: FirebaseApp) -> AppCheckProvider? {
#if targetEnvironment(simulator)
// App Attest is not available on simulators.
// Use a debug provider.
return AppCheckDebugProvider(app: app)
#else
// Use App Attest provider on real devices.
return AppAttestProvider(app: app)
#endif
}
}
- インスタンスを設定し
MyAppCheckProviderFactoryファイル内のAppチェックプロバイダファクトリとしてクラスをDatabaseExampleApp.swift.
import Firebase
@main
struct DatabaseExampleApp: App {
init() {
// Set an instance of `MyAppCheckProviderFactory` as an App Check
// provider factory before configuring Firebase.
AppCheck.setAppCheckProviderFactory(MyAppCheckProviderFactory())
FirebaseApp.configure()
}
...
}
5.Firebaseプロジェクトを作成して構成します
アプリチェックはFirebase認証と連携して、Firebase製品を保護します。このコードラボでは、Firebaseコンソールでいくつかの手順を実行して、iOSアプリでFirebaseプロジェクトを設定し、Firebase認証を構成し、保護するRealtime Databaseインスタンスを初期化し、アプリチェックを構成する必要があります。
プロジェクトを作成する
まず、Firebaseプロジェクトを作成する必要があります。
- でFirebaseコンソール[追加]を選択しますプロジェクト。
- プロジェクトに名前を付け：
App Check Codelab、例えば。 - プロジェクトの作成]をクリックします。
リアルタイムデータベースインスタンスを作成する
さて、Firebaseコンソールのリアルタイムデータベース]セクションに移動します。
- 新しいFirebaseプロジェクトを選択し、データベース作成ワークフローに従います。
- あなたのFirebaseセキュリティルールの開始モードとしてロックモードを選択します。ルールエディタで、デフォルトのルールを次のように置き換えます。
{
"rules": {
// User profiles are only readable/writable by the user who owns it
"users": {
"$UID": {
".read": "auth.uid == $UID",
".write": "auth.uid == $UID"
}
},
// Posts can be read by anyone but only written by logged-in users.
"posts": {
".read": true,
".write": "auth.uid != null",
"$POSTID": {
// UID must match logged in user and is fixed once set
"uid": {
".validate": "(data.exists() && data.val() == newData.val()) || newData.val() == auth.uid"
},
// User can only update own stars
"stars": {
"$UID": {
".validate": "auth.uid == $UID"
}
}
}
},
// User posts can be read by anyone but only written by the user that owns it,
// and with a matching UID
"user-posts": {
".read": true,
"$UID": {
"$POSTID": {
".write": "auth.uid == $UID",
".validate": "data.exists() || newData.child('uid').val() == auth.uid"
}
}
},
// Comments can be read by anyone but only written by a logged in user
"post-comments": {
".read": true,
".write": "auth.uid != null",
"$POSTID": {
"$COMMENTID": {
// UID must match logged in user and is fixed once set
"uid": {
".validate": "(data.exists() && data.val() == newData.val()) || newData.val() == auth.uid"
}
}
}
}
}
}
- データベースのリージョンを選択します。
- [完了]をクリックします。
iOSアプリを接続します
あなたのアプリを結ぶの詳細な説明については、あなたは詳細について読むことができるあなたのiOSプロジェクトにFirebaseを追加します。開始するには、次の主な手順に従います。
- 新しいプロジェクトのプロジェクトの概要画面から、お使いのiOSアプリにFirebaseの追加]をクリックします。
- バンドルIDを「com.google.firebase.codelab.AppCheckCodelab」として入力します。
- App StoreIDを「123456」として入力します。
- 登録アプリケーション]をクリックします。
- Firebaseアプリに必要なすべてのFirebaseのメタデータを含む、アプリのGoogleService-のInfo.plistファイルを生成します。
- アプリの登録ワークフローでは、ファイルをダウンロードするためにダウンロードGoogleService-のInfo.plistをクリックします。
- そのファイルをアプリケーションにコピーして、AppCheckCodelabターゲットに追加します。
FirebaseConsoleで認証を設定する
ふぅ！これまでのところかなりのセットアップですが、しっかりと保持してください。 Firebaseを初めて使用する場合は、ワークフローの重要な部分をすぐに理解できるようになります。
それでは、このアプリの認証を構成しましょう。
認証Eメール/パスワードサインインプロバイダーを有効にする
- それでも中Firebaseコンソール、プロジェクトの認証]セクションを開きます。
- サインインのメソッドタブを選択します。
- 押して、新しいプロバイダの追加]ボタンをクリックします。
- ネイティブプロバイダセクションのEメール/パスワードを選択します。
- メール/パスワードを押し、[保存]ボタンを有効にします。
テストユーザーを追加する
- 認証セクションのオープン[ユーザー]タブ。
- 押して、ユーザーの追加]ボタンをクリックします。
- テストユーザーの電子メールとパスワードを指定します。
アプリでテストする
アプリケーションを起動し、作成したテストユーザーの電子メールとパスワードを使用してサインインしてみます。サインインすると、投稿の作成、既存の投稿へのコメントの投稿、スター付き/スターなしの投稿を試すことができます。
6.アプリアテステーションアテステーションプロバイダーを構成します
ここでは、FirebaseコンソールでApp Check AppAttestプロバイダーを構成します。
- プロジェクト設定→アプリチェック→Firebaseアプリ→アプリ認証を開きます
- AppleデベロッパアカウントのチームIDを入力します。
- [保存]ボタンを押します
これで、新しいアプリに接続されたFirebaseプロジェクトが機能し、アプリチェックが有効になりました。これで、特定の認証サービスを構成する準備が整いました。このワークフローの詳細については、を参照してくださいiOSのアプリの証明とアプリのチェックを有効にします。
7.アプリケーションのAppAttestを構成します
OK、セットアップは完了です。 Firebase App Check SDKを手に入れて、いくつかのクライアントコードを実装しましょう。
SDKがAppleのAppAttest APIを使用して認証を実行できるように、つまり、リクエストを行っているアプリが、登録した正規のアプリを実行している実際のデバイスであるかどうかを確認できるように、Xcodeプロジェクトを構成しましょう。
- AppleDeveloperアカウントでAppAttest機能が有効になっているアプリの明示的なアプリ識別子があることを確認してください。このプロセスについてサポートが必要な場合は、Appleの公式ドキュメントに従ってください。
- AppleDeveloperアカウントでアプリのアプリ認証機能を有効にします。
- Xcodeプロジェクトにアプリターゲットのアプリ認証機能を追加します。
- アプリのターゲット設定で開く署名＆機能]タブ
- 押して「+機能」
- ダイアログで、見つけるとApp証明する機能を選択します
- ファイル
DatabaseExample.entitlements前のステップを実行した後に表示されます。 - で
DatabaseExample.entitlementsファイル、値変更App Attest Environmentへのキーproduction.
これらの手順を完了し、実際のiOSデバイス（iPhone / iPad）でアプリを起動すると、アプリはリアルタイムデータベースに再びアクセスできるようになります。 iOSシミュレーターはまだ機能しないことに注意してください。開発環境の構成については、次のセクションを参照してください。
参考のため、これについての詳細を学ぶためには、ワークフローを可能にする、参照iOSのアプリの証明とアプリのチェックを有効にします。このコードラボの最後にもリンクされています。
8.シミュレーターのデバッグ認証プロバイダーを構成します
Firebase App Checkデバッグプロバイダーを使用すると、開発プロセス中に、iOSシミュレーターなど、信頼できない環境でFirebase AppCheckを適用してアプリケーションをテストできます。一緒にデバッグプロバイダーを構成しましょう。
アプリにFirebaseデバッグプロバイダーをインストールする
オプション1：ファクトリでデバッグプロバイダーのインスタンスを条件付きで作成します
私たちが作成したときに私たちは、これのほとんどをやったのAppチェックプロバイダーの工場を、今、私たちは、デバッグプロバイダによって生成されたローカルデバッグ秘密のロギングを追加する必要があります。
import Firebase
class MyAppCheckProviderFactory: NSObject, AppCheckProviderFactory {
func createProvider(with app: FirebaseApp) -> AppCheckProvider? {
#if targetEnvironment(simulator)
// App Attest is not available on simulators.
// Use a debug provider.
let provider = AppCheckDebugProvider(app: app)
// Print only locally generated token to avoid a valid token leak on CI.
print("Firebase App Check debug token: \(provider?.localDebugToken() ?? "" )")
return provider
#else
// Use App Attest provider on real devices.
return AppAttestProvider(app: app)
#endif
}
}
このオプションにより、柔軟性が高まります。たとえば、App Attestが利用できないOSバージョンでは、DeviceCheckやカスタムなどの他の認証プロバイダーを使用できます。以下の例を参照してください。
import Firebase
class SimpleAppCheckProviderFactory: NSObject, AppCheckProviderFactory {
func createProvider(with app: FirebaseApp) -> AppCheckProvider? {
#if targetEnvironment(simulator)
// App Attest is not available on simulators.
// Use a debug provider.
let provider = AppCheckDebugProvider(app: app)
// Print only locally generated token to avoid a valid token leak on CI.
print("Firebase App Check debug token: \(provider?.localDebugToken() ?? "" )")
return provider
#else
if #available(iOS 14.0, *) {
// Use App Attest provider on real devices.
return AppAttestProvider(app: app)
} else {
return DeviceCheckProvider(app: app)
}
#endif
}
}
オプション2：AppCheckDebugProviderFactoryをインストールします
単純な例のためには、一時的または条件付きでインストールすることができAppCheckDebugProviderFactory Firebaseアプリケーションインスタンスを設定する前に：
#if targetEnvironment(simulator)
let providerFactory = AppCheckDebugProviderFactory()
#else
let providerFactory = MyAppCheckProviderFactory()
#endif
AppCheck.setAppCheckProviderFactory(providerFactory)
FirebaseApp.configure()
これにより、独自のAppCheckプロバイダーファクトリを作成するためのコードを数行節約できます。
Firebaseコンソールにデバッグシークレットを登録する
iOSシミュレーターからデバッグシークレットを取得する
- あなたはオプション2を選択した場合：AppCheckDebugProviderFactoryをインストールし、追加することによって、アプリのデバッグログを有効
-FIRDebugEnabledアプリ起動引数には：
- シミュレーターでアプリを実行する
- Xcodeコンソールでデバッグシークレットを見つけます。コンソールフィルターを使用して、より速く見つけることができます。
デバッグシークレットを登録する
- プロジェクト設定の[アプリチェック]タブに移動します。
- Firebaseアプリのメニューを開き、[デバッグトークンの管理]を選択します。
- Xcodeのコンソールを押し、[保存]ボタンのためにコピーされた秘密を追加します。
これらの手順を実行すると、アプリチェックが適用されていても、シミュレーターでアプリを使用できるようになります。
でいつものように、このフローの詳細については、マニュアルに記載されています使用アプリケーションはiOSのデバッグプロバイダに確認してください。
9. Firebase RealtimeDatabaseのアプリチェックの実施を有効にする
今のところ、我々のアプリは宣言するAppCheckProviderFactory実際のデバイスのために返すことAppAttestProvider iOSアプリが認証を行い、Firebaseバックエンドに結果を送信しますので、。ただし、Firebaseバックエンドは、すべてのデバイス、iOSシミュレーター、スクリプトなどからのリクエストを引き続き受け入れます。このモードは、アプリチェックのない古いバージョンのアプリを使用しているユーザーがいて、アクセスチェックを強制したくない場合に便利です。まだ。
さんはFirebaseアプリは唯一の本物のデバイスからアクセスできることを確認するためのAppチェック執行を有効にしてみましょう。 Firebaseプロジェクトの適用を有効にすると、AppCheckが統合されていない古いアプリバージョンは機能しなくなります。
- [商品]セクションの[アプリの確認]タブにあるFirebaseConsoleで、[リアルタイムデータベース]をクリックします
- ボタンを押すと強制
- 確認のポップアップやプレスでの情報を読む強制ボタン
手順を完了すると、自分以外のアプリケーションはデータベースにアクセスできなくなります。アプリでアプリチェックを無効にして、自分でチェックしてください！
10.おめでとうございます！
今、あなたは方法を知っています：
- アプリチェックを既存のプロジェクトに追加する
- アプリの製品版用にAppAttest認証プロバイダーを構成します
- シミュレーターでアプリをテストするようにデバッグ認証プロバイダーを構成します
- アプリのバージョンロールアウトを観察して、Firebaseプロジェクトにアプリチェックを適用するタイミングを確認してください
- アプリチェックの実施を有効にします。
このコードラボで説明されている設定はほとんどの場合に機能しますが、AppCheckを使用すると必要に応じて柔軟性を高めることができます。