Mini ders · Türkçe

Bir sayfayı nasıl yalnızca izin verilen kişilere açarsınız?

Bir alıştırma notunu gizli tutmak için hazır oturum açma projesini kullanın; hem izin verilen hem reddedilen erişimi sınayın.

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

Bu ders kimler için?

Yalnızca oturum açıldıktan sonra erişilebilen sayfa veya not isteyenler için. Kodlama asistanı verilen korumayı bağlayabilir; sunucu programlama öğrenmeniz gerekmez.

Başlamadan önce

Verilen oturum açma kurulumu veya eşdeğer Supabase erişimi, ayrı bir işlev barındırma projesi ve kodlama asistanı. Yalnızca sunucu ortamında tutulan kurgusal PRIVATE_NOTE kullanın; gerçek özel içerik kullanmayın.

Tahmini süre: 20–32 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 örnekte deneme projesinin bütün geçerli kullanıcıları erişebilir. Kişiye özel kayıtlar veya roller için ek erişim kuralları gerekir.

Neler öğreneceksin?

  • Özel içeriği herkese açık sayfanın dışında tutun.
  • Aynı yolu oturum kapalı ve açıkken sınayın.
  • Notu açığa çıkarmadan erişim hatasını kontrol edin.

Uygulama dosyaları

Adım 1

Neyin korunacağını seçin

Gizli olmak, yalnızca görünmemek değil yetkisiz ziyaretçinin erişememesi demektir.

Verilen kurgusal notu ve hazır projeyi kullanın. Asistandan notu indirilen herkese açık sayfa içinde değil, sunucuda tutmasını isteyin.

Öğe gizlense bile ziyaretçi herkese açık dosyaları inceleyebilir. Alıştırmaya gerçek özel bilgi koymayın.

Somut bir örnek

Sayfa biçimlendirmesiyle gizlenen paragraf hâlâ herkese açık dosyanın parçasıdır.

Bu tam özel not atölyesini ve yönetilen oturum açma alıştırma projemi kullan. PRIVATE_NOTE yalnızca özel sunucu ortamında kalsın ve verilen erişim kontrollerini koru. Uygulamayı çalıştırmama yardım et; ardından oturum kapalı doğrudan erişimi doğrulanmış oturumla karşılaştır. Paragraf gizlemeyi koruma sayma veya başka birinin verisini açığa çıkarma.

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)

Yalnızca düğmeyi değil, gönderilen yanıtı koruyun

İzinsiz tarayıcıya özel içerik en başta hiç gönderilmemelidir.

CSS ile gizlemek veya düğmeyi kapatmak arayüzü değiştirir, yanıtı değil. Herkes açık dosyaları inceleyebilir ve bir sunucu adresine doğrudan istek gönderebilir.

Sunucu ortamından bir not okuyacak ve yalnızca kullanıcı token’ını doğruladıktan sonra vereceğiz. Kurgusal not alıştırma içindir; gerçek özel veri, açık depoda değil korunan bir veri kaynağında durmalıdır.

Çözülmüş örnek

İçinde “gizlenmiş” not olan açık JavaScript dosyası hâlâ herkese verilmiş bir kopyadır. Bu örnekte değer bunun yerine public/ dışında tutulur.

Extra implementation exercise

Sayfa bir paragrafı giriş yapılana kadar saklıyor ama paragraf HTML kaynağında duruyor. Özel sayılır mı?

Çözülmüş örneği göster

Hayır. İçeriği yollamadan önce sunucu yanıtını erişim kontrolünden geçirin. Alınmış değeri saklamak onu gizli yapmaz.

  • Tarayıcının içeriği zaten aldığını fark eder.
  • Erişimi, korunan içerik gönderilmeden önce denetler.

Adım 2

Hazır korumayı bağlayın

Mevcut sunucu kontrollerini asistan yapılandırsın.

Asistanınızla run-locally.txt dosyasını izleyin. Testten önce amaçlanan kimlik doğrulama projesini, herkese açık tarayıcı değerlerini, özel sunucu kimlik doğrulama ayarlarını ve hayali PRIVATE_NOTE değerini doğrulayın. Eksiksiz projeyi başlatıp gerçek proxy adresini açın; düz dosya önizlemesi bu korumayı çalıştıramaz.

Bu hesap/sunucu hazırlık kontrolleri zorunludur. Fonksiyonun uygulama kodunu okumak isteğe bağlıdır. Hizmet, notu döndürmeden önce hesap oturumunu doğrulamalı; isteğe başka hesap kimliği yazılması kimlik kanıtı değildir.

Somut bir örnek

Kullanıcının verdiği kimlik, doğrulanmış hesap oturumuyla aynı değildir.

Supabase: doğrulanmış kullanıcı bilgisini alma · Node.js: desteklenen sürümlerin durumu

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)

