
Mini ders · Türkçe
Kullanıcıların görsel yüklemesini nasıl sağlarsınız?
Boyut sınırlarını ve hesap sahipliğini kontrol ederek verilen test resimlerini yükleyin, yeniden açın ve silin.
Bu ders kimler için?
Ziyaretçilerin resim yüklemesini isteyenler için. Depolama ilkeleri veya yükleme kodu yazmadan hazır projeyi ve kodlama asistanını kullanabilirsiniz.
Başlamadan önce
Kontrolünüzdeki iki test hesabıyla ayrı bir Supabase alıştırma projesi. Küçük, aşırı büyük ve desteklenmeyen dosyalar verilir. Asistandan bu gözden çıkarılabilir projede özel avatars depolamasını ve verilen ilkeleri hazırlamasını isteyin.
Tahmini süre: 25–42 dk
Hazır örnek dosyalarla, gerekli hesap ve araçlar kurulmuşken çalışma tahmini. Kurulum, yayınlanma sırası ve e-posta/DNS beklemeleri ayrıca zaman alabilir. Bu uygulama, görselin kısıtlı alanda saklanmasını ve sahibine göre erişimi öğretir. Tarayıcı kontrolleriyle MIME ayarları, herkesten gelecek her dosya için eksiksiz zararlı yazılım ve içerik taraması oluşturmaz.
Neler öğreneceksin?
- Yerel önizlemeyi saklanan yüklemeden ayırın.
- İzin verilen ve reddedilen örnek dosyaları sınayın.
- Yalnızca sahibin silebildiğini ve başka hesabın sınırlarını kontrol edin.
Adım 1
Önizlemenin neyi kanıtladığını anlayın
Seçili dosya adı, depolanmış yükleme ve okunabilir görsel üç farklı gözlemdir.
Sağlanan uygulamayı asistanla açın ve fixtures/avatar-small.webp seçin. Upload image’a basmadan önce dosya denetiminde seçtiğiniz dosyanın adı görünür. Bu başlangıçta seçim anında yerel görsel önizlemesi oluşmaz; görsel ancak yükleme ve imzalı erişim başarıya ulaştığında görünür.
Başka uygulamalar yerel görseli kaydetmeden önizleyebilir. Bu uygulamada da yalnızca dosya adı seçmek, uzaktaki yüklemeyi kanıtlamaz. Seçimi, sağlayıcı depolamasını ve sonraki görsel okumasını ayrı kontrol edin.
Somut bir örnek
Depolama hesabı ayarlanmadan avatar-small.webp seçmek, dosya adını gösterebilir. Uzaktaki depolamayı daha sonra doğrulamak için yüklenen nesneyi sağlayıcıda bulun ve onu okuyan imzalı önizlemeyi kontrol edin.
Tam resim yükleme atölyesini ve gözden çıkarılabilir Supabase projemi kullan. Verilen ilkelerle oturum açmayı, özel avatars kovasını, belirtilen 2 MB sınırını ve izin verilen resim biçimlerini yapılandırmama yardım et. Özel anahtarları herkese açık dosyalara koyma. Sayfayı çalıştır; küçük/aşırı büyük/desteklenmeyen dosya testlerinde ve ayrı hesapla silme kontrollerinde yol göster. Kod değişikliklerini benim için yap.Bu adımda kullanılan dosyalar

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Yalnızca yerel önizlemeyi değil, görselin kendisini saklayın
Seçilen dosyadan oluşturulan önizleme, depolama hizmetinin dosyayı aldığına kanıt değildir.
Seçilen dosya önce tarayıcıdadır. Yükleme, dosyanın baytlarını nesne depolama hizmetine gönderir; hizmet dosyaya yol verir ve erişim kurallarını uygular.
Her hesap için sahibine ait klasörü olan özel Supabase alanı kullanacağız. Uygulama dosyayı yükleyip kısa süre geçerli imzalı önizleme URL’si ister. Her yüklemeyi herkese okunabilir yapmaz.
Çözülmüş örnek
Yerel blob: önizlemesi hiçbir ağ isteği olmadan çalışabilir. Biz dosyanın hizmette gerçekten oluştuğunu inceleyip izinli yoldan geri alacağız.
Extra implementation exercise
Seçilen resim blob URL’siyle hemen görünüyor. Bu, yüklemenin yapıldığını mutlaka gösterir mi?
Çözülmüş örneği göster
Hayır. Yüklendiğini söylemeden önce depolama işlemini ve karşılık gelen dosyayı doğrulayın.
- Yerel önizlemeyi uzak hizmette saklamadan ayırır.
- Yükleme sonucunu ve saklanan dosyayı kontrol eder.
Sık yapılan hata
Dosya seçmeyi tamamlanmış yükleme saymak.
Adım 2
Özel test depolamasını hazırlayın
Kurulum için verilen ayarları ve asistanı kullanın.
Gözden çıkarılabilir projenizde asistandan özel avatars kovasını, boyut/biçim sınırlarını ve policies.sql dosyasını yapılandırmasını isteyin. Tam oturum açma/yükleme uygulamasını HTTP üzerinden başlatın.
Kovanın özel, hesabın/projenin hedeflenen hesap/proje olduğunu doğrulayın. Başarısız isteği çalıştırmak için depolama korumalarını kaldırmayın.
Somut bir örnek
Ziyaretçi arayüzü dosyayı reddetmeye yardım edebilir; ancak depolama hizmeti de kendi kurallarını uygulamalıdır.
Supabase: dosya depolamada erişim denetimi
Sıra sizde
Hangi depolama ayarları uygulandı ve test hesabınız çalışan uygulamayı açabiliyor mu?
Cevabını ders asistanıyla değerlendir
Çözülmüş örneği göster
Örnek kurulum kaydı: “Asistan geçici deneme projesinde özel avatars kovasını hazırladı, belirtilen 2 MB PNG/JPEG/WebP sınırlarını ayarladı ve sağlanan sahip klasörü politikalarını uyguladı. HTTP uygulaması açılıyor, A giriş yapabiliyor.”
Yükleme bu kontroller tamamlanmadan başarısızsa eksik kurulum aşamasını kaydedin. Kovayı herkese açmak veya sahiplik kurallarını kaldırmak geçerli bir kestirme değildir.
- Geçici deneme projesini, özel avatars kovasını ve ayarlanan biçim/boyut sınırlarını belirtir.
- Depolama korumalarını zayıflatmadan çalışan giriş/yükleme uygulamasını ve kurulum engelini kaydeder.
Bu adımda kullanılan dosyalar
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Özel dosya alanını ve sahiplik kurallarını oluşturun
Alan ayarlarıyla erişim kuralları, aynı işin farklı parçalarını denetler.
avatars alanını özel oluşturun. 2MB sınırını ve MIME türlerini ayarlayıp policies.sql uygulayın. Tarayıcı rolleri yalnızca doğrulanmış kullanıcı ID’sinin altındaki yollara yazabilmeli ve oraları okuyabilmeli.
İstemcideki accept özelliği kolaylık sağlar, güvenlik kontrolü değildir. Boyut, tür ve sahiplik kuralları doğrudan isteklerde de uygulanmalı. MIME tür etiketi tek başına dosyanın içeriğinin güvenli olduğunu göstermez; bu uygulamayı tam tarama hizmeti gibi sunmayın.
USER_A/avatar-1.webp için storage.foldername(name), klasör parçalarını döndürür; bu PostgreSQL dizisinde [1] ilk parçayı seçer. Bu parça doğrulanmış kullanıcının ID’sine eşit olmalıdır. A hesabı için USER_B/avatar-1.webp başarısız olur. Depolama tarafındaki kural, tarayıcının dosya seçicisi ve MIME ön kontrolünden ayrıdır.
İç içe klasör olsa da ilk parça kullanıcı ID’sidir: USER_A/subfolder/avatar.webp içinde [1] yine USER_A olur. subfolder/USER_A/... ile başlayan yol eşleşmez. Sahip ID’sini başta tutun; yanlış yolu kabul ettirmek için kuralı gevşetmeyin.
Çözülmüş örnek
Klasör başlangıcı oturum açan kullanıcıdan gelir; veritabanı kuralı bunu auth.uid() ile karşılaştırır. Tarayıcıdaki yolu başka kullanıcının klasörüne çevirmek izin vermemelidir.
create policy "upload own avatar" on storage.objects for insert to authenticated
with check (bucket_id='avatars' and (storage.foldername(name))[1]=auth.uid()::text);
create policy "read own avatar" on storage.objects for select to authenticated
using (bucket_id='avatars' and (storage.foldername(name))[1]=auth.uid()::text);
Supabase: dosya depolamada erişim denetimi
Extra implementation exercise
Dosya uzantısına yalnızca JavaScript’te bakmak neden yeterli değil?
Çözülmüş örneği göster
İstemci, farklı dosya bilgileri veya yol içeren doğrudan istek gönderebilir. Hedeflenen alan ve sahip kurallarını hizmetin kendisinde uygulayın.
- İsteği yapanın JavaScript kontrolünü atlayabileceğini bilir.
- Kısıtların ve iznin depolama hizmetinde uygulanmasını ister.
Sık yapılan hata
Bozuk önizlemeyi düzeltmek için bütün dosya alanını herkese açmak.
Adım 3
Küçük test resmini yükleyin
Görünür resmin yanında saklanan nesneyi de kontrol edin.
A hesabıyla oturum açıp verilen küçük resmi yükleyin. Sağlayıcıda nesnesini bulun ve oluşan önizlemeyi veya imzalı erişim yolunu kullanın.
Depolama başarılı ama önizleme başarısızsa başka kopya yüklemeden önce okumayı/önizlemeyi araştırın. Kaydedilen nesne referansını saklayın.
Somut bir örnek
Önizlemenin görünmemesi, yüklemenin kendisinin başarısız olduğu anlamına gelmeyebilir.
Sıra sizde
Küçük resim saklandı mı ve sonradan okunabildi mi?
Cevabını ders asistanıyla değerlendir
Çözülmüş örneği göster
Örnek yükleme kaydı: “A, avatar-small.webp yükledi. Sağlayıcı A’nın klasöründe bir nesne gösterdi; hassas değerleri ayıklanmış referansını kaydettim. Ardından görsel kısa süreli imzalı önizlemede göründü.”
Kısmi sonuç şöyle olabilir: “Nesne var ama önizleme erişimi başarısız.” Bu, depolamanın başarılı olup olmadığını bilmeden tekrar tekrar kopya yüklemeyi değil, aynı nesnenin okuma/erişim kontrolünü gerektirir.
- A’nın başarılı yüklemesini gerçek depolanmış nesne referansına bağlar.
- İmzalı önizlemenin o nesneyi okuyup okuyamadığını ayrıca kaydeder.
Bu adımda kullanılan dosyalar
Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Sahibine ait benzersiz bir yola yükleyin
İstemcinin istediği yola güvenmek veya mevcut dosyanın üzerine yazmak yerine yeni dosya adı üretin.
Girişten sonra uygulama doğrulanmış kullanıcı ID’si ve rastgele dosya adıyla yol seçer. Göndermeden önce boyut ve türü kontrol eder ama bunlar sağlayıcının denetimlerinin yerini tutmaz.
Yüklemede upsert, yani varsa üzerine yazma açılmaz. Saklama başarılı olup imzalı URL oluşturulamazsa arayüz bunları ayrı sonuçlar olarak bildirir. Dosya zaten var olabilecekken “hiçbir şey yüklenmedi” demez.
Çözülmüş örnek
Üretilmiş ad, photo.jpg adlı başka resimle yanlışlıkla çakışmayı önler. Kendi başına erişim izni mekanizması değildir.
Extra implementation exercise
Dosya var ama önizleme oluşturulamadı. Hemen başka kopya mı yüklemelisiniz?
Çözülmüş örneği göster
Önce dosya yolunu ve okuma iznini kontrol edin. Tekrar yüklemek önizlemeyi düzeltmeden kopyalar oluşturabilir.
- Başarılı yüklemeyi önizleme izninden ayrı tutar.
- Kopya oluşturmadan okuma kuralını ve yolu inceler.
Sık yapılan hata
Rastgele dosya adını erişim denetiminin yerine koymak.
Adım 4
Verilen hata örneklerini deneyin
Alıştırmada yüklenmemesi gereken dosyalar da vardır.
fixtures/avatar-too-large.png ve fixtures/not-an-image.txt dosyalarını kullanın. Sayfanın ve depolamanın tepkisini kaydedin. Asistandan anlaşılmayan reddi veya kabul edilmiş geçersiz dosyayı incelemesini isteyin.
Reddedilen dosyalar saklanan nesnelere dönüşmemelidir. Geçerli imzalı URL, süresi boyunca elinde bulunduranın resmi görmesine izin verebilir; bu tek başına kovanın herkese açık olduğunun kanıtı değildir.
Somut bir örnek
Dosya seçici kısıtlaması ve gerçek depolama yaptırımı ayrı kontrollerdir.
Sıra sizde
Aşırı büyük ve desteklenmeyen dosyalarda ne oldu; gerçekte hangi erişim yolunu sınadınız?
Cevabını ders asistanıyla değerlendir
Çözülmüş örneği göster
Örnek ret kaydı: “Çok büyük PNG reddedildi ve yeni nesne oluşmadı. Metin dosyası da reddedildi; dosya seçici desteklenmeyen biçimleri gizlediyse asistan test etmeye yardım etti.”
“İzinli görselin imzalı adresi kısa geçerlilik süresinde açıldı. Bu, özel kovanın herkese açıldığını değil o adres üzerinden erişimi gösterdi.” Dosya seçicinin filtresi tek başına sağlayıcının depolama sınırlarını doğrudan test etmez.
- Sağlanan iki geçersiz dosyanın ret ve depolama gözlemlerini ayrı kaydeder.
- Geçici imzalı bağlantıdan okumayı, kovaya sınırsız herkese açık erişimden ayırır.
Bu adımda kullanılan dosyalar

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
How it works (optional)
Reddetmeyi ve geçici erişimi doğrulayın
Hizmet kurallarını deneyin; imzalı bağlantının neye izin verdiğini anlayın.
A hesabıyla fixtures/avatar-small.webp dosyasını yükleyin. Depolama yolunu inceleyip yetkili imzalı önizlemeyi açın. Ardından 2MiB sınırını aşan fixtures/avatar-too-large.png ve desteklenmeyen fixtures/not-an-image.txt dosyalarını deneyin; ikisi de reddedilmeli. Üç dosya da ders paketinde var.
B hesabıyla A’nın yolu için imzalı bağlantı isteyin; sahiplik kuralı reddetmeli. A’ya kurallara uygun verilmiş URL ise eline geçiren herkes tarafından süresi dolana kadar kullanılabilir. İstemciden çıkış bütün URL’leri anında iptal etmez.
Çözülmüş örnek
Yararlı rapor, hassas bilgileri çıkarılmış yolu ve geçerlilik süresini kaydeder; tam geçici erişim adresini paylaşmaz.
Extra implementation exercise
Geçerli imzalı URL’si olan kişi giriş yapmadan resmi açıyor. Bu tek başına özel alanın kuralının bozulduğunu gösterir mi?
Çözülmüş örneği göster
Hayır. İzinsiz hesabın URL oluşturup oluşturamadığını veya yetkili bağlantı olmadan okuyup okuyamadığını sınayın. Verilmiş adresleri süreleri bitene kadar hassas kabul edin.
- İmzalı URL’nin, elinde tutana geçici erişim verdiğini bilir.
- URL’yi kullanmakla onu oluşturma iznini ayırır.
Sık yapılan hata
İmzalı URL’yi hata raporunda yayımlayıp özel kalmasını beklemek.
Adım 5
Yalnızca sahibin silebilmesini ekleyin
Yüklenen nesneyi kimin kaldırabildiğini doğrulayın.
Sağlanan yalnızca sahibinin silebildiği davranışı eklemesini asistandan isteyin. A olarak ilk test nesnesi X’i silin ve depolamada bulunmadığını doğrulayın. Ardından A olarak yeni Y nesnesini yükleyin; sonraki kontrol için Y’nin hassas değerlerden arındırılmış referansını tutun.
B’nin ayrı oturumunda Y’yi doğrudan silme denemesinin hedefi yapmasını asistandan isteyin. İşlemi yapan B’yi, hedef Y’yi ve sağlayıcı sonucunu kaydedin; ardından A’nın Y nesnesinin hâlâ var olduğunu doğrulayın. Yalnızca gizli silme düğmesine bakmak veya zaten olmayan X’i tekrar silmek, bu sahiplik sınırını doğrulamaz.
Somut bir örnek
Resmi ekrandan kaldırmak, saklanan nesneyi silmekle aynı değildir.
Sıra sizde
Başlangıç malzemeleri
Başlangıç dosyaları ve deneme içerikleri hazır. Gerçek servis doğrulaması için Başlamadan önce bölümünde belirtilen kendi hesabınız, gelen kutunuz veya alan adınız gerekir. Bunlar olmadan dosyaları inceleyebilirsiniz; gerçekten denemediğiniz canlı adımı denenmedi diye kaydedin.
Sahibin silmesini ve ikinci hesap denemesini gerçek nesne sonuçlarıyla sunun.
Hazırlanacak çıktı Yükleme/silme sonucu ve gerçek geçerli, aşırı büyük, desteklenmeyen dosya ve hesaplar arası kontroller.
Cevabını ders asistanıyla değerlendir
Çözülmüş örneği göster
Örnek silme kaydı: “A, X nesnesini sildi; sağlayıcı X’in yokluğunu doğruladı. A sonra yeni Y nesnesini yükledi. B’nin ayrı oturumu Y’yi silmeyi denedi; A, Y’nin hâlâ var olduğunu kontrol etti.”
Asistan yalıtılmış testi yapmadan önce işlemi yapan B’yi ve hedef Y’yi belirtmeli. X’i tekrar silmeye çalışmak, yalnızca sahibine izin verilmesini değil zaten olmayan nesneyi test ederdi.
- A’nın ilk nesnesini sahibi olarak siler ve tam o nesnenin yok olduğunu doğrular.
- A’ya ait yeni nesne yükler, B’den onu hedefler ve depolamada kaldığını doğrular.
Bu adımda kullanılan dosyalar

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.
- policies.sqlBu dosyayı indir
- public/app.jsBu dosyayı indir
- upload-tests.txtBu dosyayı indir
- worksheet.htmlBu dosyayı indir
- reference/assignment-walkthrough.txtBu dosyayı indir
- reference/START-HERE.txtBu dosyayı indir
- reference/public/index.htmlBu dosyayı indir
- reference/public/app.jsBu dosyayı indir
- reference/delete-policy.sqlBu dosyayı indir
- fixtures/avatar-small.webpBu dosyayı indir
- fixtures/avatar-too-large.pngBu dosyayı indir
- fixtures/not-an-image.txtBu dosyayı indir
How it works (optional)
Ödeviniz: yalnızca sahibinin silebildiği bir işlem ekleyin
Yeni işlem, kendine ait erişim kuralı ve reddedilme denemeleri ister.
Yüklenen dosyayı silen kontrol ve sahibin klasörüyle sınırlı DELETE kuralı ekleyin. Mevcut özel alanı herkese açık ortak alana dönüştürmeyin.
A’nın kendi dosyasını silebildiğini, B’nin silemediğini doğrulayın. Başarısız silmeden sonra arayüz depolamadaki gerçek durumu göstermeye devam etsin.
Çözülmüş örnek
İlk kurallar bilerek yalnızca ekleme ve okumaya izin verir. Dosya yükleme izni, otomatik olarak silme izni sağlamaz.
Çözümün bütün adımlarını reference/assignment-walkthrough.txt dosyasında bulabilirsiniz. Adımları kendi sonucunuzla karşılaştırın; kontrol kaydını kendi projenizde gözlemlediklerinizle doldurun.
Extra implementation exercise
Yalnızca sahibin silmesini kurun ve hem izin verilen hem reddedilen girişimi gösterin.
Çözülmüş örneği göster
Özel avatars alanında boyut/tür ayarlarını ve kullanıcı klasörü kurallarını uygulayın. A olarak izinli görsel yükleyin; dönen sonucu inceleyip kısa süreli imzalı önizlemeyi açın. Tek başına blob önizlemesi uzak yüklemeyi kanıtlamaz.
Desteklenmeyen veya büyük dosyayı, ayrıca B’nin klasörüne yükleme/okumayı deneyin. A, geliştirici araçlarında yolu değiştirerek izin kazanmamalı. İmzalı URL’ler ise bilerek süreli erişim verir.
Silme işlemi için aynı bucket ve sahip klasörü koşulunu kullanan bir DELETE kuralı ekleyin; remove çağrısında saklanan tam dosya yolunu kullanın. Ardından nesnenin artık bulunmadığını doğrulayın. Başka hesaba ait dosyayı silmeyi denediğinizde ise o dosyanın değişmeden kaldığını kontrol edin. Örnek silme modülü ayrıdır; kendi kodunuza eklemeden önce dosya yolunu ve erişim kuralını inceleyebilirsiniz.
- Silme izni alanı ve doğrulanmış kullanıcıya ait klasörü kontrol eder.
- Başarısız girişimler başka hesabın dosyasını silmez ve arayüzü silinmiş gibi temizlemez.
Sık yapılan hata
Bir düğme çalışsın diye bütün giriş yapmış kullanıcılara DELETE vermek.
Ders işine yaradı mı?
Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.
Öğrenmeye devam edin
- İlk kişisel web sitenizi nasıl kurarsınız?
- Web sitenizi GitHub üzerinden nasıl yayımlarsınız?
- Kendi alan adınızı web sitenize nasıl bağlarsınız?
- Kendi alan adınızla e-posta nasıl kurulur
- Web sitenizi telefonda rahat kullanılır hale nasıl getirirsiniz?
- Web sitenizdeki görsellerin daha hızlı yüklenmesini nasıl sağlarsınız?
- Sitenize gelen geri bildirimler gelen kutunuza nasıl ulaşır
- Sitenize e-posta aboneliği nasıl eklenir
- Web sitenizden otomatik e-posta nasıl gönderirsiniz?
- Formdan gelen bilgileri veritabanına nasıl kaydedersiniz?
- İnsanların web sitenizde oturum açmasını nasıl sağlarsınız?
- Bir sayfayı nasıl yalnızca izin verilen kişilere açarsınız?
- Kullanıcıların profil bilgilerini düzenlemesini nasıl sağlarsınız?
- API anahtarlarını tarayıcıya göndermeden nasıl kullanırsınız?
- Başka bir API’den gelen veriyi web sitenizde nasıl gösterirsiniz?
- Web sitenize yapay zekâ sohbeti nasıl eklersiniz?
- Sohbetin kendi içeriğinize dayanarak yanıt vermesini nasıl sağlarsınız?
- Web sitenize nasıl blog eklersiniz?
- Web sitenize nasıl arama eklersiniz?
- Web sitenize nasıl başka bir dil eklersiniz?
- Google’ın sitenizi bulmasına nasıl yardımcı olursunuz
- Bağlantı paylaşırken sitenizin önizlemesi nasıl düzeltilir
- Sitenizde ziyaretler ve yararlı işlemler nasıl ölçülür
- Ziyaretçilerin randevu almasını nasıl sağlarsınız?
- Web sitenizde ödeme nasıl alınır
- Yayımlamadan önce site değişiklikleri nasıl önizlenir
- Hatalı yayımlanan web sitenizi önceki çalışan sürüme nasıl döndürürsünüz?
- Web sitenizin verilerini nasıl yedekler ve geri yüklersiniz?
- Canlı sitenizdeki hatalar nasıl bulunur ve düzeltilir