Mini-Lektion · Deutsch

So können sich Menschen auf deiner Website anmelden

Verbinde die fertige Anmeldeseite mit einem verwalteten Kontodienst und teste E-Mail-Codes, Abmeldung und fehlgeschlagene Versuche.

Interaktive Lektion startenLektionsnotizen lesen

Für wen ist das gedacht?

Für alle, die auf einer kleinen Website eine Kontoanmeldung möchten. Ein verwalteter Dienst und die bereitgestellte App übernehmen die Umsetzung; du kannst mit einem Programmierassistenten arbeiten, ohne Authentifizierungscode zu schreiben.

Bevor du beginnst

Dein eigenes Supabase-Übungsprojekt und ein zulässiges Testpostfach oder eingerichteter Absender. Nutze die bereitgestellte Seite über lokales HTTP oder deinen eigenen HTTPS-Hostingdienst. Ein Programmierassistent kann dich durch die Einrichtung führen und E-Mail-Codes konfigurieren.

Geschätzte Dauer: 20–32 Min.

Schätzungen für die mitgelieferten Startdateien bei bereits eingerichteten Konten und Werkzeugen. Einrichtung, Deployment-Warteschlangen sowie E-Mail- und DNS-Wartezeiten kommen hinzu. E-Mail-Zustellung und Kontoeinrichtung können Wartezeit verursachen. Anbieterbeschränkungen und Sitzungslebensdauer müssen im für die Übung verwendeten Konto geprüft werden.

Was du lernen wirst

  • Fordere einen echten Anmeldecode an und verwende ihn.
  • Prüfe den angemeldeten und abgemeldeten Zustand.
  • Behandle falsche Codes und fehlende Nachrichten ehrlich als Fehler.

Workshop-Dateien

Schritt 1

Verstehe den Anmeldeablauf

Einen Code zu empfangen und angemeldet zu sein sind verschiedene Zeitpunkte.

Nutze die fertige Seite mit deinem Assistenten. Die Person gibt eine Adresse ein, empfängt einen Code und übermittelt ihn, bevor der Dienst die Anmeldung herstellt.

Die Seitenmeldung „Prüfe deinen Posteingang“ bedeutet, dass eine Anfrage gestellt wurde, nicht dass der Besucher authentifiziert ist.

Ein konkretes Beispiel

Eine E-Mail-Adresse allein belegt nicht, dass ihr Eigentümer die Anmeldung abgeschlossen hat.

Nutze die bereitgestellte Supabase-Anmeldeapp. Führe mich durch die Einrichtung von E-Mail-Codes beim Anbieter mit meinem eigenen zulässigen Testpostfach, trage nur veröffentlichbare Projektwerte in die öffentliche Konfiguration ein und starte die Seite über HTTP. Hilf mir, Codeanforderung, Codeeingabe, Neuladen und Abmeldung zu testen. Ein ungültiger Code oder eine fehlende E-Mail dürfen nicht zu einem vorgetäuschten Anmeldestatus führen.

Supabase: Anmeldecodes per E-Mail · Supabase: API-Schlüsseltypen

Dateien für diesen Schritt

Start hereWorkshop-Dateien

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

How it works (optional)

Ergänze eine echte Anmeldesitzung

Authentifizierung bestätigt eine Identität; die Anzeige einer E-Mail-Adresse reicht nicht aus.

Wir verwenden Supabase Auth, um einen einmaligen E-Mail-Code zu senden und nach seiner Prüfung eine Sitzung herzustellen. Das Browser-SDK verwaltet Sitzungsspeicherung und Erneuerung; wir implementieren keine Passwortdatenbank.

Eine vom E-Mail-Endpunkt akzeptierte Anfrage bedeutet nicht, dass ein Nutzer angemeldet ist. Die Sitzung entsteht erst nach einer gültigen Verifizierung. Die Autorisierung für private Daten ist eine spätere, eigenständige Prüfung.

Ausgearbeitetes Beispiel

Die Eingabe der E-Mail-Adresse einer anderen Person darf deren Zugriff nicht gewähren. Der ans Postfach gesendete Code ist der Verifizierungsschritt.

Supabase: Anmeldecodes per E-Mail · Supabase: API-Schlüsseltypen

Extra implementation exercise

