
Mini ders 14 / 30 · Hesaplar ve erişim
Önizlemenin neyi kanıtladığını anlayın
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.
Seçili dosya adı, depolanmış yükleme ve okunabilir görsel üç farklı gözlemdir.
Bu derste ne öğreneceksiniz?
- 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.
Açıklama, çözülmüş örnek ve alıştırma
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.
Başlamak için gereken beceriler
Bu dersleri bitirmiş olmanız şart değil; gereken beceriler sizde zaten varsa buradan başlayabilirsiniz. Hazır değilseniz bağlantılardaki hazırlık derslerini açın. Başlangıç dosyaları verildiği için önceden kişisel bir siteniz olması gerekmiyor.
- İnsanların web sitenizde oturum açmasını nasıl sağlarsınız?
Gerçek bir oturum açma kodu isteyip kullanın.
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.
Konuyu anlayalım
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

Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
Sıra sizde
Sağlanan küçük görseli yüklemeden seçin. Dosya denetimi ne gösteriyor; hangi depolama/okuma kanıtı hâlâ eksik?
Çözülmüş örneği göster
Yükleme öncesi örnek gözlem: “avatar-small.webp seçince dosya denetiminde adı göründü. Bu başlangıç henüz yüklenmiş görsel göstermedi. Upload image’a basmadım ve depolanmış nesne bulmadım.”
Hâlâ yüklemem, sağlayıcıda nesneyi bulmam ve kısa süreli önizlemesini kontrol etmem gerekiyor. Başka uygulamalar yüklemeden yerel görsel gösterebilir; böyle bir önizleme de uzaktaki depolamayı kanıtlamaz.
İyi bir cevap neleri içermeli?
- Seçilen dosya adını, yükleme sonrasında dönen görselden ayrı bildirir.
- Hâlâ gereken kanıtlar olarak sağlayıcı nesnesini ve sonraki başarılı okumayı belirtir.
Nasıl çalışır? (isteğe bağlı)
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.
Ek teknik alıştırma
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.

Adım 1 · Kullanıcıların görsel yüklemesini nasıl sağlarsınız?
Özel test depolamasını hazırlayın
Kurulum için verilen ayarları ve asistanı kullanın.
Açıklama, çözülmüş örnek ve alıştırma
Konuyu anlayalım
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.
Bu adımda kullanılan dosyalar
Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
Sıra sizde
Hangi depolama ayarları uygulandı ve test hesabınız çalışan uygulamayı açabiliyor mu?
Çö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.
İyi bir cevap neleri içermeli?
- 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.
Nasıl çalışır? (isteğe bağlı)
Ö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
Ek teknik alıştırma
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.

Adım 2 · Kullanıcıların görsel yüklemesini nasıl sağlarsınız?
Küçük test resmini yükleyin
Görünür resmin yanında saklanan nesneyi de kontrol edin.
Açıklama, çözülmüş örnek ve alıştırma
Konuyu anlayalım
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.
Bu adımda kullanılan dosyalar
Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
Sıra sizde
Küçük resim saklandı mı ve sonradan okunabildi mi?
Çö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.
İyi bir cevap neleri içermeli?
- 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.
Nasıl çalışır? (isteğe bağlı)
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.
Ek teknik alıştırma
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.

Adım 3 · Kullanıcıların görsel yüklemesini nasıl sağlarsınız?
Verilen hata örneklerini deneyin
Alıştırmada yüklenmemesi gereken dosyalar da vardır.
Açıklama, çözülmüş örnek ve alıştırma
Konuyu anlayalım
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.
Bu adımda kullanılan dosyalar

Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
Sıra sizde
Aşırı büyük ve desteklenmeyen dosyalarda ne oldu; gerçekte hangi erişim yolunu sınadınız?
Çö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.
İyi bir cevap neleri içermeli?
- 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.
Nasıl çalışır? (isteğe bağlı)
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.
Ek teknik alıştırma
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.

Adım 4 · Kullanıcıların görsel yüklemesini nasıl sağlarsınız?
Yalnızca sahibin silebilmesini ekleyin
Yüklenen nesneyi kimin kaldırabildiğini doğrulayın.
Açıklama, çözülmüş örnek ve alıştırma
Konuyu anlayalım
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.
Bu adımda kullanılan dosyalar

Buradan başlayınUygulama dosyaları
Dosyaları aşağıdan açabilir veya tek tek indirebilirsin. Projeyi kaydederken dosya adlarında gösterilen klasör yapısını koru.
- 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
Sıra sizde
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.
Çö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.
İyi bir cevap neleri içermeli?
- 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.
Nasıl çalışır? (isteğe bağlı)
Ö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.
Ek teknik alıştırma
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.
Ders işine yaradı mı?
Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.