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

supabase-extract-anon-key — скилл для Claude Code

Скилл supabase-extract-anon-key для Claude Code находит публичный API-ключ Supabase, передаваемый в createClient. Ключ используют для проверки RLS.

MIT 521 установок ★ 76 обновлён 2026-01-31

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add yoanbernabeu/supabase-pentest-skills --skill supabase-extract-anon-key -a claude-code
Открыть на GitHub

Что делает supabase-extract-anon-key

Скилл ищет анонимный ключ Supabase в JavaScript-файлах и переменных окружения вроде NEXT_PUBLIC_SUPABASE_ANON_KEY или VITE_SUPABASE_ANON_KEY. Этот ключ — JWT с ролью anon, его наличие в клиенте нормально, но только если в базе настроены Row Level Security-политики. Скилл декодирует ключ, проверяет срок действия, сохраняет результат в .sb-pentest-context.json и подсказывает, какой скилл запустить следом — например, supabase-audit-rls.

Если найдено несколько ключей или роль не anon, а service_role, скилл пометит это как критичную проблему. Без FFmpeg и Python проверка обфусцированных ключей не работает.

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

  • извлечь публичный API-ключ Supabase из фронтенда
  • проверить, какая роль в JWT-ключе — anon или service_role
  • декодировать и валидировать срок действия ключа
  • записать найденный ключ в контекстный файл для следующих скиллов
  • обнаружить утечку service_role ключа в клиентском коде

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

  • Найди anon-ключ Supabase на https://myapp.example.com
  • Извлеки публичный ключ для проекта abc123def
  • Проверь, какой ключ Supabase лежит в main.js

Как установить supabase-extract-anon-key

1Через Skills CLI (Vercel)

npx skills add yoanbernabeu/supabase-pentest-skills --skill supabase-extract-anon-key -a claude-code

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

~/.claude/skills/supabase-extract-anon-key/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/supabase-extract-anon-key/

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

Вопросы о supabase-extract-anon-key

Как установить supabase-extract-anon-key в Claude Code?

Выполни npx skills add yoanbernabeu/supabase-pentest-skills --skill supabase-extract-anon-key -a claude-code, затем проверь ~/.claude/skills/supabase-extract-anon-key/SKILL.md.

Что делает supabase-extract-anon-key?

Находит публичный API-ключ Supabase в клиентском коде, декодирует его, проверяет роль и срок действия, сохраняет в .sb-pentest-context.json. Anon-ключ в клиенте — это нормально, если настроены Row Level Security-политики.

Чем anon-ключ отличается от service_role?

Anon-ключ можно держать в клиенте, он работает с ограничениями RLS. Service_role даёт полный доступ к базе в обход политик — его в клиенте быть не должно, это критичная уязвимость.

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

SKILL.md · MIT
---
name: supabase-extract-anon-key
description: Extract the Supabase anon/public API key from client-side code. This key is expected in client apps but important for RLS testing.
---

# Supabase Anon Key Extraction

> 🔴 **CRITICAL: PROGRESSIVE FILE UPDATES REQUIRED**
>
> You MUST write to context files **AS YOU GO**, not just at the end.
> - Write to `.sb-pentest-context.json` **IMMEDIATELY after each discovery**
> - Log to `.sb-pentest-audit.log` **BEFORE and AFTER each action**
> - **DO NOT** wait until the skill completes to update files
> - If the skill crashes or is interrupted, all prior findings must already be saved
>
> **This is not optional. Failure to write progressively is a critical error.**

This skill extracts the Supabase anonymous (public) API key from client-side code.

## When to Use This Skill

- After extracting the Supabase URL, to get the API key for testing
- To verify that only the anon key (not service key) is exposed
- Before running API audit skills that require authentication

## Prerequisites

- Supabase URL extracted (or will auto-invoke `supabase-extract-url`)
- Target application accessible

## Understanding Anon Keys

The **anon key** (also called public key) is:

- ✅ **Expected** to be in client-side code
- ✅ **Safe** when RLS (Row Level Security) is properly configured
- ⚠️ **Risky** if RLS is missing or misconfigured
- ❌ **Not the same** as the service_role key (which should NEVER be in client code)

### Key Format

Supabase anon keys are JWTs:

```
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImFiYzEyMyIsInJvbGUiOiJhbm9uIiwiaWF0IjoxNjQwMDAwMDAwLCJleHAiOjE5NTUzNjAwMDB9.xxxx
```

Key characteristics:
- Starts with `eyJ` (base64 encoded `{"alg":`)
- Contains `"role":"anon"` in payload
- Project reference in `"ref"` claim

## Extraction Patterns

The skill searches for:

### 1. Direct Key Assignment

```javascript
const SUPABASE_KEY = 'eyJhbGci...'
const SUPABASE_ANON_KEY = 'eyJhbGci...'
```

### 2. Client Initialization

```javascript
createClient(url, 'eyJhbGci...')
createClient(url, process.env.NEXT_PUBLIC_SUPABASE_ANON_KEY)
```

### 3. Environment Variable Patterns

```javascript
NEXT_PUBLIC_SUPABASE_ANON_KEY
VITE_SUPABASE_ANON_KEY
REACT_APP_SUPABASE_KEY
SUPABASE_KEY
```

## Usage

### Basic Extraction

```
Extract Supabase anon key from https://myapp.example.com
```

### If URL Already Known

```
Extract anon key for project abc123def
```

## Output Format

```
═══════════════════════════════════════════════════════════
 ANON KEY EXTRACTED
═══════════════════════════════════════════════════════════

 Key Type: anon (public)
 Severity: ℹ️  Expected (verify RLS configuration)

 Key: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJz
      dXBhYmFzZSIsInJlZiI6ImFiYzEyM2RlZiIsInJvbGUiOiJhbm
      9uIiwiaWF0IjoxNjQwMDAwMDAwLCJleHAiOjE5NTUzNjAwMDB9
      .xxxxxxxxxxxxx

 Decoded Payload:
 ├── iss: supabase
 ├── ref: abc123def
 ├── role: anon
 ├── iat: 2021-12-20T00:00:00Z
 └── exp: 2031-12-20T00:00:00Z

 Found in:
 └── /static/js/main.js (line 1253)
     createClient('https://abc123def.supabase.co', 'eyJhbGci...')

 Next Steps:
 ├── Run supabase-audit-rls to test if RLS protects your data
 ├── Run supabase-audit-tables-read to see what's accessible
 └── Run supabase-extract-service-key to check for critical leaks

 Context updated: .sb-pentest-context.json
═══════════════════════════════════════════════════════════
```

## Key Validation

The skill validates the extracted key:

```
Validation:
├── Format: ✅ Valid JWT structure
├── Decode: ✅ Payload readable
├── Role: ✅ Confirmed "anon" role
├── Project: ✅ Matches extracted URL (abc123def)
└── Expiry: ✅ Not expired (expires 2031-12-20)
```

## Multiple Keys

If multiple keys are found:

```
═══════════════════════════════════════════════════════════
 MULTIPLE KEYS FOUND
═══════════════════════════════════════════════════════════

 ⚠️  2 potential Supabase keys detected

 1. Anon Key (confirmed)
    └── Role: anon, Project: abc123def

 2. Unknown Key
    └── Role: service_role ⚠️  SEE supabase-extract-service-key
        This may be a CRITICAL security issue!

═══════════════════════════════════════════════════════════
```

## Context Output

Saved to `.sb-pentest-context.json`:

```json
{
  "supabase": {
    "anon_key": "eyJhbGci...",
    "anon_key_decoded": {
      "iss": "supabase",
      "ref": "abc123def",
      "role": "anon",
      "iat": 1640000000,
      "exp": 1955360000
    },
    "anon_key_sources": [
      {
        "file": "/static/js/main.js",
        "line": 1253
      }
    ]
  }
}
```

## Security Assessment

| Finding | Severity | Description |
|---------|----------|-------------|
| Anon key in client | ℹ️ Info | Expected, but test RLS |
| Anon key expired | ⚠️ P2 | Key should be rotated |
| Multiple anon keys | ⚠️ P2 | May indicate key rotation issues |
| Role is not "anon" | 🔴 P0 | Wrong key type exposed! |

## Common Issues

❌ **Problem:** Key found but won't decode
✅ **Solution:** May be obfuscated or split. Try:
```
Extract anon key with deobfuscation from https://myapp.example.com
```

❌ **Problem:** Key doesn't match URL project
✅ **Solution:** App may use multiple Supabase projects. Both keys are recorded.

❌ **Problem:** No key found but Supabase detected
✅ **Solution:** Key may be fetched at runtime. Check network requests:
```
Monitor network for anon key on https://myapp.example.com
```

## Best Practices Reminder

For developers reading this report:

1. **Anon key in client is normal** — It's designed for this
2. **RLS is critical** — The anon key relies on RLS for security
3. **Never use service_role in client** — Use Edge Functions instead
4. **Rotate keys periodically** — Available in Supabase Dashboard

## MANDATORY: Progressive Context File Updates

⚠️ **This skill MUST update tracking files PROGRESSIVELY during execution, NOT just at the end.**

### Critical Rule: Write As You Go

**DO NOT** batch all writes at the end. Instead:

1. **Before starting any action** → Log the action to `.sb-pentest-audit.log`
2. **After each discovery** → Immediately update `.sb-pentest-context.json`
3. **After each significant step** → Log completion to `.sb-pentest-audit.log`

This ensures that if the skill is interrupted, crashes, or times out, all findings up to that point are preserved.

### Required Actions (Progressive)

1. **Update `.sb-pentest-context.json`** with extracted data:
   ```json
   {
     "supabase": {
       "anon_key": "eyJhbGci...",
       "anon_key_decoded": { ... },
       "anon_key_sources": [ ... ]
     }
   }
   ```

2. **Log to `.sb-pentest-audit.log`**:
   ```
   [TIMESTAMP] [supabase-extract-anon-key] [START] Beginning anon key extraction
   [TIMESTAMP] [supabase-extract-anon-key] [SUCCESS] Anon key extracted
   [TIMESTAMP] [supabase-extract-anon-key] [CONTEXT_UPDATED] .sb-pentest-context.json updated
   ```

3. **If files don't exist**, create them before writing.

**FAILURE TO UPDATE CONTEXT FILES IS NOT ACCEPTABLE.**

## MANDATORY: Evidence Collection

📁 **Evidence Directory:** `.sb-pentest-evidence/02-extraction/`

### Evidence Files to Create

| File | Content |
|------|---------|
| `extracted-anon-key.json` | Anon key with decoded JWT payload |

### Evidence Format

```json
{
  "evidence_id": "EXT-ANON-001",
  "timestamp": "2025-01-31T10:07:00Z",
  "category": "extraction",
  "type": "anon_key",
  "severity": "info",

  "key_data": {
    "key_prefix": "eyJhbGciOiJIUzI1NiI...",
    "key_suffix": "...xxxx",
    "full_key_length": 256
  },

  "decoded_payload": {
    "iss": "supabase",
    "ref": "abc123def",
    "role": "anon",
    "iat": "2021-12-20T00:00:00Z",
    "exp": "2031-12-20T00:00:00Z"
  },

  "source": {
    "file": "/static/js/main.js",
    "line": 1253,
    "context": "createClient('https://abc123def.supabase.co', 'eyJhbGci...')"
  },

  "validation": {
    "format_valid": true,
    "role_confirmed": "anon",
    "project_matches": true,
    "expired": false
  }
}
```

## Related Skills

- `supabase-extract-url` — Get URL first (auto-invoked if needed)
- `supabase-extract-service-key` — Check for critical service key leak
- `supabase-audit-rls` — Test if RLS protects your data
- `supabase-audit-tables-read` — See what data is accessible with this key

© yoanbernabeu · MIT · yoanbernabeu/supabase-pentest-skills

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

Все скиллы по теме «Безопасность» →
supabase Mindrally Скилл supabase для Claude Code помогает проектировать backend на Supabase с PostgreSQL, аутентификацией и real-time-функциями. Включается при работе с базой, доступом пользователей и файлами. CX Codex +1 954установок supabase-admin curiositech Скилл supabase-admin для Claude Code администрирует Supabase: проектирует схемы, настраивает политики RLS и миграции, отлаживает запросы. Помогает менять структуру базы и выяснять причины пустой выборки. CX Codex +1 200установок supabase-postgres-best-practices supabase Скилл supabase-postgres-best-practices помогает агенту проектировать схемы и писать SQL с учётом правил Supabase для Postgres. Подключайте его до изменений базы и при разборе проблем с запросами, подключениями или RLS. CX Codex +1 146установок supabase-security-audit davila7 Команда supabase-security-audit для Claude Code проводит аудит безопасности Supabase: проверяет RLS-политики, права доступа, аутентификацию и API-ключи и выдаёт отчёт с уязвимостями и рекомендациями по исправлению. CX Codex +1 1 020установок supabase-production Paweł Huryn Скилл supabase-production для Claude Code задаёт правила работы с Supabase в production. Он включается при запросах, миграциях, настройке RLS и разборе ошибок Supabase. CX Codex +1 ★ 741звёзд репо supabase-development Mindrally Скилл supabase-development задаёт агенту порядок работы с Supabase: схема базы, RLS-политики, авторизация, realtime-подписки и Edge Functions. CX Codex +1 740установок

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

Весь набор →
supabase-audit-tables-read Скилл supabase-audit-tables-read для Claude Code и пяти других платформ проверяет, какие таблицы Supabase отдают данные без аутентификации и насколько эффективны политики RLS. CX Codex +1 533установок supabase-audit-buckets-public Скилл supabase-audit-buckets-public находит публично доступные бакеты Supabase и проверяет, нет ли в них открытых бэкапов, файлов окружения или конфиденциальных документов. CX Codex +1 530установок supabase-audit-auth-users Скилл supabase-audit-auth-users для Claude Code и пяти других платформ проверяет эндпоинты аутентификации Supabase на уязвимость перечисления пользователей. Тестирует signup, login, recovery и OTP — по сообщениям и таймингу ответов. CX Codex +1 526установок supabase-audit-tables-list Скилл supabase-audit-tables-list для Claude Code и других агентов перечисляет таблицы, открытые через PostgREST API Supabase, и классифицирует их по уровню риска. Запускается перед проверкой RLS-политик или инвентаризацией публичной схемы. CX Codex +1 524установок supabase-detect Скилл supabase-detect проверяет, использует ли веб-приложение Supabase, и сохраняет найденные признаки. Пригодится перед аудитом неизвестного приложения. CX Codex +1 520установок supabase-extract-db-string Скилл supabase-extract-db-string ищет строки подключения PostgreSQL и отдельные учётные данные Supabase в клиентском коде. Нужен при проверке приложения перед выпуском. CX Codex +1 519установок supabase-extract-service-key Скилл supabase-extract-service-key ищет утечки административного ключа service_role в клиентском коде и JS-бандлах. Предотвращает полный обход Row Level Security в проектах на Supabase. CX Codex +1 519установок supabase-audit-buckets-list Скилл supabase-audit-buckets-list для Claude Code перечисляет бакеты Supabase и их настройки. Он включается при аудите хранилища и проверке его поверхности атаки. CX Codex +1 518установок

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

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