Die Seite hat eine E-Mail-Adresse akzeptiert und sagt „Check your inbox“. Ist der Besucher bereits authentifiziert?

Ausgearbeitete Lösung anzeigen

Nein. Die Anmeldeanfrage wurde begonnen. Prüfe den Code und die daraus entstandene Sitzung, bevor du einen angemeldeten Zustand anzeigst.

  • Hält angeforderten und verifizierten Zustand auseinander.
  • Verlangt erfolgreiche Verifizierung und eine Sitzung.

Schritt 2

Bereite Anbieter und Seite vor

Wähle den Codeablauf, den das bereitgestellte Formular erwartet.

Lass deinen Assistenten vor dem Test vier notwendige Einrichtungspunkte prüfen: das vorgesehene Supabase-Übungsprojekt, ein durch dessen Absendereinstellungen erlaubtes Postfach, eine E-Mail-Vorlage mit Anmeldecode und die über HTTP laufende mitgelieferte Seite. Die Vorlage muss zu dieser Codeeingabe passen, statt nur einen Magic Link zu enthalten.

In public/config.js gehören nur Projekt-URL und veröffentlichbarer Schlüssel. Geheime beziehungsweise Service-Role-Schlüssel dürfen nicht in Browserdateien stehen. Diese Anbieter- und App-Prüfungen sind erforderlich; die Authentifizierungsimplementierung zu lesen oder umzuschreiben ist optional.

Ein konkretes Beispiel

Ein funktionierender E-Mail-Link kann dennoch der falsche Ablauf für eine Seite sein, die eine Codeeingabe verlangt.

Dateien für diesen Schritt

Start hereWorkshop-Dateien

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

How it works (optional)

Konfiguriere Anbieter und Browserclient

E-Mail-Vorlage und Schlüsseltyp müssen zum mitgelieferten Code-Ablauf passen.

Aktiviere in einem separaten Supabase-Projekt die Email-Authentifizierung. Prüfe, ob der Absender dein Testpostfach erreichen kann; richte bei Bedarf unterstütztes SMTP ein. Füge in der E-Mail-Vorlage Magic Link {{ .Token }} ein, damit die Nachricht den von dieser Seite erwarteten Code liefert.

Trage Projekt-URL und veröffentlichbaren Schlüssel in config.js ein. Der Schlüssel identifiziert die Anwendung; er ist weder Nutzersitzung noch administratives Geheimnis. Trage niemals einen geheimen oder service-role-Schlüssel in diese Browserdatei ein. Stelle public/ über HTTP/HTTPS bereit, damit Modulimporte funktionieren.

Die Seite erwartet einen eingetippten E-Mail-Code (OTP). In der E-Mail-Vorlage des Anbieters gibt {{ .Token }} diesen Code aus; eine Vorlage mit ausschließlich einer Bestätigungslink-Variablen liefert dieser Oberfläche nicht den verlangten Code. Finde die Vorlage mithilfe der aktuellen Anleitung zu passwortloser E-Mail, statt einen Einstellungsnamen zu erraten.

Die offizielle Supabase-Anleitung „With OTP“ erklärt ausdrücklich, dass E-Mail-Codes dieselbe Implementierung wie Magic Link verwenden: Passe die Magic-Link-E-Mail-Vorlage so an, dass sie {{ .Token }} enthält. Der Name bedeutet nicht, dass diese Seite eine Nachricht mit ausschließlich einem Link erhalten soll. Folge bei abweichenden Dashboard-Bezeichnungen dieser Anleitung und erfinde keine andere Vorlageneinstellung.

Ausgearbeitetes Beispiel

Die SDK-Methode heißt signInWithOtp, aber die E-Mail kann je nach Vorlage einen Link oder einen Code enthalten. Unsere Oberfläche erwartet die Code-Variante.

Extra implementation exercise

Deine Seite verlangt einen Code, aber die E-Mail enthält nur einen Magic Link. Was solltest du prüfen?

Ausgearbeitete Lösung anzeigen

Prüfe die konfigurierte Vorlage auf den Token-Wert und wiederhole die Anfrage, nachdem du sie an die Code-Oberfläche angepasst hast. Folge der aktuellen Anbieterdokumentation für dein Projekt.

  • Prüft E-Mail-Vorlage und vorgesehenen Ablauf.
  • Erfindet keinen Code und behauptet keine erfolgte Nachrichtenverifizierung.

