К основному содержанию
скилл CX Codex

firebase-app-check — скилл для Claude Code: что делает и установка

Скилл помогает внедрить Firebase App Check во Flutter: выбрать провайдеров, настроить debug-токены и включить проверку запросов.

MIT ★ 674 обновлён 2026-10-29

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rules
Открыть на GitHub

Что делает firebase-app-check

Скилл описывает настройку Firebase App Check во Flutter-приложениях. Он помогает выбрать провайдера для Android, Apple и Web, активировать App Check после Firebase.initializeApp() и до вызовов Firestore, Storage или RTDB. Для подключения пакета используется flutter pub add firebase_app_check.

Внутри есть сценарии для debug-провайдеров в эмуляторах, CI и на Web, регистрация токенов в Firebase Console, обработка обновления токенов и передача токена собственному backend. Также разобран поэтапный переход к enforcement: сначала собрать метрики, затем защищать менее критичные сервисы и только после этого остальные.

На физических Apple-устройствах AppleProvider.debug игнорируется, если AppDelegate вызывает нативный FirebaseApp.configure() до установки фабрики провайдера. Debug-токены нельзя публиковать или использовать в production; для критичных операций предусмотрена серверная проверка через Firebase Admin SDK.

Какие задачи решает

  • подключить Firebase App Check во Flutter
  • выбрать провайдера для Android, Apple или Web
  • настроить debug-токены для эмулятора и CI
  • передать App Check-токен собственному backend
  • поэтапно включить enforcement для Firebase-сервисов

Примеры запросов агенту

  • Настрой Firebase App Check во Flutter и добавь firebase_app_check.
  • Выбери провайдеров для Android, Apple и Web, затем активируй App Check после Firebase.initializeApp().
  • Подготовь debug-токены для CI и опиши безопасный переход к enforcement.

Как установить firebase-app-check

1Через маркетплейс плагинов

/plugin marketplace add evanca/flutter-ai-rules
/plugin install flutter-ai-skills@flutter-ai-rules

Команда ставит плагин flutter-ai-skills целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add evanca/flutter-ai-rules --skill firebase-app-check -a claude-code

3Вручную: положить файлы

~/.claude/skills/firebase-app-check/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/firebase-app-check/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о firebase-app-check

Как установить firebase-app-check в Claude Code?

Добавь маркетплейс командой /plugin marketplace add evanca/flutter-ai-rules, затем установи плагин командой /plugin install flutter-ai-skills@flutter-ai-rules.

Что делает firebase-app-check?

Скилл помогает настроить Firebase App Check во Flutter: провайдеров attestation, debug-токены, обновление токенов и enforcement для Firebase-сервисов.

Что нужно учесть при настройке App Check на Apple?

Если AppDelegate вызывает нативный FirebaseApp.configure(), фабрику App Check нужно установить до него. Иначе на физических устройствах AppleProvider.debug может быть проигнорирован.

Исходный текст

SKILL.md · MIT
---
name: firebase-app-check
description: "Use when implementing app attestation, configuring App Check providers, setting up debug tokens, enabling backend enforcement, or managing token refresh."
license: MIT
---

# Firebase App Check Skill

This skill defines how to correctly implement Firebase App Check in Flutter applications, covering provider selection, debug configuration, enforcement rollout, and security hardening.

## When to Use

Use this skill when:

* Setting up and activating Firebase App Check in a Flutter project.
* Selecting the right attestation provider for each platform.
* Configuring debug providers for development, testing, and CI.
* Enabling enforcement and monitoring App Check metrics.
* Implementing token refresh handling and custom TTL configuration.

---

## 1. Setup and Configuration

```
flutter pub add firebase_app_check
```

```dart
import 'package:firebase_app_check/firebase_app_check.dart';
```

Initialize App Check **after** `Firebase.initializeApp()` and **before** using any Firebase services:

```dart
await Firebase.initializeApp();
await FirebaseAppCheck.instance.activate(
  webProvider: ReCaptchaV3Provider('recaptcha-v3-site-key'),
  androidProvider: AndroidProvider.playIntegrity,
  appleProvider: AppleProvider.deviceCheck,
);
```

### Setup Checklist

