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.

Etkileşimli derse başlaDers notlarını oku

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.

Uygulama dosyaları

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

fixtures/avatar-small.webp
fixtures/avatar-small.webpBu dosyayı indir

Start hereUygulama 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.

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

Bu adımda kullanılan dosyalar

Start hereUygulama 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.

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.

Bu adımda kullanılan dosyalar

Start hereUygulama 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.

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.

Bu adımda kullanılan dosyalar

fixtures/avatar-small.webp
fixtures/avatar-small.webpBu dosyayı indir

Start hereUygulama 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.

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.

Bu adımda kullanılan dosyalar

fixtures/avatar-small.webp
fixtures/avatar-small.webpBu dosyayı indir

Start hereUygulama dosyaları

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

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.

Ders işine yaradı mı?

Beğenebilir, faydalanacağını düşündüğün biriyle paylaşabilirsin.

Öğrenmeye devam edin

Diğer dersleri inceleyin