Schritt 3

Schließe eine echte Anmeldung ab

Nutze die E-Mail-Nachricht statt eines erfundenen Codes.

Beginne abgemeldet in einem frischen privaten Fenster. Fordere einen Code für dein kontrolliertes Postfach an und gib absichtlich zuerst einen falschen ein. Prüfe, dass der Versuch abgelehnt bleibt und die Seite weiterhin kein angemeldetes Konto meldet. Fordere dann einen neuen Code an, gib den echten Wert aus der E-Mail ein und prüfe das angezeigte Konto.

Ein abgelehnter Code darf keine Anmeldung erzeugen. Beginnst du bereits angemeldet, kann ein falscher Code die bestehende Sitzung unverändert lassen; das ist eine andere Situation und prüft nicht die Verhinderung einer neuen Sitzung. Kommt keine E-Mail an, halte genau diese blockierte Stufe fest.

Ein konkretes Beispiel

Eine freundliche Erfolgsmeldung nach einem abgewiesenen Code würde den Kontostatus falsch darstellen.

Dateien für diesen Schritt

Start hereWorkshop-Dateien

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

How it works (optional)

Fordere einen Code an und prüfe ihn

Jede Schaltfläche entspricht einem anderen Zustandsübergang.

Lies public/app.js. Die erste Aktion ruft signInWithOtp mit der eingegebenen E-Mail-Adresse auf; die zweite ruft verifyOtp mit dieser Adresse und dem erhaltenen Token auf. Ein erfolgreiches Ergebnis enthält eine Sitzung.

Nutze dein eigenes Postfach und kopiere den aktuellen Code exakt. Ein falscher, abgelaufener oder bereits verwendeter Code sollte den Nutzer unangemeldet lassen. Protokolliere Codes oder Zugriffstokens nicht in einem geteilten Bericht.

Ausgearbeitetes Beispiel

Die Oberfläche verwendet textContent für Status- und Kontotext. Sie interpretiert E-Mail-Adressen nicht als HTML.

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

Extra implementation exercise

Ein falscher Code liefert einen Fehler, aber deine Anwendung zeigt trotzdem „Signed in“. Welche Bedingung muss sich ändern?

Ausgearbeitete Lösung anzeigen

Zeige den angemeldeten Zustand nur, wenn die Verifizierung gelingt und eine Sitzung existiert. Nutze den Klick auf die Schaltfläche selbst nicht als Beweis.

  • Prüft zurückgegebenen Fehler und Sitzung.
  • Trennt Fehler von erfolgreicher Authentifizierung.

Schritt 4

Prüfe Neuladen und Abmeldung

Stelle sicher, dass der sichtbare Zustand der tatsächlichen Sitzung folgt.

Lade nach erfolgreicher Anmeldung neu und prüfe das angezeigte Konto. Nutze danach Sign out und prüfe die Identität erneut. Verwende für eine unabhängige Sitzungsprüfung ein separates Browserprofil oder schließe alle privaten Fenster, bevor du ein neues öffnest. Zusätzliche private Fenster können die bereits bestehende private Sitzung teilen.

Der mitgelieferte Starter zeigt den Kontostatus; er enthält kein geschütztes Dokument zum Testen. Fügst du später private Inhalte hinzu, muss ein Server den Zugriff prüfen, bevor er sie zurückgibt. Eine versteckte Schaltfläche allein kann diesen Schutz nicht leisten.

Ein konkretes Beispiel

Eine abgemeldete Seite darf nicht weiter im Namen des vorherigen Kontos handeln, nur weil eine Beschriftung stehen bleibt.

Dateien für diesen Schritt

Start hereWorkshop-Dateien

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

How it works (optional)

Prüfe Sitzungsfortbestand und Abmeldung

Teste mehr als den ersten erfolgreichen Code.

Aktualisiere nach der Anmeldung die Seite und prüfe den Kontozustand. Melde dich dann ab und aktualisiere erneut. Prüfe mit einem privaten Fenster, dass ein anderer Browser die Sitzung nicht automatisch übernimmt.

Die Abmeldung löscht die Sitzung dieses Clients; sie bedeutet nicht, dass jeder irgendwo kopierte Zugriffstoken sofort unwirksam wird. Zugriffstoken-Lebensdauer und Widerrufsverhalten sind beim Aufbau geschützter Serverendpunkte relevant.