Oturum token’ını sunucuya gönderin

İstemci bearer token verir; sunucu onu bağımsız olarak doğrular.

START-HERE.txt içindeki giriş dosyalarını ve sunucu ortamını ayarlayın. İstemci güncel oturumunu alır ve özel içerik adresini isterken erişim token’ını Authorization başlığında gönderir.

Sunucu bu token ve projenin publishable uygulama anahtarıyla sağlayıcının kullanıcı adresini sorgular. Eksik veya geçersiz token’ı reddeder; sağlayıcıya ulaşılamamasını doğrulanmış kimlikle karıştırmaz. Token’ın içini yalnızca okuyup doğruluğunu kontrol etmemek yeterli değildir.

İstek sırasını izleyin: tarayıcı kullanıcının erişim token’ını gönderir → sunucu kimlik sağlayıcısına bunun bir kullanıcıyı temsil edip etmediğini sorar → yalnızca doğrulanmış sonuçta not verilir. Projenin publishable anahtarı uygulamayı tanıtır; tek başına kişiyi tanımlamaz veya ona izin vermez.

Yerel çalışma sırasının tamamı için run-locally.txt dosyasını açın: kökteki özel ortamı hazırlayın, yalnızca deneme projesini bağlayın ve Netlify işlevlerine istek ileten yerel aracı başlatın. server-env.example.txt gerçek sırlar olmadan değişken adlarını listeler. Yalnızca HTML’yi açmak sunucuyu çalıştırmaz.

Çözülmüş örnek

İstemcinin gönderdiği userId, isteği yapanın o ID’ye sahip olduğunu kanıtlamaz. Doğrulamadan dönen kimliği kullanın.

const r=await fetch('/.netlify/functions/mini-private-note', {
 headers:{Authorization:'Bearer '+session.access_token}
});

Supabase: doğrulanmış kullanıcı bilgisini alma · Node.js: desteklenen sürümlerin durumu

Extra implementation exercise

Sunucu, tarayıcının JSON içindeki userId değerine güvenip izin verebilir mi?

Çözülmüş örneği göster

Hayır. Tarayıcı o alanı değiştirebilir. Kimlik bilgisini doğrulayıp doğrulanmış kullanıcıyı kullanın.

  • İstemcinin kimlik iddialarına doğrudan güvenmez.
  • Doğrulanmış token’ı ve ondan elde edilen kimliği kullanır.

Adım 3

İzin verilen kitleyi sınayın

Bu belirli öğeyi kimlerin okuyabileceğine karar verin.

Kontrolünüzdeki test hesabıyla oturum açıp kurgusal notu isteyin. Bu laboratuvarın kuralı, doğrulanmış biçimde oturum açan herhangi bir kullanıcıdır; asistandan belirtilen kapsamı korumasını isteyin.

Sonradan bir kişinin hesap verilerini saklarsanız bu geniş kural yeterli olmaz. Bütün özel verilerin aynı izinlere sahip olduğunu varsaymak yerine kitleyi belirtin.

Somut bir örnek

Ortak üye notu ve bireysel hesap kaydı farklı erişim kararları gerektirir.

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)

Yalnızca sunmayı amaçladığınız özel veriyi gönderin

Geçerli kimlik, bütün kullanıcıların kayıtlarına otomatik erişim vermez.

Bu küçük örnek, deneme projesindeki her geçerli kullanıcıya tek ortak notu okuma izni verir. Bu açık bir erişim kuralıdır; her özel içerik için geçerli genel bir tanım değildir.

Yanıt private, no-store önbellek ayarı kullanır; ortak önbelleğin notu tutmaması gerekir. Profil dersinde kişiye özel kayıtlar için sahiplik kuralları kullanılır. Bu işlevi bütün veritabanını döndürecek şekilde genişletmeyin.

Çözülmüş örnek

Sunucunun viewerId değeri doğrulamadan gelir. Not, isteğin içindeki veriden değil sunucunun ortamından okunur.

Extra implementation exercise

Not yerine başka birinin hesap bilgileri verilse “oturum açan herkes okuyabilir” kuralı uygun kalır mı?

Çözülmüş örneği göster

Hayır. Doğrulanmış kimliği istenen kayıtla veya rolle eşleştiren kural ekleyin. Yalnızca giriş yapmak başka hesaba erişim vermez.

  • Kimliği doğrulamakla belirli kayda izin vermeyi ayırır.
  • Kişiye özel veri için kayıt sahibini veya uygun rolü denetler.

Adım 4

Aynı yolu oturum kapalıyken deneyin

Doğrudan istek, normal düğme kadar önemlidir.

