Autor del tema
#1
curl ile API yanıtını doğrulama
Hook ve amacın netleşmesi
Bir REST API ile çalışırken, güvenilir iletişimi ve doğru yanıtı almak kritik. curl, HTTP başlıklarını, durum kodlarını, yanıt gövdesini ve zaman aşımını kontrol etmek için en yaygın araçlardan biridir. Doğrulama süreci iki katmanda ilerler: (1) ağ katmanı güvenliği ve yanıt bütünlüğü, (2) içerik doğrulama ve iş mantığı tutarlılığı. Aşağıda pratik bir yaklaşım ve güvenilirlik için gereken temel adımlar bulunuyor.
Temel doğrulama adımları
Pratik örnekler
1) Basit durum kodu ve yanıt doğrulama
curl -sS -o response.json -w "%{http_code}" https://api.example.com/resource
Dönen kodu yakala ve 200 olup olmadığını kontrol et
if [ "$?" -eq 200 ]; then echo "Başarılı yanıt"; else echo "Hata: Yanıt kodu $?" fi
2) Yanıt içeriğinin temel alanlarını kontrol etme (JSON)
curl -sS https://api.example.com/resource | jq -e '.data and .status' > /dev/null
if [ $? -eq 0 ]; then echo "Gerekli alanlar mevcut"; else echo "Eksik alanlar veya yapı hatası"; fi
3) İmza ile doğrulama (varsayımsal örnek)
curl -sS -D headers.txt https://api.example.com/resource
SIGNATURE=$(grep -i X-Signature headers.txt | head -n1 | cut -d' ' -f2-)
PAYLOAD=$(curl -sS https://api.example.com/resource)
echo -n "$PAYLOAD" | openssl dgst -sha256 -hmac "paylaştığınız-secret" -binary | xxd -p
Gerçek imza ile karşılaştır
Güvenlik alışkanlıkları
Kapanış
Bu adımlar, API yanıtını güvenilir biçimde doğrulamanın temelini oluşturur ve operasyonel güvenliği artırır. Senin mevcut altyapında hangi doğrulama katmanını önceliklendirdiğini ve hangi senaryolarda ek validasyonlar gerektiğini merak ediyorum.
Hook ve amacın netleşmesi
Bir REST API ile çalışırken, güvenilir iletişimi ve doğru yanıtı almak kritik. curl, HTTP başlıklarını, durum kodlarını, yanıt gövdesini ve zaman aşımını kontrol etmek için en yaygın araçlardan biridir. Doğrulama süreci iki katmanda ilerler: (1) ağ katmanı güvenliği ve yanıt bütünlüğü, (2) içerik doğrulama ve iş mantığı tutarlılığı. Aşağıda pratik bir yaklaşım ve güvenilirlik için gereken temel adımlar bulunuyor.
Temel doğrulama adımları
- Durum kodu kontrolü: Sunucunun yanıtını 200-OK, 201-Created gibi standart durum kodlarıyla karşılaştır. Başarısız kodlar için kesin hata mesajını logla ve gerektiğinde yeniden dene. Örneğin: curl -sS -o /dev/null -w "%{http_code}" https://api.example.com/resource
- Yanıtın bütünlüğü: Eğer API imzalı yanıtlar döndürüyorsa, header’da yer alan imzayı veya bir HMAC’yı doğrula. Örneğin, yanıt gövdesini ve bir imza header’ını karşılaştır.
- İçerik doğrulama: JSON yanıtı beklenen alanları içeriyor mu? Zorlayıcı tipler ve zorunlu alanlar için basit doğrulama kuralları uygula. Örneğin belirli bir alanın mevcut ve tipinin uygun olduğundan emin ol.
- Zaman ve yenileme: API çağrısının timestamp’ini veya nonce’i kontrol et. Aynı nonce ile tekrarlanan istekleri tespit et ve zaman damgası üzerinden güncel olduğunu doğrula.
- Güvenli iletişim: HTTPS kullan, sertifika zincirinin geçerli olduğundan emin ol. Gerekirse -k/--insecure olmadan çalışacak şekilde CA sertifikasını belirt.
Pratik örnekler
1) Basit durum kodu ve yanıt doğrulama
curl -sS -o response.json -w "%{http_code}" https://api.example.com/resource
Dönen kodu yakala ve 200 olup olmadığını kontrol et
if [ "$?" -eq 200 ]; then echo "Başarılı yanıt"; else echo "Hata: Yanıt kodu $?" fi
2) Yanıt içeriğinin temel alanlarını kontrol etme (JSON)
curl -sS https://api.example.com/resource | jq -e '.data and .status' > /dev/null
if [ $? -eq 0 ]; then echo "Gerekli alanlar mevcut"; else echo "Eksik alanlar veya yapı hatası"; fi
3) İmza ile doğrulama (varsayımsal örnek)
curl -sS -D headers.txt https://api.example.com/resource
SIGNATURE=$(grep -i X-Signature headers.txt | head -n1 | cut -d' ' -f2-)
PAYLOAD=$(curl -sS https://api.example.com/resource)
echo -n "$PAYLOAD" | openssl dgst -sha256 -hmac "paylaştığınız-secret" -binary | xxd -p
Gerçek imza ile karşılaştır
Güvenlik alışkanlıkları
- API anahtarlarının ve gizli anahtarlarının güvenli saklanması ( çevresel değişkenler, vault çözümleri).
- Yanıt doğrulamada zaman aşımı ve tekrarlama koruması (retry-after, exponential backoff).
- Üretimde loglarınızı dikkatle yönetin: hassas verileri loglarda bırakmayın, hata mesajlarını kullanıcıya açık hale gelmeden önce temizleyin.
Kapanış
Bu adımlar, API yanıtını güvenilir biçimde doğrulamanın temelini oluşturur ve operasyonel güvenliği artırır. Senin mevcut altyapında hangi doğrulama katmanını önceliklendirdiğini ve hangi senaryolarda ek validasyonlar gerektiğini merak ediyorum.