Ausgearbeitetes Beispiel

Eine abgemeldete Oberfläche sollte weder private Kontoanzeigen behalten noch automatisch einen alten Token an eine neue Anfrage hängen. Private Endpunkte benötigen weiterhin serverseitige Verifizierung.

Extra implementation exercise

Reicht es, die Schaltfläche Sign in zu verbergen, um ein privates Dokument zu schützen?

Ausgearbeitete Lösung anzeigen

Nein. Der Server muss den Aufrufer prüfen, bevor er geschützte Inhalte zurückgibt. Die nächste Lektion zu privaten Seiten setzt diese Grenze um.

  • Trennt Oberflächenzustand von serverseitiger Autorisierung.
  • Verlangt Zugriffsprüfungen bei der Dokumentanfrage.

Schritt 5

Halte den gesamten Kontoablauf fest

Schließe mit nachvollziehbaren Beobachtungen ab, nicht nur mit einem Erfolgsscreenshot.

Wiederhole nach jeder Korrektur den Weg über Adresse, E-Mail und Code. Speichere eine um vertrauliche Angaben bereinigte Aufzeichnung zu Anmeldung, Neuladen, Abmeldung und einem aussagekräftigen fehlgeschlagenen Versuch.

Blockieren Absenderbeschränkungen oder Kontolimits den Test, benenne diese Stufe genau. Ersetze einen tatsächlich zugestellten Code nicht durch eine lokale Nachbildung.

Ein konkretes Beispiel

Ein hilfreicher Bericht unterscheidet fehlende E-Mail, falschen Code und erfolgreiche Verifizierung.

Dateien für diesen Schritt

Start hereWorkshop-Dateien

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

How it works (optional)

Deine Aufgabe: prüfe den vollständigen Kontoablauf

Dokumentiere die Zustände angefordert, fehlgeschlagen, angemeldet und abgemeldet.

Teste vor einer gültigen Anmeldung einen falschen Code. Prüfe das Verhalten beim Aktualisieren, Abmelden und im privaten Fenster. Nutze nur eigene Postfächer.

Verbessere eine unklare Meldung, ohne ihren Wahrheitsgehalt zu verändern: Ein angeforderter Code ist ausstehend, und ein Fehler ist keine erfolgreiche Sitzung.

Ausgearbeitetes Beispiel

Der Bericht sollte beobachtete Zustände benennen, ohne erhaltenen Code, Bearer-Token oder private Profilinformationen offenzulegen.

Die vollständige exemplarische Anleitung findest du in reference/assignment-walkthrough.txt. Vergleiche ihre Schritte mit deinem Ergebnis und fülle das Testprotokoll mit Beobachtungen aus deinem eigenen Projekt aus.

Extra implementation exercise

Durchlaufe den vollständigen Kontoablauf und erkläre, was jeder beobachtete Zustand belegt.

Ausgearbeitete Lösung anzeigen

Konfiguriere Projekt-URL und veröffentlichbaren Schlüssel sowie eine Vorlage mit {{ .Token }}, damit die Nachricht den erwarteten Code enthält. Fordere einen Code für dein eigenes Postfach an. Eine angeforderte E-Mail ist keine verifizierte Sitzung.

Gib einen falschen Code ein und bestätige, dass keine Nutzersitzung entsteht. Verwende einen neuen gültigen Code, prüfe die angezeigte Identität, lade neu und beobachte die Sitzung. Melde dich ab und prüfe, ob der Tab keine Sitzung mehr meldet.

Wiederhole den Ablauf im privaten Fenster: Es darf den Anmeldestatus des ersten Fensters nicht übernehmen. Das Verbergen einer Schaltfläche schützt kein Dokument; ein Server muss die Autorisierung prüfen, bevor er private Inhalte zurückgibt.

  • Fälle mit falschem Code und abgemeldetem Zustand bleiben nicht authentifiziert.
  • Eine gültige Sitzung bleibt wie konfiguriert erhalten, und die Clientabmeldung wird ehrlich geprüft.

War diese Lektion hilfreich?

Hinterlasse ein Like oder teile sie mit jemandem, dem sie helfen könnte.

Weiterlernen

Weitere Lektionen entdecken