Możesz użyć Firebase Authentication, aby umożliwić użytkownikom uwierzytelnianie w Firebase za pomocą adresów e-mail i haseł oraz zarządzać kontami opartymi na hasłach w aplikacji.
prompt AI dla pomocy AI
Aby uzyskać pomoc AI, skopiuj poniższego prompta do swojego asystenta kodowania AI (takiego jak Antigravity, Claude Code, Codex czy Cursor). Możesz dostosować prompta i wprowadzać zmiany z agentem. Szczegółowe informacje o instalacji znajdziesz w artykule Umiejętności agenta Firebase.
Help me use Firebase in my app.
1. Make sure that **Firebase agent skills** are installed and updated. For Claude Code, Codex, or Cursor agents, help me install the Firebase plugin. For other agents, run `npx skills add firebase/agent-skills`. Always try to use **Firebase agent skills** for Firebase-related tasks.
2. Help me set up and use Firebase Authentication with email and password authentication in my app.
Zanim zaczniesz
- Dodaj Firebase do projektu JavaScript.
- Jeśli aplikacja nie jest jeszcze połączona z projektem w Firebase, zrób to w konsoli Firebase.
-
Włącz adres e-mail i hasło jako dostawcę logowania w projekcie w Firebase:
- W konsoli Firebase otwórz Zabezpieczenia > Uwierzytelnianie.
- Na karcie Metoda logowania włącz dostawcę logowania E-mail/hasło.
- Kliknij Zapisz.
Tworzenie konta opartego na haśle
Aby utworzyć nowe konto użytkownika z hasłem, wykonaj te czynności na stronie rejestracji w aplikacji:
- Gdy nowy użytkownik zarejestruje się za pomocą formularza rejestracji w aplikacji, wykonaj wszystkie wymagane przez aplikację czynności związane z weryfikacją nowego konta, np. sprawdź, czy hasło do nowego konta zostało wpisane prawidłowo i czy spełnia wymagania dotyczące złożoności.
- Utwórz nowe konto, przekazując adres e-mail i hasło nowego użytkownika do
createUserWithEmailAndPassword:Jeśli nowe konto zostało utworzone, użytkownik zostanie automatycznie zalogowany. Aby dowiedzieć się, jak uzyskać szczegółowe informacje o zalogowanym użytkowniku, zapoznaj się z sekcją Dalsze kroki poniżej.Web
import { getAuth, createUserWithEmailAndPassword } from "firebase/auth"; const auth = getAuth(); createUserWithEmailAndPassword(auth, email, password) .then((userCredential) => { // Signed up const user = userCredential.user; // ... }) .catch((error) => { const errorCode = error.code; const errorMessage = error.message; // .. });
Web
firebase.auth().createUserWithEmailAndPassword(email, password) .then((userCredential) => { // Signed in var user = userCredential.user; // ... }) .catch((error) => { var errorCode = error.code; var errorMessage = error.message; // .. });
W tym miejscu możesz też wykrywać i obsługiwać błędy. Listę kodów błędów znajdziesz w dokumentacji dotyczącej uwierzytelniania.
Logowanie użytkownika za pomocą adresu e-mail i hasła
Czynności związane z logowaniem użytkownika za pomocą hasła są podobne do czynności związanych z tworzeniem nowego konta. Na stronie logowania w aplikacji wykonaj te czynności:
- Gdy użytkownik loguje się w aplikacji, przekaż jego adres e-mail i hasło do
signInWithEmailAndPassword:Aby dowiedzieć się, jak uzyskać szczegółowe informacje o zalogowanym użytkowniku, zapoznaj się z sekcją Dalsze kroki poniżej.Web
import { getAuth, signInWithEmailAndPassword } from "firebase/auth"; const auth = getAuth(); signInWithEmailAndPassword(auth, email, password) .then((userCredential) => { // Signed in const user = userCredential.user; // ... }) .catch((error) => { const errorCode = error.code; const errorMessage = error.message; });
Web
firebase.auth().signInWithEmailAndPassword(email, password) .then((userCredential) => { // Signed in var user = userCredential.user; // ... }) .catch((error) => { var errorCode = error.code; var errorMessage = error.message; });
W tym miejscu możesz też wykrywać i obsługiwać błędy. Listę kodów błędów znajdziesz w dokumentacji dotyczącej uwierzytelniania.
Zalecane: ustaw zasady dotyczące haseł
Możesz zwiększyć bezpieczeństwo kont, egzekwując wymogi w zakresie złożoności haseł.
Aby skonfigurować zasady dotyczące haseł w projekcie, otwórz sekcję Zasady dotyczące haseł na karcie Zabezpieczenia > Uwierzytelnianie > Ustawienia w konsoli Firebase:
Zasady dotyczące haseł w Firebase Authentication obsługują te wymagania:
Wymagana jest mała litera
Wymagana jest wielka litera
Wymagana cyfra
Wymagany jest znak niealfanumeryczny
Wymagania dotyczące znaków niealfanumerycznych spełniają te znaki:
^ $ * . [ ] { } ( ) ? " ! @ # % & / \ , > < ' : ; | _ ~Minimalna długość hasła (od 6 do 30 znaków, domyślnie 6)
Maksymalna długość hasła (maksymalnie 4096 znaków)
Egzekwowanie zasad dotyczących haseł możesz włączyć w 2 trybach:
Wymagaj: rejestracja nie będzie możliwa, dopóki użytkownik nie zmieni hasła zgodnie z zasadami.
Powiadom: użytkownicy mogą rejestrować się przy użyciu haseł, które nie spełniają wymogów. W tym trybie należy sprawdzić, czy hasło użytkownika jest zgodne z zasadami po stronie klienta, i w razie potrzeby poprosić użytkownika o zaktualizowanie hasła.
Nowi użytkownicy zawsze muszą wybrać hasło zgodne z Twoimi zasadami.
Jeśli masz aktywnych użytkowników, zalecamy, aby nie włączać wymuszonego uaktualnienia przy logowaniu, chyba że chcesz zablokować dostęp użytkownikom, których hasła nie są zgodne z zasadami. Zamiast tego użyj trybu powiadamiania, który umożliwia użytkownikom logowanie się przy użyciu bieżących haseł i informuje ich o wymaganiach, których ich hasła nie spełniają.
Weryfikowanie hasła na kliencie
import { getAuth, validatePassword } from "firebase/auth";
const status = await validatePassword(getAuth(), passwordFromUser);
if (!status.isValid) {
// Password could not be validated. Use the status to show what
// requirements are met and which are missing.
// If a criterion is undefined, it is not required by policy. If the
// criterion is defined but false, it is required but not fulfilled by
// the given password. For example:
const needsLowerCase = status.containsLowercaseLetter !== true;
}
Zalecane: włącz ochronę przed wyliczaniem adresów e-mail
Niektóre metody Firebase Authentication, które przyjmują adresy e-mail jako parametry, zgłaszają określone błędy, jeśli adres e-mail jest niezarejestrowany, gdy musi być zarejestrowany (np. podczas logowania się za pomocą adresu e-mail i hasła), lub zarejestrowany, gdy musi być nieużywany (np. podczas zmiany adresu e-mail użytkownika). Może to być pomocne przy sugerowaniu użytkownikom konkretnych rozwiązań, ale może też zostać wykorzystane przez nieuczciwe podmioty do odkrywania adresów e-mail zarejestrowanych przez użytkowników.
Aby zmniejszyć to ryzyko, zalecamy włączenie w projekcie ochrony przed wyliczaniem adresów e-mail. Możesz sprawdzić to ustawienie w konsoli Firebase: otwórz kartę Security (Bezpieczeństwo) > Authentication (Uwierzytelnianie) > Settings (Ustawienia), a następnie kliknij User actions (Działania użytkownika).
Pamiętaj, że włączenie tej funkcji zmienia sposób raportowania błędów w przypadku Firebase Authentication, więc upewnij się, że Twoja aplikacja nie wymaga bardziej szczegółowych błędów.
Dalsze kroki
Gdy użytkownik zaloguje się po raz pierwszy, zostanie utworzone nowe konto użytkownika i połączone z danymi logowania, czyli nazwą użytkownika i hasłem, numerem telefonu lub informacjami o dostawcy uwierzytelniania, za pomocą których użytkownik się zalogował. To nowe konto jest przechowywane w projekcie Firebase i może służyć do identyfikowania użytkownika we wszystkich aplikacjach w projekcie, niezależnie od tego, jak się loguje.
-
W aplikacjach zalecanym sposobem sprawdzenia stanu uwierzytelniania użytkownika jest ustawienie obserwatora w obiekcie
Auth. Następnie możesz pobrać podstawowe informacje o profilu użytkownika z obiektuUser. Zobacz Zarządzanie użytkownikami. W Firebase Realtime Database i Cloud Storageregułach zabezpieczeń możesz pobrać unikalny identyfikator zalogowanego użytkownika ze zmiennej
authi użyć go do kontrolowania, do jakich danych użytkownik ma dostęp.
Możesz zezwolić użytkownikom na logowanie się w aplikacji przy użyciu wielu dostawców uwierzytelniania, łącząc dane logowania dostawcy uwierzytelniania z istniejącym kontem użytkownika.
Aby wylogować użytkownika, wywołaj signOut:
Web
import { getAuth, signOut } from "firebase/auth"; const auth = getAuth(); signOut(auth).then(() => { // Sign-out successful. }).catch((error) => { // An error happened. });
Web
firebase.auth().signOut().then(() => { // Sign-out successful. }).catch((error) => { // An error happened. });