Gerçekten oturumu kapalı bir tarayıcı profili kullanın veya çıkış yapıp hesap durumunu doğrulayın; ardından aynı notu doğrudan istemesini asistandan isteyin. Ek gizli pencere mevcut gizli oturumu paylaşabilir. Not isteğini doğrulanmış girişle tekrarlayın.

Oturum kapalı sonuç notu içermemeli; izin verilen oturum ise notu almalıdır. İstek hatası, içeriği sızdırmadan hata olarak kalmalıdır.

Somut bir örnek

Menü bağlantısını kaldırmak, eskiden açtığı adresi korumaz.

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)

Veri adresini arayüz olmadan deneyin

Gerçek erişim testi, veri isteğini doğrudan sınar.

Yeni pencerede işlev URL’sini Authorization başlığı olmadan isteyin; not dönmemeli. Biçimi bozuk bearer token deneyin. Sonra oturum açık arayüzden izinli istek yapın.

Çıkış yapıp uygulamanın gösterilen notu temizlediğini ve tekrar oturum token’ı göndermediğini kontrol edin. Önceden verilmiş token, ayarlanan süresi dolana kadar geçerli kalabilir; bütün token’ları anında iptal etmek ayrı bir gereksinimdir.

Çözülmüş örnek

Doğrudan isteğin reddedilmesi, giriş düğmesinin ekran görüntüsünden daha fazlasını gösterir. Kayıtta yanıt durumunu ve özel metnin bulunup bulunmadığını saklayın.

Extra implementation exercise

Doğrudan istek not olmadan 401 döndürüyor, doğrulanmış oturum ise notu alıyor. Neyi test ettiniz?

Çözülmüş örneği göster

Bu adresin ortak notu vermeden önce kimlik doğruladığını test ettiniz. Diğer adresler ve kayıt sahipliği kuralları kendi denemelerini gerektirir.

  • İçeriğin sunucu tarafından verilmeden önce denetlendiğini belirler.
  • Örneğin göstermediği toplu token iptalini veya kişiye özel kayıt iznini iddia etmez.

Adım 5

Bir test değerini daha koruyun

Küçük değişiklikten sonra aynı kontrolleri tekrarlayın.

Asistandan aynı hedef kitle kuralını kullanarak yalnızca sunucuda tutulan ikinci bir kurgusal değer eklemesini isteyin. Kolaylık olsun diye iki değerden hiçbirini herkese açık dosyalara taşımayın.

İzin, ret ve hata gözlemlerini tekrarlayın. Teslim notunu hassas bilgilerden arındırın ve çalıştırılmayan testleri belirtin.

Somut bir örnek

Başka alan eklemek, özgün özel notu yanlışlıkla herkese açık yapmamalıdır.

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)

Ödeviniz: ikinci bir değeri koruyun

Yeni değeri açık dosyalara koymayın; aynı sunucu kontrollerinden geçirin.

Sunucu ortamına ikinci bir deneme değeri ekleyin. Yalnızca doğrulamadan sonra döndürüp metin olarak güvenli şekilde gösterin. Yanıt önbelleğe kaydedilemesin.

Token yok, token geçersiz ve oturum geçerli denemelerini tekrarlayın. Açık kaynak dosyalarında arama yapıp iki özel değerin de oralara yazılmadığını doğrulayın.

Çözülmüş örnek

Ödev, girişten önce gönderilen veri miktarını değil, doğrulamadan sonra verilen korunan yanıtı genişletir.

Çö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

İkinci değeri koruyup izin verilen ve reddedilen erişimlerin kanıtlarını sunun.

Çözülmüş örneği göster

private-note adresini Authorization başlığı olmadan doğrudan çağırın: 401 ve not içermeyen yanıt bekleyin. Uydurulmuş bearer token da başarısız olmalı. Tarayıcıdaki userId veya gizli düğme, sunucunun kimlik kontrolünü karşılamaz.

Kendi deneme projenizde gerçekten doğrulanmış oturum token’ıyla, ayarlanan notu ve Cache-Control: private, no-store yanıtını bekleyin. Notu açık HTML/JavaScript dışında tutun. Gerçek bearer token’ı ortak rapora yapıştırmayın.

Çıkıştan sonra arayüz özel içeriği silmeli ve doğrulanmış istek göndermeyi bırakmalı. Daha önce kopyalanmış token süresi dolana kadar kullanılabilir: arayüzde çıkış yapılması anlık iptal garantisi değildir. Ortak not uygulaması giriş yapanları yetkilendirir; kişiye ait kayıt denetimi ayrı profil alıştırmasıdır.

  • İzin doğrulanana kadar iki değer de yalnızca sunucuda kalır.
  • İzinsiz doğrudan isteklerde iki değer de bulunmaz; geçerli erişim ve no-store davranışı kontrol edilir.

Ders işine yaradı mı?

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

Öğrenmeye devam edin

Diğer dersleri inceleyin