Mini ders · Türkçe

İnsanların web sitenizde oturum açmasını nasıl sağlarsınız?

Hazır oturum açma sayfasını yönetilen bir hesap hizmetine bağlayın; e-posta kodlarını, oturum kapatmayı ve başarısız denemeleri sınayın.

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

Bu ders kimler için?

Küçük bir web sitesine hesapla giriş eklemek isteyenler için. Kimlik doğrulamayı hazır uygulama ve hesap hizmeti yürütür; kodlama asistanı kurulumda yardımcı olur. Kimlik doğrulama kodunu kendiniz yazmanız gerekmez.

Başlamadan önce

Kendi Supabase alıştırma projeniz ve izin verilen test gelen kutusu veya yapılandırılmış gönderici. Verilen sayfayı yerel HTTP üzerinden veya kendi HTTPS barındırmanızda kullanın. Kodlama asistanı kurulumda yol gösterebilir ve e-posta kodlarını yapılandırabilir.

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. E-posta teslimi ve hesap ayarı bekleme ekleyebilir. Sağlayıcının kısıtlarını ve oturum sürelerini denemede kullandığınız hesapta kontrol etmelisiniz.

Neler öğreneceksin?

  • Gerçek bir oturum açma kodu isteyip kullanın.
  • Oturum açık ve kapalı durumları doğrulayın.
  • Yanlış kodları ve eksik iletileri gerçek hata olarak koruyun.

Uygulama dosyaları

Adım 1

Oturum açma akışını anlayın

Kod almak ve oturum açmış olmak farklı anlardır.

Hazır sayfayı asistanınızla kullanın. Kişi adres girer, kodu alır ve hizmet oturumu açmadan önce bu kodu gönderir.

Sayfanın “Gelen kutunuzu kontrol edin” demesi isteğin yapıldığı anlamına gelir; ziyaretçinin kimliği doğrulanmış değildir.

Somut bir örnek

Tek başına e-posta adresi, sahibinin oturum açmayı tamamladığının kanıtı değildir.

Verilen Supabase oturum açma uygulamasını kullan. İzin verilen kendi test gelen kutumla sağlayıcının e-posta kodu kurulumunda bana yol göster; herkese açık yapılandırmaya yalnızca yayımlanabilir proje değerlerini koy ve sayfayı HTTP üzerinden çalıştır. Kod istemeyi, girmeyi, yeniden yüklemeyi ve oturumu kapatmayı sınamama yardım et. Geçersiz kod veya eksik e-posta, sahte bir oturum açık durumuna dönüşmemeli.

Supabase: e-postayla giriş kodları · Supabase: API anahtarı türleri

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)

Gerçek bir giriş oturumu oluşturun

Kimlik doğrulama, kişinin kimliğini kontrol eder; ekranda e-posta adresi göstermek yeterli değildir.

Supabase Auth ile e-postaya tek kullanımlık kod gönderecek, kod doğrulandıktan sonra oturum oluşturacağız. Tarayıcı SDK’sı oturumu saklama ve yenileme işini yönetir; parola veritabanı yazmıyoruz.

E-posta gönderme adresinin isteği kabul etmesi, kullanıcının giriş yaptığı anlamına gelmez. Oturum ancak geçerli doğrulamadan sonra oluşur. Özel verilere erişim izni ise daha sonra yapılacak ayrı bir kontroldür.

Çözülmüş örnek

Bir alana başka birinin adresini yazmak, o kişinin erişimini vermemeli. Kutusuna giden kodu doğrulamak gereken adımdır.

Supabase: e-postayla giriş kodları · Supabase: API anahtarı türleri

Extra implementation exercise

Sayfa adresi kabul edip “Check your inbox” (e-posta kutunuzu kontrol edin) diyor. Ziyaretçi artık doğrulanmış mı?

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

Hayır. Giriş isteği başlamıştır. Giriş yapıldı durumunu göstermeden önce kodu doğrulayın ve ortaya çıkan oturumu inceleyin.

  • İstek gönderilmesiyle doğrulamanın tamamlanmasını ayırır.
  • Başarılı doğrulama ve oluşturulmuş oturum ister.

Adım 2

Sağlayıcıyı ve sayfayı hazırlayın

Verilen formun beklediği kod akışını seçin.

Testten önce dört zorunlu kurulum maddesini asistana kontrol ettirin: Amaçlanan Supabase deneme projesi, gönderici ayarlarının izin verdiği gelen kutusu, giriş kodu içeren e-posta şablonu ve HTTP üzerinden çalışan sağlanan sayfa. Şablon yalnızca sihirli bağlantı içermek yerine bu kod giriş arayüzüyle uyuşmalı.

public/config.js dosyasına yalnızca proje adresi ve yayımlanabilir anahtar konur. Gizli/service-role anahtarlarını tarayıcı dosyalarından uzak tutun. Bu sağlayıcı ve çalışan uygulama kontrolleri zorunludur; kimlik doğrulama kodunu okumak veya yeniden yazmak isteğe bağlıdır.

