firebase-auth-basics — скилл для Claude Code: вход и правила доступа
Скилл firebase-auth-basics для Claude Code описывает настройку Firebase Authentication, вход пользователей и правил доступа к данным. Настраивает авторизацию приложений.
Apache-2.0 186 300 установок ★ 521 обновлён 2026-10-20
npx skills add firebase/agent-skills --skill firebase-auth-basics -a claude-codeЧто делает firebase-auth-basics
Скилл объясняет настройку Firebase Authentication: пользователей, провайдеров входа и токенов. Он охватывает вход по email и паролю, через Google и другие федеративные провайдеры, по номеру телефона, а также анонимную и собственную авторизацию. ID Token используется для запросов к Firestore, Realtime Database, Cloud Storage или вашему backend.
Внутри есть шаги для настройки через firebase.json и Firebase Console, клиентские сценарии для Web, Flutter, Android и iOS, а также правила Firestore и Storage с request.auth. Для работы понадобится Firebase Project; примеры CLI используют npx -y firebase-tools@latest. Firebase CLI должен быть установлен и выполнен вход.
После изменения firebase.json нужно выполнить npx -y firebase-tools@latest deploy --only auth, иначе настройки провайдеров не применятся. Для Google Sign-In в authorizedRedirectUris локальный адрес задаётся как http://localhost без порта.
Какие задачи решает
- настроить вход по email и паролю
- подключить Google Sign-In и другие провайдеры
- разобраться с ID Token и Refresh Token
- ограничить доступ к Firestore и Storage через
request.auth - включить анонимную авторизацию для гостевых пользователей
Примеры запросов агенту
- Настрой Firebase Authentication для приложения с входом по email и паролю.
- Добавь Google Sign-In через
firebase.jsonи выполниnpx -y firebase-tools@latest deploy --only auth. - Проверь правила Firestore и Storage с учётом
request.authдля авторизованных пользователей.
Как установить firebase-auth-basics
1Через Skills CLI (Vercel)
npx skills add firebase/agent-skills --skill firebase-auth-basics -a claude-code2Вручную: положить файлы
~/.claude/skills/firebase-auth-basics/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/firebase-auth-basics/
1Через Skills CLI (Vercel)
npx skills add firebase/agent-skills --skill firebase-auth-basics -a codex2Вручную: положить файлы
.agents/skills/firebase-auth-basics/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add firebase/agent-skills --skill firebase-auth-basics -a cursor2Вручную: положить файлы
.cursor/skills/firebase-auth-basics/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install firebase/agent-skills skills/firebase-auth-basics2Вручную: положить файлы
.github/skills/firebase-auth-basics/SKILL.md1Через Skills CLI (Vercel)
npx skills add firebase/agent-skills --skill firebase-auth-basics -a gemini-cli2Командой платформы
gemini skills install https://github.com/firebase/agent-skills --path skills/firebase-auth-basicsВручную: положить файлы
.devin/skills/firebase-auth-basics/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add firebase/agent-skills --skill firebase-auth-basics -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о firebase-auth-basics
Как установить firebase-auth-basics в Claude Code?
Выполни npx skills add firebase/agent-skills --skill firebase-auth-basics -a claude-code. Файл скилла появится по пути ~/.claude/skills/firebase-auth-basics/SKILL.md.
Что делает firebase-auth-basics?
Скилл помогает настроить Firebase Authentication, провайдеров входа, клиентский SDK и правила доступа к данным. Он также объясняет работу ID Token и Refresh Token.
Какие провайдеры можно включить через Firebase CLI?
Через CLI доступны Google Sign-In, анонимная авторизация и вход по email и паролю. Остальные провайдеры включаются в Firebase Console.
Исходный текст
SKILL.md · Apache-2.0
---
name: firebase-auth-basics
description: Guide for setting up and using Firebase Authentication. Use this skill when the user's app requires user sign-in, user management, or secure data access using auth rules.
compatibility: This skill is best used with the Firebase CLI, but does not require it. Firebase CLI can be accessed through `npx -y firebase-tools@latest`.
metadata:
author: Google LLC
category: Identity
---
## Prerequisites
- **Firebase Project**: Created via
`npx -y firebase-tools@latest projects:create` (see `firebase-basics`).
- **Firebase CLI**: Installed and logged in (see `firebase-basics`).
## Core Concepts
Firebase Authentication provides backend services, easy-to-use SDKs, and
ready-made UI libraries to authenticate users to your app.
### Users
A user is an entity that can sign in to your app. Each user is identified by a
unique ID (`uid`) which is guaranteed to be unique across all providers. User
properties include:
- `uid`: Unique identifier.
- `email`: User's email address (if available).
- `displayName`: User's display name (if available).
- `photoURL`: URL to user's photo (if available).
- `emailVerified`: Boolean indicating if the email is verified.
### Identity Providers
Firebase Auth supports multiple ways to sign in:
- **Email/Password**: Basic email and password authentication.
- **Federated Identity Providers**: Google, Facebook, Twitter, GitHub,
Microsoft, Apple, etc.
- **Phone Number**: SMS-based authentication.
- **Anonymous**: Temporary guest accounts that can be linked to permanent
accounts later.
- **Custom Auth**: Integrate with your existing auth system.
Google Sign In is recommended as a good and secure default provider.
### Tokens
When a user signs in, they receive an ID Token (JWT). This token is used to
identify the user when making requests to Firebase services (Realtime Database,
Cloud Storage, Firestore) or your own backend.
- **ID Token**: Short-lived (1 hour), verifies identity.
- **Refresh Token**: Long-lived, used to get new ID tokens.
## Workflow
### 1. Provisioning
#### Option 1. Enabling Authentication via CLI
Only Google Sign In, anonymous auth, and email/password auth can be enabled via
CLI. For other providers, use the Firebase Console.
Configure Firebase Authentication in `firebase.json` by adding an 'auth' block:
```
{
"auth": {
"providers": {
"anonymous": true,
"emailPassword": true,
"googleSignIn": {
"oAuthBrandDisplayName": "Your Brand Name",
"supportEmail": "[email protected]",
"authorizedRedirectUris": [
"https://my-project-id.firebaseapp.com/__/auth/handler",
"http://localhost"
]
}
}
}
}
```
> [!NOTE] If the Google Sign-In popup opens and immediately closes with the
> error `[firebase_auth/unauthorized-domain]`, it means the domain is not
> authorized. For local development, add `http://localhost` to
> `authorizedRedirectUris` in `firebase.json` (or ensure `localhost` is included
> in the **Authorized Domains** list in the Firebase Console under
> Authentication > Settings > Authorized domains). **CRITICAL**: Do NOT include
> the port number in `authorizedRedirectUris` (e.g., use `http://localhost`, NOT
> `http://localhost:9090` or `http://localhost:4000`), and do NOT include the
> protocol or port number in the Console Authorized Domains list (use
> `localhost`). Including a port number in `authorizedRedirectUris` causes
> `firebase deploy --only auth` to fail with `INVALID_AUTHORIZED_DOMAIN`.
**CRITICAL**: After configuring `firebase.json`, you MUST deploy the auth
configuration to the Firebase backend for the changes to take effect. This is
essential for auth providers like Google Sign-In, email/password, etc. to
auto-generate the necessary OAuth clients for your app platforms. Run:
```bash
npx -y firebase-tools@latest deploy --only auth
```
#### Option 2. Enabling Authentication in Console
Enable other providers in the Firebase Console.
1. Go to the
https://console.firebase.google.com/project/_/authentication/providers
1. Select your project.
1. Enable the desired Sign-in providers (e.g., Email/Password, Google).
### 2. Client Setup & Usage
**Web** See [references/client_sdk_web.md](references/client_sdk_web.md).
**Flutter** See [references/flutter_setup.md](references/flutter_setup.md).
**Android (Kotlin)** See
[references/client_sdk_android.md](references/client_sdk_android.md).
**iOS (Swift)** See [references/ios_setup.md](references/ios_setup.md).
### 3. Security Rules
Secure your data using `request.auth` in Firestore/Storage rules.
See [references/security_rules.md](references/security_rules.md).
© Google LLC · Apache-2.0 · firebase/agent-skills