| name | security-review |
| description | Kimlik doğrulama eklerken, kullanıcı girdisi işlerken, secret'larla çalışırken, API endpoint'leri oluştururken veya ödeme/hassas özellikler uygularken bu skill'i kullanın. Kapsamlı güvenlik kontrol listesi ve kalıplar sağlar. |
| origin | ECC |
Güvenlik İnceleme Skill'i
Bu skill tüm kodun güvenlik en iyi uygulamalarını takip etmesini sağlar ve potansiyel güvenlik açıklarını tanımlar.
Ne Zaman Aktifleştirmelisiniz
- Kimlik doğrulama veya yetkilendirme uygularken
- Kullanıcı girdisi veya dosya yüklemeleri işlerken
- Yeni API endpoint'leri oluştururken
- Secret'lar veya kimlik bilgileriyle çalışırken
- Ödeme özellikleri uygularken
- Hassas veri saklarken veya iletirken
- Üçüncü taraf API'leri entegre ederken
Güvenlik Kontrol Listesi
1. Secret Yönetimi
FAIL: ASLA Bunu Yapmayın
const apiKey = "sk-proj-xxxxx"
const dbPassword = "password123"
PASS: HER ZAMAN Bunu Yapın
const apiKey = process.env.OPENAI_API_KEY
const dbUrl = process.env.DATABASE_URL
if (!apiKey) {
throw new Error('OPENAI_API_KEY not configured')
}
Doğrulama Adımları
2. Input Doğrulama
Her Zaman Kullanıcı Girdisini Doğrulayın
import { z } from 'zod'
const CreateUserSchema = z.object({
email: z.string().email(),
name: z.string().min(1).max(100),
age: z.number().int().min(0).max(150)
})
export async function createUser(input: unknown) {
try {
const validated = CreateUserSchema.parse(input)
return await db.users.create(validated)
} catch (error) {
if (error instanceof z.ZodError) {
return { success: false, errors: error.errors }
}
throw error
}
}
Dosya Yükleme Doğrulama
function validateFileUpload(file: File) {
const maxSize = 5 * 1024 * 1024
if (file.size > maxSize) {
throw new Error('Dosya çok büyük (max 5MB)')
}
const allowedTypes = ['image/jpeg', 'image/png', 'image/gif']
if (!allowedTypes.includes(file.type)) {
throw new Error('Geçersiz dosya tipi')
}
const allowedExtensions = ['.jpg', '.jpeg', '.png', '.gif']
const extension = file.name.toLowerCase().match(/\.[^.]+$/)?.[0]
if (!extension || !allowedExtensions.includes(extension)) {
throw new Error('Geçersiz dosya uzantısı')
}
return true
}
Doğrulama Adımları
3. SQL Injection Önleme
FAIL: ASLA SQL Concatenation Yapmayın
const query = `SELECT * FROM users WHERE email = '${userEmail}'`
await db.query(query)
PASS: HER ZAMAN Parametreli Sorgular Kullanın
const { data } = await supabase
.from('users')
.select('*')
.eq('email', userEmail)
await db.query(
'SELECT * FROM users WHERE email = $1',
[userEmail]
)
Doğrulama Adımları
4. Kimlik Doğrulama ve Yetkilendirme
JWT Token İşleme
localStorage.setItem('token', token)
res.setHeader('Set-Cookie',
`token=${token}; HttpOnly; Secure; SameSite=Strict; Max-Age=3600`)
Yetkilendirme Kontrolleri
export async function deleteUser(userId: string, requesterId: string) {
const requester = await db.users.findUnique({
where: { id: requesterId }
})
if (requester.role !== 'admin') {
return NextResponse.json(
{ error: 'Unauthorized' },
{ status: 403 }
)
}
await db.users.delete({ where: { id: userId } })
}
Row Level Security (Supabase)
ALTER TABLE users ENABLE ROW LEVEL SECURITY;
CREATE POLICY "Users view own data"
ON users FOR SELECT
USING (auth.uid() = id);
CREATE POLICY "Users update own data"
ON users FOR UPDATE
USING (auth.uid() = id);
Doğrulama Adımları
5. XSS Önleme
HTML'i Sanitize Et
import DOMPurify from 'isomorphic-dompurify'
function renderUserContent(html: string) {
const clean = DOMPurify.sanitize(html, {
ALLOWED_TAGS: ['b', 'i', 'em', 'strong', 'p'],
ALLOWED_ATTR: []
})
return <div dangerouslySetInnerHTML={{ __html: clean }} />
}
Content Security Policy
const securityHeaders = [
{
key: 'Content-Security-Policy',
value: `
default-src 'self';
script-src 'self' 'unsafe-eval' 'unsafe-inline';
style-src 'self' 'unsafe-inline';
img-src 'self' data: https:;
font-src 'self';
connect-src 'self' https://api.example.com;
`.replace(/\s{2,}/g, ' ').trim()
}
]
Doğrulama Adımları
6. CSRF Koruması
CSRF Token'ları
import { csrf } from '@/lib/csrf'
export async function POST(request: Request) {
const token = request.headers.get('X-CSRF-Token')
if (!csrf.verify(token)) {
return NextResponse.json(
{ error: 'Invalid CSRF token' },
{ status: 403 }
)
}
}
SameSite Cookie'ler
res.setHeader('Set-Cookie',
`session=${sessionId}; HttpOnly; Secure; SameSite=Strict`)
Doğrulama Adımları
7. Rate Limiting
API Rate Limiting
import rateLimit from 'express-rate-limit'
const limiter = rateLimit({
windowMs: 15 * 60 * 1000,
max: 100,
message: 'Çok fazla istek'
})
app.use('/api/', limiter)
Pahalı Operasyonlar
const searchLimiter = rateLimit({
windowMs: 60 * 1000,
max: 10,
message: 'Çok fazla arama isteği'
})
app.use('/api/search', searchLimiter)
Doğrulama Adımları
8. Hassas Veri İfşası
Loglama
console.log('User login:', { email, password })
console.log('Payment:', { cardNumber, cvv })
console.log('User login:', { email, userId })
console.log('Payment:', { last4: card.last4, userId })
Hata Mesajları
catch (error) {
return NextResponse.json(
{ error: error.message, stack: error.stack },
{ status: 500 }
)
}
catch (error) {
console.error('Internal error:', error)
return NextResponse.json(
{ error: 'Bir hata oluştu. Lütfen tekrar deneyin.' },
{ status: 500 }
)
}
Doğrulama Adımları
9. Blockchain Güvenliği (Solana)
Wallet Doğrulama
import { verify } from '@solana/web3.js'
async function verifyWalletOwnership(
publicKey: string,
signature: string,
message: string
) {
try {
const isValid = verify(
Buffer.from(message),
Buffer.from(signature, 'base64'),
Buffer.from(publicKey, 'base64')
)
return isValid
} catch (error) {
return false
}
}
Transaction Doğrulama
async function verifyTransaction(transaction: Transaction) {
if (transaction.to !== expectedRecipient) {
throw new Error('Geçersiz alıcı')
}
if (transaction.amount > maxAmount) {
throw new Error('Miktar limiti aşıyor')
}
const balance = await getBalance(transaction.from)
if (balance < transaction.amount) {
throw new Error('Yetersiz bakiye')
}
return true
}
Doğrulama Adımları
10. Bağımlılık Güvenliği
Düzenli Güncellemeler
npm audit
npm audit fix
npm update
npm outdated
Lock Dosyaları
git add package-lock.json
npm ci
Doğrulama Adımları
Güvenlik Testi
Otomatik Güvenlik Testleri
test('kimlik doğrulama gerektirir', async () => {
const response = await fetch('/api/protected')
expect(response.status).toBe(401)
})
test('admin rolü gerektirir', async () => {
const response = await fetch('/api/admin', {
headers: { Authorization: `Bearer ${userToken}` }
})
expect(response.status).toBe(403)
})
test('geçersiz input'u reddeder', async () => {
const response = await fetch('/api/users', {
method: 'POST',
body: JSON.stringify({ email: 'not-an-email' })
})
expect(response.status).toBe(400)
})
// Rate limiting testi
test('rate limit'leri zorlar', async () => {
const requests = Array(101).fill(null).map(() =>
fetch('/api/endpoint')
)
const responses = await Promise.all(requests)
const tooManyRequests = responses.filter(r => r.status === 429)
expect(tooManyRequests.length).toBeGreaterThan(0)
})
Deployment Öncesi Güvenlik Kontrol Listesi
HERHANGİ bir production deployment'ından önce:
Kaynaklar
Unutmayın: Güvenlik opsiyonel değildir. Bir güvenlik açığı tüm platformu tehlikeye atabilir. Şüphe duyduğunuzda ihtiyatlı olun.