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

Mini ders 12 / 30 · Hesaplar ve erişim

Neyin korunacağını seçin

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.

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

Bu derste ne öğreneceksiniz?

  • Ö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.
Açıklama, çözülmüş örnek ve alıştırma

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.

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.

  1. İ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: 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.

Konuyu anlayalım

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

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 notu sınıyorsunuz ve oturumu kapalı ziyaretçilerin bunu alamadığını nasıl kontrol edeceksiniz?

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

Örnek plan: “Hayali notum bir deneme toplantısı hatırlatması. Bu uygulamada doğrulanmış, giriş yapmış her test kullanıcısı okuyabilir. Notun yolunu ayrı, oturumu kapalı pencerede deneyecek ve yanıtta not olmadığını doğrulayacağım.”

Not, herkese açık sayfa dosyalarının dışında kalmalı. Bir paragrafı görsel olarak saklamak, ziyaretçinin indirilen kaynakta onu okumasını engellemez.

İyi bir cevap neleri içermeli?

  • Yalnızca sunucuda tutulan hayali notu kullanır ve uygulamanın giriş yapmış kullanıcı kitlesini belirtir.
  • Gizli bir sayfa öğesine dayanmak yerine oturum kapalı doğrudan istek planlar.
Nasıl çalışır? (isteğe bağlı)

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.

Ek teknik alıştırma

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 1 · Bir sayfayı nasıl yalnızca izin verilen kişilere açarsınız?

Hazır korumayı bağlayın

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

Açıklama, çözülmüş örnek ve alıştırma

Konuyu anlayalım

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.

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 kurulum adımı tamamlandı ve hangi gerçek uygulama URL'sini sınayabilirsiniz?

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

Örnek hazırlık kaydı: “Sağlanan uygulama, sunucunun yazdırdığı yerel proxy adresinde çalışıyor. Deneme kimlik doğrulama projesi ve hayali sunucu notu ayarlı. Not, herkese açık sayfa dosyalarında yok.”

Takılan bir kayıt şöyle olabilir: “Sayfa açılıyor ama sunucu Auth not configured bildiriyor; erişimi denemeden önce asistan özel sağlayıcı ortamını kontrol etmeli.” Sayfanın açılması tek başına sunucu korumasını doğrulamaz.

İyi bir cevap neleri içermeli?

  • Çalışan uygulama adresini ve tamamlanmış sunucu/sağlayıcı ayarlarını belirtir.
  • Özel notu veya kimlik bilgilerini yayımlamadan somut kurulum engelini bildirir.
Nasıl çalışır? (isteğe bağlı)

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

Ek teknik alıştırma

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 2 · Bir sayfayı nasıl yalnızca izin verilen kişilere açarsınız?

İzin verilen kitleyi sınayın

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

Açıklama, çözülmüş örnek ve alıştırma

Konuyu anlayalım

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

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

Alıştırma notunuzu kim okuyabilir ve oturum açık istek bu kuralla eşleşti mi?

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

Örnek erişim kaydı: “Test hesabı A doğrulandı ve hayali üye notunu aldı. Uygulama kuralı doğrulanmış giriş yapan her kullanıcı; dolayısıyla doğrulanmış başka bir test üyesi de izinli kitleye dahil.”

Bu ortak üye kuralıdır. Yalnızca A’ya açık olması gereken A’nın kişisel profili için yetersiz olurdu; o farklı sınır sahiplik kontrolü gerektirir.

İyi bir cevap neleri içermeli?

  • Uygulamanın yalnızca tek not sahibine değil, doğrulanmış giriş yapan her kullanıcıya izin verdiğini söyler.
  • Bu kuralı kişisel hesap verilerine genellemeden izinli hesabın sonucunu kaydeder.
Nasıl çalışır? (isteğe bağlı)

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.

Ek teknik alıştırma

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 3 · Bir sayfayı nasıl yalnızca izin verilen kişilere açarsınız?

Aynı yolu oturum kapalıyken deneyin

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

Açıklama, çözülmüş örnek ve alıştırma

Konuyu anlayalım

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

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

Oturum kapalı ve açık doğrudan denemeler ayrı ayrı ne döndürdü?

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

Örnek doğrudan istek kaydı: “Oturum kapalı: Not yolu Sign in required döndürdü, not dönmedi. A olarak giriş yapılmış: Aynı yol hayali notu döndürdü. Asistan token paylaşmadan bu yanıt gövdelerini incelemeye yardım etti.”

Oturum kapalı yanıt notu içeriyorsa sayfa gizlese de erişim koruması başarısızdır. Kimlik doğrulama hizmeti kullanılamıyorsa bu hatayı sıradan erişim reddinden ayrı kaydedin.

İyi bir cevap neleri içermeli?

  • Aynı not yolunu oturum kapalı istekle ve izinli giriş yapmış istekle karşılaştırır.
  • Reddedilen veya başarısız yanıtların özel not metnini içermediğini kontrol eder.
Nasıl çalışır? (isteğe bağlı)

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.

Ek teknik alıştırma

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 4 · Bir sayfayı nasıl yalnızca izin verilen kişilere açarsınız?

Bir test değerini daha koruyun

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

Açıklama, çözülmüş örnek ve alıştırma

Konuyu anlayalım

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

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

Yeni değerin korumasını ve gözlemlenen erişim sonuçlarını sunun.

Hazırlanacak çıktı: Çalışan alıştırma yolu ve gözlemlenen oturum kapalı/oturum açık/hata erişim kontrolleri.

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

Örnek geliştirme kaydı: “Özgün üye notunun yanına hayali toplantı yerini ekledim. Doğrulanmış test üyesi ikisini aldı; oturum kapalı doğrudan istek hiçbirini almadı. Geçici deneme kurulumunda kimlik doğrulamayı bilerek kullanılamaz yaptığımızda yanıt hata olarak kaldı ve iki değeri de içermedi.”

Teslim kaydı, içerikleri tekrar yazmadan iki alanı ve bu sonuçları belirtebilir. Bir hata durumu denenmediyse başarılı giriş kontrolünü bütün sınırların kanıtı saymak yerine onu denenmedi olarak listeleyin.

İyi bir cevap neleri içermeli?

  • İki hayali değeri de belirtilen ortak üye kuralı altında yalnızca sunucuda tutar.
  • Eklenen değer için izinli, reddedilen ve hizmet hatalı yanıtları yeniden dener.
Nasıl çalışır? (isteğe bağlı)

Ö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.

Ek teknik alıştırma

İ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.