1. Register apps in the Firebase console under **Project Settings > App Check**.
2. For web, obtain a reCAPTCHA v3 site key from the Firebase console.
3. Confirm activation completes before any Firestore, Storage, or RTDB calls.
4. Consider setting a custom **TTL** — shorter TTLs are more secure but consume quota faster.

### Native `FirebaseApp.configure()` on Apple Platforms

Avoid calling `FirebaseApp.configure()` natively in your `AppDelegate` — `Firebase.initializeApp()` already configures the native default app. If you must call it, install your `AppCheckProviderFactory` **before** `configure()`; otherwise the Apple SDK locks in `DeviceCheck` on physical devices and the `appleProvider` passed to `activate()` (including `AppleProvider.debug`) is silently ignored. This is easiest to miss because simulators already default to the debug provider. `activate()` on Android is unaffected. See [flutterfire#18613](https://github.com/firebase/flutterfire/issues/18613).

---

## 2. Provider Selection

**Android:**
| Provider | Use case |
|---|---|
| `AndroidProvider.playIntegrity` | Production (default) |
| `AndroidProvider.debug` | Development / CI only |

**Apple (iOS / macOS):**
| Provider | Use case |
|---|---|
| `AppleProvider.deviceCheck` | Production default (iOS 11+, macOS 10.15+) |
| `AppleProvider.appAttest` | Enhanced security (iOS 14+, macOS 14+) |
| `AppleProvider.appAttestWithDeviceCheckFallback` | App Attest with Device Check fallback |
| `AppleProvider.debug` | Development / CI only |

**Web:**
| Provider | Use case |
|---|---|
| `ReCaptchaV3Provider` | Standard reCAPTCHA v3 |
| `ReCaptchaEnterpriseProvider` | Enhanced with additional features |

> **Android note:** For certain Android devices, enable "Meets basic device integrity" in the Google Play console to ensure proper App Check functionality.

---

## 3. Development and Testing

Use debug providers during development to run in emulators or CI environments:

```dart
await Firebase.initializeApp();
await FirebaseAppCheck.instance.activate(
  androidProvider: AndroidProvider.debug,
  appleProvider: AppleProvider.debug,
);
```

### Platform-Specific Debug Setup

**iOS:** Enable debug logging by adding `-FIRDebugEnabled` to Arguments Passed on Launch in Xcode. The debug token appears in the console output. On **physical devices**, `AppleProvider.debug` is ignored if your `AppDelegate` calls `FirebaseApp.configure()` natively — see the native `configure()` note in Setup and Configuration.

**Android:** The debug token prints to logcat on first run. Filter by `DebugAppCheckProvider`.

**Web:** Set `self.FIREBASE_APPCHECK_DEBUG_TOKEN = true;` in `web/index.html` before Firebase scripts load.

### Register Debug Tokens

1. Copy the debug token from the device/emulator console output.
2. In the Firebase console, navigate to **App Check > Apps > Manage debug tokens**.
3. Add the token. It is immediately active for that app.

### Token Listener for Custom Backends

```dart
FirebaseAppCheck.instance.onTokenChange.listen((token) {
  // Attach token to custom backend requests
  // e.g., set as Authorization header
});
```

- **Never** use debug providers or share debug tokens in production builds.
- Keep debug tokens private — do not commit them to public repositories.
- Revoke compromised debug tokens immediately from the Firebase console.

---

## 4. Enforcement Rollout

Follow this sequence to avoid disrupting legitimate users:

1. **Deploy** App Check activation code to all app versions.
2. **Monitor** App Check metrics in the Firebase console — wait until most traffic shows valid tokens.
3. **Enable enforcement** gradually, starting with non-critical Firebase services (e.g., Cloud Storage before Firestore).
4. **Verify** that unverified request percentage drops to near zero before enforcing on critical services.

- Once enforcement is enabled, only apps with valid App Check tokens can access protected Firebase resources.
- Use App Check **in combination with** Firebase Security Rules for defense in depth.
- Implement proper error handling for App Check verification failures — surface a user-friendly message rather than a raw error.

---

## 5. Security Best Practices

- Never disable App Check in production builds once enabled.
- Implement a fallback mechanism for App Check verification failures (e.g., retry with exponential backoff).
- Regularly review App Check metrics to identify potential abuse patterns.
- App Check tokens are **automatically refreshed** at approximately half the TTL duration.
- For high-security applications, use the shortest practical TTL.
- Implement server-side verification for critical operations using the Firebase Admin SDK:

```
// Node.js Admin SDK example for verifying App Check tokens
const appCheckToken = req.header('X-Firebase-AppCheck');
const appCheckClaims = await getAppCheck().verifyToken(appCheckToken);
```

---

## References

- [Firebase App Check Flutter documentation](https://firebase.google.com/docs/app-check/flutter/default-providers)
- [Firebase App Check debug provider](https://firebase.google.com/docs/app-check/flutter/debug-provider)

© Ivanna Kaceviča · MIT · evanca/flutter-ai-rules

Похожие скиллы

Все скиллы по теме «Безопасность» →
firebase sanjeed5 Задаёт стандарты безопасности для Firebase в проекте. Помогает настроить App Check и закрыть доступ к базе через Security Rules. CX Codex +1 ★ 3 589звёзд репо firebase-ai-logic-basics Google LLC Скилл firebase-ai-logic-basics подключает Firebase AI Logic к мобильным и веб-приложениям, позволяя вызывать модели Gemini напрямую из клиентского кода без своего бэкенда. CX Codex +1 146 900установок firebase-apk-scanner trailofbits Скилл firebase-apk-scanner разбирает Android APK, вытаскивает конфиг Firebase и проверяет базы, хранилища и функции на открытый доступ. Нужен при аудите мобильных приложений. CX Codex +1 6 000установок firebase-app-hosting-basics Google LLC Скилл firebase-app-hosting-basics для Claude Code помогает развёртывать Next.js и Angular с SSR через Firebase App Hosting. Настраивает бэкенд, секреты и деплой из GitHub. CX Codex +1 180 900установок firebase-app-platform devops-skills Скилл firebase-app-platform для Claude Code подключает знания о Firebase: агент пишет правила безопасности, настраивает триггеры и деплоит бэкенды через firebase deploy. CX Codex +1 347установок firebase-development Mindrally Скилл firebase-development задаёт правила разработки под Firebase на TypeScript и Angular: от архитектуры коллекций Firestore до тестов правил безопасности. CX Codex +1 732установок

Из того же набора39

Весь набор →
firebase-in-app-messaging Помогает настроить Firebase In-App Messaging во Flutter: подавлять показы на критичных экранах, настраивать сбор согласий для GDPR и тестировать кампании на тестовых устройствах. CX Codex +1 ★ 674звёзд репо firebase-analytics Скилл firebase-analytics для Claude Code помогает настраивать Firebase Analytics в приложениях Flutter. Подключается при добавлении событий, свойств пользователей, воронок и отслеживания экранов. CX Codex +1 ★ 674звёзд репо patrol-e2e-testing Скилл patrol-e2e-testing пишет и запускает E2E-тесты на Patrol 4.x для Flutter: пользовательские сценарии, системные диалоги разрешений, деплинки. CX Codex +1 ★ 674звёзд репо revenuecat-testing Скилл revenuecat-testing помогает составить план тестирования встроенных покупок и подписок в RevenueCat, проверить события в песочнице и разобрать сбои. CX Codex +1 ★ 674звёзд репо flutter-best-practices Скилл flutter-best-practices для Claude Code задаёт правила Flutter и Dart: слои, структура фич, виджеты и тесты. Агент читает нужный файл-справочник под задачу. CX Codex +1 ★ 674звёзд репо flutter-app-architecture Скилл flutter-app-architecture задаёт правила многослойной архитектуры Flutter-проекта: MVVM, репозитории, сервисы и однонаправленный поток данных. CX Codex +1 ★ 674звёзд репо riverpod Скилл помогает писать Flutter- и Dart-код с Riverpod: настраивать провайдеры, управлять их жизненным циклом и проверять их тестами. Пригодится при работе с состоянием приложения. CX Codex +1 ★ 674звёзд репо architecture-feature-first Скилл architecture-feature-first задаёт слоистую feature-first архитектуру для Flutter: где лежит UI, где данные и когда нужен доменный слой. CX Codex +1 ★ 674звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой