105 lines
2.6 KiB
Markdown
105 lines
2.6 KiB
Markdown
# 🔑 Clerk API Anahtarları - Hızlı Referans
|
||
|
||
## Gerekli Anahtarlar
|
||
|
||
### 1. Frontend Anahtarı (.env dosyası)
|
||
```bash
|
||
VITE_CLERK_PUBLISHABLE_KEY=pk_test_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
||
```
|
||
- **Nereden:** Clerk Dashboard > API Keys > Publishable Key
|
||
- **Format:** `pk_test_...` veya `pk_live_...`
|
||
- **Kullanım:** React uygulaması (tarayıcıda görünür)
|
||
|
||
### 2. Backend Anahtarları (Supabase Secrets)
|
||
```bash
|
||
CLERK_SECRET_KEY=sk_test_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
||
CLERK_WEBHOOK_SECRET=whsec_XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
||
```
|
||
- **CLERK_SECRET_KEY:**
|
||
- Nereden: Clerk Dashboard > API Keys > Secret Keys
|
||
- Format: `sk_test_...` veya `sk_live_...`
|
||
- ⚠️ GİZLİ - Asla frontend'de kullanmayın!
|
||
|
||
- **CLERK_WEBHOOK_SECRET:**
|
||
- Nereden: Clerk Dashboard > Webhooks > Signing Secret
|
||
- Format: `whsec_...`
|
||
- Webhook URL: `https://vtztatcglebrnvikvntf.supabase.co/functions/v1/clerk-webhook`
|
||
|
||
---
|
||
|
||
## 🚀 Hızlı Kurulum (3 Adım)
|
||
|
||
### Adım 1: Clerk'ten Anahtarları Al
|
||
1. https://clerk.com/ adresine git
|
||
2. Hesap oluştur ve yeni uygulama ekle
|
||
3. API Keys sayfasından anahtarları kopyala
|
||
|
||
### Adım 2: Frontend Anahtarını Yapılandır
|
||
```bash
|
||
# .env dosyasına ekle
|
||
VITE_CLERK_PUBLISHABLE_KEY=pk_test_...
|
||
```
|
||
|
||
### Adım 3: Backend Anahtarlarını Yapılandır
|
||
1. Supabase Dashboard'a git: https://supabase.com/dashboard
|
||
2. Edge Functions > Manage secrets
|
||
3. İki secret ekle:
|
||
- `CLERK_SECRET_KEY`
|
||
- `CLERK_WEBHOOK_SECRET`
|
||
|
||
---
|
||
|
||
## ✅ Doğrulama
|
||
|
||
### Frontend Test
|
||
```bash
|
||
# Development server'ı başlat
|
||
npm run dev
|
||
|
||
# Tarayıcıda aç: http://localhost:5173
|
||
# Sign In sayfasına git - Clerk formu görünmeli
|
||
```
|
||
|
||
### Backend Test
|
||
1. Admin Panel > Clerk Diagnostics
|
||
2. "Test Clerk Connection" butonuna tıkla
|
||
3. Başarılı mesajı görmelisin
|
||
|
||
---
|
||
|
||
## 🐛 Sorun mu Yaşıyorsun?
|
||
|
||
### "Clerk key bulunamadı" hatası
|
||
```bash
|
||
# .env dosyasını kontrol et
|
||
cat .env | grep CLERK
|
||
|
||
# Server'ı yeniden başlat
|
||
npm run dev
|
||
```
|
||
|
||
### "Invalid API key" hatası
|
||
- Anahtarı yeniden kopyala (boşluk olmamalı)
|
||
- Doğru environment kullandığından emin ol (test/live)
|
||
- Clerk Dashboard'da anahtarın aktif olduğunu kontrol et
|
||
|
||
---
|
||
|
||
## 📚 Detaylı Dokümantasyon
|
||
|
||
Tüm detaylar için: [CLERK_SETUP_GUIDE.md](./CLERK_SETUP_GUIDE.md)
|
||
|
||
---
|
||
|
||
## 🔗 Hızlı Linkler
|
||
|
||
- **Clerk Dashboard:** https://dashboard.clerk.com/
|
||
- **API Keys:** https://dashboard.clerk.com/last-active?path=api-keys
|
||
- **Webhooks:** https://dashboard.clerk.com/last-active?path=webhooks
|
||
- **Supabase Dashboard:** https://supabase.com/dashboard/project/vtztatcglebrnvikvntf
|
||
- **Clerk Docs:** https://clerk.com/docs
|
||
|
||
---
|
||
|
||
**💡 İpucu:** Anahtarları aldıktan sonra bu dosyayı sil veya `.gitignore`'a ekle!
|