Somut bir örnek

Çalışan e-posta bağlantısı, kod yazmanızı isteyen sayfa için yine de yanlış akış olabilir.

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)

Sağlayıcıyı ve tarayıcı istemcisini ayarlayın

E-posta şablonu ile anahtar türü, verilen kodla giriş yöntemine uygun olmalıdır.

Ayrı Supabase projesinde Email kimlik doğrulamasını açın. Göndericinin deneme kutunuza teslim edip edemediğine bakın; gerektiğinde desteklenen SMTP’yi ayarlayın. Magic Link e-posta şablonuna {{ .Token }} ekleyin ki mesaj bu sayfanın beklediği kodu içersin.

Proje URL’sini ve publishable anahtarını config.js içine yazın. Bu anahtar uygulamayı tanıtır; kullanıcı oturumu veya yönetici sırrı değildir. Bu tarayıcı dosyasına hiçbir zaman secret/service-role anahtarı koymayın. Modül içe aktarımları çalışsın diye public/ klasörünü HTTP/HTTPS üzerinden sunun.

Sayfa, kullanıcının e-postadan okuyup yazacağı tek kullanımlık kodu (OTP) bekler. Şablondaki {{ .Token }} bu kodu üretir. Yalnızca onay bağlantısı değişkeni içeren şablon, arayüzün istediği kodu sağlamaz. Bir ayar adı tahmin etmek yerine güncel parolasız e-posta kılavuzundan şablonu bulun.

Supabase’in resmi “With OTP” kılavuzu, e-posta kodlarının Magic Link altyapısını paylaştığını açıkça anlatır: Magic Link şablonuna {{ .Token }} eklenmelidir. Şablon adı, bu sayfanın yalnızca bağlantılı mesaj alması gerektiği anlamına gelmez. Panel yazıları farklıysa kılavuzu izleyin; konuyla ilgisiz bir şablon ayarı uydurmayın.

Çözülmüş örnek

SDK yöntemi signInWithOtp adını taşır ama şablona göre e-posta bir bağlantı veya kod içerebilir. Bizim arayüz kodlu sürümü bekler.

Extra implementation exercise

Sayfa kod istiyor, gelen e-postada yalnızca giriş bağlantısı var. Neyi kontrol etmelisiniz?

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

Ayarlanan şablonda Token değerini kontrol edin. Şablonu kod isteyen arayüzle uyumlu hale getirdikten sonra yeniden isteyin. Kendi projeniz için sağlayıcının güncel belgelerini izleyin.

  • E-posta şablonunu ve hedeflenen giriş yöntemini kontrol eder.
  • Kod uydurmaz veya mesajın doğrulandığını söylemez.

Adım 3

Gerçek bir oturum açmayı tamamlayın

Uydurma kod yerine e-posta iletisini kullanın.

Yeni bir gizli pencerede, oturum kapalıyken başlayın. Denetimli gelen kutunuz için kod isteyin ve önce bilerek yanlış kod girin. Denemenin reddedildiğini ve sayfanın hâlâ giriş yapılmış hesap göstermediğini doğrulayın. Sonra yeni kod isteyin, e-postadaki gerçek değeri girin ve gösterilen hesabı inceleyin.

Reddedilen kod giriş oluşturmamalı. Zaten giriş yapmışken başlarsanız yanlış kod mevcut oturumu olduğu gibi bırakabilir; bu farklı durum, yeni oturumun engellenmesini test etmez. E-posta gelmezse tam o engellenen aşamayı kaydedin.

Somut bir örnek

Reddedilen koddan sonra dostça başarı etiketi göstermek hesap durumunu yanlış yansıtı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)

Kodu isteyin ve doğrulayın

Her düğme giriş sürecinde farklı bir adımı gerçekleştirir.

public/app.js dosyasını okuyun. İlk işlem girilen e-postayla signInWithOtp çağırır; ikincisi o e-posta ve gelen kodla verifyOtp çağırır. Başarılı sonuç bir oturum içerir.

Kendi kutunuzu kullanıp güncel kodu aynen kopyalayın. Yanlış, süresi geçmiş veya kullanılmış kod, kullanıcıyı oturum açmamış halde bırakmalıdır. Kodları ve oturuma erişim sağlayan token’ları ortak rapora yazmayın.

Çözülmüş örnek

Arayüz durum ve hesap metinlerinde textContent kullanır. E-posta adresini HTML olarak yorumlamaz.

const {data,error}=await client.auth.verifyOtp({email,token,type:'email'});
if(error || !data.session) { /* keep the unverified state */ }

Extra implementation exercise

Yanlış kod hata döndürüyor ama uygulama yine “Signed in” (giriş yapıldı) gösteriyor. Hangi koşul değişmeli?

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

Yalnızca doğrulama başarılı olup oturum varsa giriş yapıldı durumunu gösterin. Düğmeye basılmasını tek başına kanıt saymayın.

  • Dönen hatayı ve oturumun varlığını kontrol eder.
  • Hata ile başarılı kimlik doğrulamayı ayrı tutar.

