Her Geliştiricinin Bilmesi Gereken Güvenli Kodlama Uygulamaları
Temel güvenlik uygulamaları: girdi doğrulama, kimlik doğrulama, şifreleme ve kaçınılması gereken yaygın güvenlik açıkları.

Bir kod incelemesi sırasında, bir dosya indirme uç noktasının şöyle oluşturulduğunu gördüm: path.join("uploads", req.query.file). Her testte çalışıyordu. Bir meslektaşım daha sonra ?file=../../.env isteği gönderdi ve yapılandırma dosyamızı yaklaşık otuz saniyede okudu. Ekipteki hiç kimse dikkatsiz değildi. Sadece, hatalı sürümün düzeltilmiş sürümün yanında bize hiç gösterilmemiş olmasıydı.
Bu gönderinin formatı budur. Bir ilkeler listesi yerine, en sık gördüğüm güvenlik açıklarını önleyen kod seviyesindeki alışkanlıkları, her birini incelemede tanıyabileceğiniz bir "öncesi ve sonrası" deseni olarak burada bulabilirsiniz. Örnekler Node üzerinde TypeScript ile verilmiştir, ancak fikirler herhangi bir teknoloji yığınına uygulanabilir. Web katmanı tehditleri (erişim kontrolü, SQL injection, XSS, CSRF) için, çoğu ekibin yanlış anladığı web güvenliği temelleri ile başlayın; bu gönderi kontrol listesinin geri kalanını kapsar.
Hızlı çıkarımlar
- Her harici girdiyi sınırda bir şemaya göre doğrulayın ve bilinmeyen alanları göz ardı etmek yerine reddedin.
- Parolaları argon2id ile hash'leyin, belirteçleri kriptografik bir rastgele kaynakla oluşturun ve sırları sabit zamanda karşılaştırın.
- Dosya yollarını sabit bir köke göre çözümleyin ve sonucu kontrol edin. Kullanıcı girdisini asla bir yola birleştirmeyin.
- Sunucunuzun alabileceği hedefleri izin listesine ekleyin, sunucu tarafı istek sahteciliğini (SSRF) önlemek için.
- Sırları günlükleyici seviyesinde gizleyin ve bağımlılıkların bilinen yüksek önem dereceli güvenlik açıklarına sahip olması durumunda CI'ı başarısız kılın.
Girdiyi sınırda nasıl doğrulamalıyım?
Kullanıcı girdisine asla güvenmeyin: istek gövdelerine, sorgu dizelerine, başlıklara, webhook yüklerine, dosyalara. Türü, uzunluğu ve formatı tek bir yerde, mümkün olduğunca erken kontrol edin ve beklenmedik her şeyi reddedin. Bir şema kütüphanesi bunu bir disiplin yerine varsayılan hale getirir:
import { z } from "zod";
const CreateUser = z
.object({
email: z.string().trim().toLowerCase().email().max(254),
displayName: z.string().trim().min(1).max(80),
age: z.number().int().min(13).max(120).optional(),
})
.strict(); // unknown fields are an error, not silently dropped
app.post("/users", (req, res) => {
const parsed = CreateUser.safeParse(req.body);
if (!parsed.success) {
return res.status(400).json({ errors: parsed.error.flatten().fieldErrors });
}
// parsed.data is typed and safe to use from here on
});
Doğrulama, kaçış ile aynı şey değildir. Parametreli sorgular SQL injection'ı durdurur; çıktı kodlaması XSS'i durdurur. Doğrulama, bu katmanlara ulaşan şeyi daraltır, ancak asla onların yerini almaz.
Parolaları nasıl saklamalı ve belirteçleri doğru şekilde nasıl oluşturmalıyım?
Asla düz metin veya düz SHA-256 gibi hızlı hash'ler saklamayın. Parolalar için tasarlanmış yavaş, bellek-yoğun bir algoritma kullanın. argon2 kütüphanesi tuzu kodlanmış hash'in içinde saklar, bu nedenle yanlış yapılabilecek ayrı bir tuz sütunu yoktur:
import argon2 from "argon2";
import { randomBytes, timingSafeEqual } from "node:crypto";
export const hashPassword = (plain: string) =>
argon2.hash(plain, { type: argon2.argon2id });
export const verifyPassword = (hash: string, plain: string) =>
argon2.verify(hash, plain);
// Session IDs, reset tokens, API keys: always from a CSPRNG, never Math.random()
export const newToken = () => randomBytes(32).toString("base64url");
export function safeEqual(a: string, b: string): boolean {
const left = Buffer.from(a);
const right = Buffer.from(b);
return left.length === right.length && timingSafeEqual(left, right);
}
Webhook imzaları veya API anahtarları gibi doğrudan karşılaştırdığınız herhangi bir sır için safeEqual kullanın; normal bir === zamanlama yoluyla bilgi sızdırabilir. Oturum yönetimi, sona erme ve belirteç takasları kimlik doğrulama desenleri: oturum, JWT ve OAuth konusunda ele alınmıştır. Hassas işlemler için çok faktörlü kimlik doğrulama ekleyin.
Dosya işleme sırasında yol geçişini nasıl durdururum?
Yolu sabit bir köke göre çözümleyin ve sonucun hala içinde olduğunu doğrulayın. Bu aynı zamanda mutlak yolları da engeller, çünkü path.resolve ikinci argüman mutlak olduğunda kökü atar:
import path from "node:path";
const UPLOAD_ROOT = path.resolve("/var/app/uploads");
export function resolveUpload(name: string): string {
const target = path.resolve(UPLOAD_ROOT, name);
if (!target.startsWith(UPLOAD_ROOT + path.sep)) {
throw new Error("path escapes upload root");
}
return target;
}
Daha iyi tasarım, kullanıcı kontrollü dosya adlarından tamamen kaçınmaktır: yüklemeleri oluşturulmuş bir kimlik altında saklayın ve orijinal adı meta veri olarak tutun.
Sunucum URL'leri çektiğinde SSRF'yi nasıl önlerim?
Kullanıcı tarafından sağlanan bir URL'yi (webhook'lar, bağlantı önizlemeleri, resim içe aktarmaları) çeken herhangi bir özellik, bulut meta veri uç noktanıza veya dahili bir hizmete yönlendirilebilir. Hedeflerin bir izin listesini tercih edin, HTTPS'yi zorunlu kılın ve yönlendirmeleri reddedin:
const ALLOWED_HOSTS = new Set(["api.github.com", "hooks.slack.com"]);
export async function fetchAllowed(rawUrl: string): Promise<Response> {
const url = new URL(rawUrl);
if (url.protocol !== "https:" || !ALLOWED_HOSTS.has(url.hostname)) {
throw new Error("destination not allowed");
}
return fetch(url, { redirect: "error", signal: AbortSignal.timeout(5000) });
}
Kullanıcılar gerçekten rastgele hedeflere ihtiyaç duyuyorsa, ana bilgisayar adını kendiniz çözümleyin ve özel, geri döngü ve bağlantı yerel adres aralıklarını engelleyin, ardından kontrol ettiğiniz IP'ye bağlanın. Bir ana bilgisayar adını bir kez kontrol edip daha sonra almak, DNS yeniden bağlama için bir boşluk bırakır.
Günlüklere asla ne düşmemeli?
Parolalar, belirteçler, oturum çerezleri, tam kart numaraları ve kişisel veriler. Geliştiriciler bunları nadiren kasıtlı olarak günlüğe kaydeder; birisi hata ayıklama sırasında tüm istek nesnesini günlüğe kaydettiğinde ortaya çıkarlar. Hatayı zararsız hale getirmek için günlükleyici seviyesinde gizleyin:
import pino from "pino";
export const logger = pino({
redact: {
paths: ["req.headers.authorization", "req.headers.cookie", "*.password", "*.token"],
censor: "[redacted]",
},
});
Aynı özen, istemcilere döndürülen hata mesajları için de geçerlidir: genel bir mesaj ve bir hata kimliği gönderin ve yığın izini günlüklerinizde tutun. Hata işleme desenleri ikisini nasıl ayıracağınızı açıklar.
Bağımlılıkların zayıf nokta haline gelmesini nasıl engellerim?
Kodunuzun çoğu başkalarının kodudur, bu nedenle tarama, unutulmayacağı CI'da yer almalıdır:
- name: Audit production dependencies
run: npm audit --omit=dev --audit-level=high
Düzeltmelerin küçük adımlarla gelmesi için otomatik güncelleme çekme istekleriyle eşleştirin. Kilit dosyanızı commit'leyin ve CI'da ondan yükleyin.
Hangi klasik güvenlik açıkları hangi alışkanlıkla eşleşir?
OWASP Top 10 sürümler arasında değişir, ancak arkasındaki alışkanlıklar sabittir:
- Injection: parametreli sorgular artı sınır doğrulama.
- Bozuk kimlik doğrulama ve hassas veri ifşası: argon2id, aktarımda TLS, beklemede güçlü şifreleme ve yönetilen anahtarlar.
- Bozuk erişim kontrolü: sunucudaki her istekte izinleri kontrol edin; asla istemci tarafı kontrollere güvenmeyin ve her hizmete yalnızca ihtiyaç duyduğu ayrıcalıkları verin.
- Güvenlik yanlış yapılandırması: güvenli varsayılanlar, üretimde hata ayıklama modu yok ve depoların dışında sırlar.
- Güvenlik açığı olan bileşenler ve yetersiz günlükleme: CI'da bağımlılık taraması ve bir olaydan sonra gerçekten arayabileceğiniz yapılandırılmış günlükler.
Bu hafta ne yapmalıyım?
Bir sonraki kod inceleme kontrol listenize iki şey ekleyin: "harici girdi nereden giriyor ve onu ne doğruluyor?" ve "kullanıcı kontrollü herhangi bir şey bir yola, bir URL'ye veya bir sorguya ulaşıyor mu?" Ardından bir uç nokta seçin, önüne Zod şemasını koyun ve npm audit adımını işlem hattınıza ekleyin. Her iki değişiklik de bir saatten az sürer ve inceleme alışkanlığı ölçeklenebilir olandır; bunu nasıl sığdıracağınızı görmek için hızı düşürmeden hataları yakalayan kod inceleme uygulamaları bölümüne bakın.
Uğur Kaval
Modern teknolojilerle yenilikçi çözümler geliştirmede uzmanlaşmış AI/ML Mühendisi & Full Stack Geliştirici. Otomasyon, makine öğrenmesi ve web geliştirme tutkunu.


