ایمیل و رمز عبور

۱راه‌اندازی در کنسول#

1. Abrova Auth › روش‌های ورود: ایمیل و رمز عبور را روشن کنید. کوتاه‌ترین رمز عبور (۸ تا ۱۲۸ کاراکتر، پیش‌فرض ۸) را تعیین کنید و مشخص کنید آیا کاربران پیش از ورود به ایمیل تأییدشده نیاز دارند یا نه.
2. Abrova Auth › تنظیمات › آدرس‌های لینک: آدرس‌هایی را که لینک‌های ایمیلی شما اجازه دارند باز کنند اضافه کنید، مثلاً https://example.com/auth یا myapp://auth. هر کدام باید یک آدرس https:// یا URL scheme خودِ اپ شما باشد.

۲ثبت‌نام#

// Flutter
final result = await AbrovaAuth.instance.signUpWithEmail(
  email: email,
  password: password,
  redirectUrl: 'https://example.com/auth/verify', // optional: sends a verification e-mail
);
if (!result.signedIn) {
  // The project requires a verified e-mail: ask the user to open the link first.
}

// iOS
let result = try await AbrovaAuth.shared.signUp(email: email, password: password,
                                                redirectURL: "https://example.com/auth/verify")

// Android
val result = AbrovaAuth.shared.signUp(email, password, redirectUrl = "https://example.com/auth/verify")

// Web and React Native
const result = await auth.signUpWithEmail({ email, password, redirectUrl: 'https://example.com/auth/verify' });

نتیجه verificationSent (ایمیل تأیید ارسال شده است) و signedIn را به شما می‌گوید. وقتی ایمیل تأییدشده الزامی است روشن باشد، کاربر تا وقتی لینک را باز نکند و سپس وارد نشود، وارد نمی‌شود.

رمز عبور باید دست‌کم به اندازه‌ی کوتاه‌ترین طول تعیین‌شده برای پروژه باشد، حداکثر ۱۲۸ کاراکتر، و جزو رمزهای خیلی رایج نباشد. در غیر این صورت فراخوانی با WEAK_PASSWORD شکست می‌خورد. آدرسی که از قبل حساب دارد با EMAIL_TAKEN شکست می‌خورد.

۳ورود#

رمز اشتباه و ایمیل ناشناخته هر دو با INVALID_CREDENTIALS شکست می‌خورند، تا پاسخ هرگز فاش نکند چه کسی حساب دارد. شکست‌های پشت سر هم برای یک آدرس یا از یک مکان کُند می‌شوند (RATE_LIMITED).

۴تأیید ایمیل#

لینک تأیید، <your link address>?token=... را باز می‌کند و ۲۴ ساعت اعتبار دارد. token را بخوانید و به SDK بدهید:

تأیید فقط ایمیل را تأییدشده علامت می‌زند؛ کاربر را وارد نمی‌کند. برای ارسال دوباره‌ی ایمیل برای کاربرِ واردشده، sendEmailVerification را با یک redirectUrl صدا بزنید.

۵بازیابی رمز عبور فراموش‌شده#

1. sendPasswordReset را با ایمیل و یک redirectUrl صدا بزنید. پاسخ چه آدرس حساب داشته باشد چه نه، یکسان است.
2. ایمیل به <redirectUrl>?token=... لینک می‌دهد که ۳۰ دقیقه اعتبار دارد و فقط یک بار قابل استفاده است.
3. صفحه‌ی «رمز عبور جدید» را نشان دهید و resetPassword را با token و رمز عبور جدید صدا بزنید.

// Flutter
await AbrovaAuth.instance.sendPasswordReset(email, redirectUrl: 'https://example.com/auth/reset');
// ... in the screen the link opens:
await AbrovaAuth.instance.resetPassword(tokenFromLink, newPassword);

بازیابی رمز، همه‌ی نشست‌های کاربر را پایان می‌دهد و ایمیل را تأییدشده علامت می‌زند. کاربر را وارد نمی‌کند: کاربر با رمز عبور جدید وارد می‌شود.

دادن رمز عبور به کاربر ناشناس#

linkPassword یک ایمیل و رمز عبور به کاربرِ واردشده (معمولاً ناشناس) اضافه می‌کند. شناسه همان می‌ماند. وقتی کاربر دیگری آن آدرس را داشته باشد، با EMAIL_TAKEN شکست می‌خورد.

ایمیل‌ها#

Abrova Auth سه ایمیل می‌فرستد: تأیید ایمیل، بازیابی رمز عبور و لینک یک‌بارمصرف. نام پروژه‌ی شما در آن‌ها می‌آید و از آدرس ابرووا ارسال می‌شوند. ارسال برای هر آدرس (چند عدد در ساعت) و برای هر پروژه محدود است.

خطاها#