Adım 4

Yeniden yüklemeyi ve oturum kapatmayı kontrol edin

Görünür durumun gerçek oturumu izlediğinden emin olun.

Başarılı girişten sonra yeniden yükleyip gösterilen hesabı inceleyin. Sonra Sign out kullanıp kimliğe yeniden bakın. Bağımsız oturum kontrolü için ayrı tarayıcı profili kullanın veya yeni gizli pencere açmadan önce bütün gizli pencereleri kapatın: Ek gizli pencereler mevcut gizli oturumu paylaşabilir.

Sağlanan başlangıç, hesap durumunu gösterir; test edilecek korumalı belge içermez. Sonradan özel içerik eklerseniz sunucu onu döndürmeden önce erişimi doğrulamalı. Tek başına gizlenen düğme bu korumayı sağlayamaz.

Somut bir örnek

Oturumu kapalı sayfa, sırf etiket duruyor diye önceki hesap gibi işlem yapmaya devam etmemelidir.

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)

Oturumun sürmesini ve çıkışı kontrol edin

Yalnızca ilk başarılı kodu denemekle kalmayın.

Girişten sonra sayfayı yenileyip hesap durumuna bakın. Çıkış yapın ve tekrar yenileyin. Başka tarayıcının aynı oturumu kendiliğinden devralmadığını görmek için özel pencere kullanın.

Çıkış, bu istemcinin oturumunu temizler; herhangi bir yere kopyalanmış bütün erişim token’larının anında geçersiz olması demek değildir. Korumalı sunucu adresleri oluştururken token süresi ve iptal davranışı önemlidir.

Çözülmüş örnek

Çıkış yapılmış arayüz özel hesap bilgisini göstermemeli veya yeni isteğe otomatik olarak eski token eklememeli. Özel içerik sunan adresler yine sunucu doğrulaması gerektirir.

Extra implementation exercise

Sign in düğmesini gizlemek özel bir belgeyi korumaya yeter mi?

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

Hayır. Sunucu korunan içeriği vermeden önce isteği yapanı doğrulamalıdır. Bir sonraki özel sayfa dersi bu korumayı kurar.

  • Arayüzdeki görünümü sunucudaki erişim izninden ayırır.
  • Belge isteğinde erişim denetimi yapılmasını ister.

Adım 5

Tam hesap akışını kaydedin

Yalnızca başarı ekran görüntüsüyle değil, tekrar üretilebilir gözlemlerle bitirin.

Düzeltmeden sonra adres–e-posta–kod yolunu tekrarlayın. Oturum açma, yeniden yükleme, oturum kapatma ve anlamlı bir başarısız denemenin hassas bilgileri çıkarılmış kaydını saklayın.

Gönderici kısıtlamaları veya hesap sınırları testi engelliyorsa aşamayı tam olarak bildirin. Gerçekte teslim edilen kodun yerine yerel taklit koymayın.

Somut bir örnek

Faydalı rapor, e-posta gelmemesini, yanlış kodu ve başarılı doğrulamayı birbirinden ayırı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: hesabın bütün giriş ve çıkış adımlarını doğrulayın

Kod istendi, hata oldu, giriş yapıldı ve çıkış yapıldı durumlarını kaydedin.

Doğru girişten önce yanlış kodu deneyin. Yenileme, çıkış ve özel pencere davranışlarını kontrol edin. Yalnızca denetiminizdeki e-posta kutularını kullanın.

Belirsiz bir mesajı gerçeğini değiştirmeden iyileştirin: kod istemek bekleme durumudur; hata, başarılı oturum değildir.

Çözülmüş örnek

Raporda gözlediğiniz durumları belirtin; gelen kodu, erişim sağlayan bearer token’ı veya özel profil bilgisini göstermeyin.

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

Hesap sürecini tamamlayıp her gözlenen durumun neyi kanıtladığını açıklayın.

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

Proje URL’sini, publishable anahtarı ve mesajda beklenen kodu üretecek {{ .Token }} içeren şablonu ayarlayın. Kendi kutunuz için kod isteyin. İstenmiş e-posta, doğrulanmış oturum değildir.

Yanlış kod yazıp kullanıcı oturumu oluşmadığını doğrulayın. Yeni ve geçerli kodla giriş yapın, görünen kimliği kontrol edin, yenileyip oturumu gözleyin. Çıkış yapın ve sekmenin artık oturum bildirmediğini doğrulayın.

Özel pencerede tekrarlayın; ilk pencerenin girişini devralmamalı. Düğme gizlemek belgeyi korumaz; sunucu özel içeriği vermeden erişim iznini doğrulamalıdır.

  • Yanlış kod ve çıkış durumları doğrulanmış oturum oluşturmaz.
  • Geçerli oturum ayarlandığı kadar sürer ve istemciden çıkışın sonucu doğru biçimde doğrulanır.

Ders işine yaradı mı?

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

Öğrenmeye devam edin

Diğer dersleri inceleyin