Flask-RESTful Girdi Doğrulama Eğitimi

Eğitim Hakkında

Flask-RESTful ile istek ayrıştırma ve girdi doğrulama

Eğitim, Flask-RESTful API'lerinde gelen isteğin güvenli ayrıştırılmasına odaklanır. reqparse.RequestParser, add_argument ile tür, zorunluluk, choices ve location ayarları, özel doğrulama fonksiyonları, iç içe JSON, Marshmallow ve webargs ile şema doğrulama, toplu hata yanıtları, SQL enjeksiyonu ve aşırı veri gönderimi (mass assignment) riskleri uygulamalı ele alınır.

Süre ve Format

2 Gün. Her gün dört modül; 1. gün reqparse ile İstek Ayrıştırma; 2. gün Şema Doğrulama ve Güvenli İşleme.

Seviye

Orta Seviye — Flask-RESTful ile istek ayrıştırma ve girdi doğrulama

Öğrenme Metodu

Katılımcılar hazır, doğrulaması zayıf bir API'yi adım adım sertleştirir ve geçersiz isteklerle test eder.

Neden Bu Eğitim?

✅Güvenli Girdi

Gelen veriyi tür, aralık ve biçim açısından doğrularsınız.

🧰İki Yaklaşım

reqparse ve Marshmallow'u karşılaştırarak doğru aracı seçersiniz.

📣Net Hata Mesajı

İstemciye anlaşılır 400/422 hata gövdeleri üretirsiniz.

Anahtar Konular

flask-restful reqparsegirdi doğrulamamarshmallowwebargspython api güvenliğimass assignmentflask api doğrulamarequestparserapi sertleştirme

“Doğrulanmamış veri, güvenilmeyen veridir.”

Ön Koşullar

Eğitimden verim almak için faydalı olacak bilgi ve ortam gereksinimleri

1

Temel Python

Değişken, fonksiyon ve modül kullanımını bilmek yeterlidir.

2

Geliştirme ortağı

Python 3.10+ ve bir kod düzenleyici (VS Code veya PyCharm) kurulu olmalıdır.

3

Flask-RESTful

Basit bir Resource sınıfı yazmış olmak beklenir.

4

JSON ve HTTP

İstek gövdesi, sorgu dizesi ve başlık kavramları bilinmelidir.

Eğitim İçeriği

Programın gün gün akışı aşağıdadır. Bir güne tıklayarak o günün modüllerini ve içeriklerini görebilirsiniz.

Günün hedefiKatılımcı RequestParser ile sorgu, form ve JSON verilerini ayrıştırıp temel doğrulamaları uygular.

Modül 1

RequestParser Temelleri

add_argument parametreleri
type, required, default, help
location: args, form, json, headers
action=append ile liste
parse_args(strict=True)
Argüman kopyalama ve genişletme

Modül 2

Tür ve Değer Denetimi

int, str, bool dönüşüm tuzakları
choices ile izinli değerler
Aralık denetimi için özel type işlevi
inputs.regex, inputs.date
Tarih ve saat ayrıştırma
ValueError ile hata iletme

Modül 3

Hata Mesajları

bundle_errors ile toplu hata
help alanı şablonları
400 yanıtı biçimi
Özel errorhandler
Çok dilli hata mesajı fikri
Hata yanıtı testleri

Modül 4

Parser Yönetimi

Ortak parser'lar ve miras
PUT ve POST için farklı parser
Parser'ı Resource dışında tutma
Argüman sıralaması
Bilinmeyen alanları reddetme
Birim test düzeni

Günün hedefiKatılımcı iç içe şemalarla doğrulama yapar, yaygın girdi saldırılarına karşı API'yi sertleştirir.

Modül 1

Marshmallow Şemaları

Schema ve fields tanımı
validate.Range, Length, OneOf
@validates ve @validates_schema
load ve dump farkı
İç içe şema ve many=True
ValidationError.messages

Modül 2

webargs Entegrasyonu

use_args dekoratörü
Konum bazlı ayrıştırma
Flask-RESTful ile birlikte kullanım
Özel hata işleyici
Şema yeniden kullanımı
Performans notları

Modül 3

Saldırı Önleme

Parametreli sorgularla SQL enjeksiyonu önleme
Mass assignment ve alan beyaz listesi
Boyut ve derinlik sınırları
Dosya adı ve yol geçişi (path traversal)
Hız sınırlama (Flask-Limiter)
Güvenli günlükleme ve PII maskesi

Modül 4

Uçtan Uca Sertleştirme

Mevcut API'nin denetimi
Doğrulamanın şemaya taşınması
Hata yanıtlarının standardizasyonu
Fuzz tarzı geçersiz girdi testi
pytest parametrize ile senaryolar
Gözden geçirme kontrol listesi

Eğitim Kazanımları

Program sonunda katılımcılar:

🧾

reqparse kullanımı

add_argument ile tür ve zorunluluk kurallarını tanımlayabilirsiniz.

📍

Konum seçimi

Verinin query, form, JSON ya da başlıktan okunacağını belirleyebilirsiniz.

🚫

Hatalı veri reddi

bundle_errors ile tüm hataları tek yanıtta döndürebilirsiniz.

🧬

Şema tasarımı

Marshmallow ile iç içe şemalar yazabilirsiniz.

🔗

webargs kullanımı

use_args ile şema doğrulamasını uç noktalara bağlayabilirsiniz.

🛡️

Enjeksiyon önleme

Parametreli sorgu ve beyaz liste ile riskleri azaltabilirsiniz.

🌡️

Hız sınırı

Flask-Limiter ile kötüye kullanımı sınırlayabilirsiniz.

🔍

Girdi testi

Geçersiz verilerle parametrize testler yazabilirsiniz.

Kimler İçin Uygundur?

Flask-RESTful
API yazan ve girdi güvenliğini artırmak isteyen Python geliştiricileri içindir

Sıkça Sorulan Sorular

Bu eğitim kimler için uygundur?

Flask-RESTful ile API yazan ve girdi güvenliğini artırmak isteyen Python geliştiricileri içindir.

reqparse kullanımdan kalktı mı?

Flask-RESTful dokümantasyonunda eski olarak belirtilir; bu yüzden eğitim Marshmallow ve webargs alternatiflerini de kapsar.

Hangi güvenlik riskleri işlenir?

SQL enjeksiyonu, mass assignment, yol geçişi ve aşırı büyük istek gövdeleri.

Mevcut projemi getirebilir miyim?

Evet; ikinci günün son modülünde kendi API örneğiniz üzerinde sertleştirme yapılabilir.

Eğitim sonunda belge verilir mi?

Katılımcılara Digital Vizyon Akademi Katılım ve Başarı Sertifikası verilir. Eğitim herhangi bir üretici sınavına doğrudan hazırlık vaat etmez; sınav söz konusu ise başvuru ve ücret ilgili kuruma aittir.

Sertifikalandırma

Bu eğitim Digital Vizyon Akademi Başarı Sertifikası ile tamamlanır.

Eğitim başında “Ön Test”, bitiminde “Son Test” uygulanarak gelişim ölçümlenir. Değerlendirme formunu dolduran katılımcılar sertifikalarını alır. Sertifikanızın geçerliliğini Sertifika Sorgulama sayfasından doğrulayabilirsiniz.

Örnek Sertifika

FLASK-RESTFUL: PARSING & VALIDATING INPUT REQUESTS EĞİTİMİ