ابرووا
شروع رایگان
☰ فهرست مستندات · صفحه‌های ایمیل میزبانی‌شده

صفحه‌های ایمیل میزبانی‌شده

نمایش Markdown

صفحه‌های خودِ ابرووا احراز هویت برای لینک‌های تأیید ایمیل و بازیابی رمز، مثل e-mail action handler در Firebase: بدون صفحه یا کد در اپ شما، با دکمه‌ی ادامه برای بازگشت به اپ، و لینک‌های یک‌بارمصرفی که اسکنر ایمیل نمی‌تواند مصرفشان کند.

به صفحه‌ای از خودتان نیاز ندارید.

لینک ایمیل‌های تأیید ایمیل و بازیابی رمز، صفحه‌های خودِ ابرووا احراز هویت را باز می‌کنند، مگر اینکه اپ شما redirectUrl بدهد. کاربر همان‌جا ایمیل را تأیید می‌کند یا رمز تازه انتخاب می‌کند و دکمه‌ی ادامه می‌تواند او را به اپ شما برگرداند. در Firebase به این e-mail action handler می‌گویند.

دو صفحه#

صفحهآدرسکارش
تأیید ایمیلhttps://auth-users.abrova.ir/pages/verifyدکمه‌ی «تأیید ایمیل» را نشان می‌دهد؛ با زدن آن ایمیل تأییدشده علامت می‌خورد.
بازیابی رمزhttps://auth-users.abrova.ir/pages/resetرمز تازه را دو بار می‌گیرد و ذخیره می‌کند. همه‌ی نشست‌های کاربر پایان می‌یابد و ایمیل تأییدشده حساب می‌شود.

این آدرس‌ها را خودتان نمی‌سازید: ابرووا احراز هویت آن‌ها را با ?token=… (یک‌بارمصرف) و &lang=… (زبان ایمیل، تا صفحه هم به همان زبان باشد) در ایمیل می‌گذارد. نام هیچ اپی در آن‌ها نیست و کلیدی لازم ندارند: توکن به ابرووا احراز هویت می‌گوید مال کدام پروژه است.

مرحله ۱: لینک‌ها کی این صفحه‌ها را باز می‌کنند#

ایمیلوقتی صفحه‌ی میزبانی‌شده باز می‌شود که
تأیید ایمیل هنگام ثبت‌نامپروژه‌ی شما ایمیل تأییدشده می‌خواهد و redirectUrl نمی‌دهید. بدون این الزام، ثبت‌نام فقط با redirectUrl ایمیل می‌فرستد.
ارسال دوباره‌ی تأییدsendEmailVerification (کاربر واردشده) یا resendVerification (هنوز تأیید نشده) را بدون redirectUrl صدا بزنید.
بازیابی رمزsendPasswordReset را بدون redirectUrl صدا بزنید.
لینک یک‌بارمصرف ورودهرگز: این لینک کاربر را وارد اپ شما می‌کند، پس همیشه redirectUrl خودتان را لازم دارد.

صفحه‌ی ورود آماده هم از این صفحه‌ها استفاده می‌کند، مگر اینکه verifyRedirectUrl یا resetRedirectUrl بدهید.

مرحله ۲: بازگشت به اپ با دکمه‌ی ادامه#

continueUrl را همراه فراخوانی‌ای که ایمیل را می‌فرستد بدهید. وقتی کار صفحه تمام شد، دکمه‌ی ادامه به آن آدرس را نشان می‌دهد: صفحه‌ای از سایت شما، یا لینکی که اپ شما را باز می‌کند (myapp://signed-up).

  1. آدرس را در ابرووا احراز هویت › تنظیمات › آدرس‌های لینک اضافه کنید، مثلاً https://example.com/ یا myapp://. در زمان توسعه می‌توانید http://localhost:<port> را هم اضافه کنید.
  2. آن را به‌عنوان continueUrl بدهید:
typescript
// Web and React Native
await auth.signUpWithEmail({ email, password, continueUrl: 'https://example.com/welcome' });
await auth.sendPasswordReset({ email, continueUrl: 'https://example.com/sign-in' });
await auth.resendVerification({ email, password, continueUrl: 'https://example.com/sign-in' });
dart
// Flutter
await AbrovaAuth.instance.signUpWithEmail(email: email, password: password, continueUrl: 'myapp://welcome');
await AbrovaAuth.instance.sendPasswordReset(email, continueUrl: 'myapp://sign-in');
swift
// iOS
try await AbrovaAuth.shared.signUp(email: email, password: password, continueURL: "myapp://welcome")
try await AbrovaAuth.shared.sendPasswordReset(email: email, continueURL: "myapp://sign-in")
kotlin
// Android
AbrovaAuth.shared.signUp(email, password, continueUrl = "myapp://welcome")
AbrovaAuth.shared.sendPasswordReset(email, continueUrl = "myapp://sign-in")

در صفحه‌ی ورود آماده، گزینه‌ی continueUrl (در iOS continueURL) را تنظیم کنید تا همه‌ی ایمیل‌هایی که می‌فرستد از آن استفاده کنند.

continueUrlی که زیر یکی از آدرس‌های لینک شما نباشد، پیش از ارسال هر ایمیلی با INVALID_INPUT رد می‌شود. بدون continueUrl صفحه فقط می‌گوید کار تمام شد و کاربر خودش به اپ برمی‌گردد.

به جای آن، صفحه‌ی خودتان#

یک redirectUrl (یکی از آدرس‌های لینک شما) بدهید تا لینک به جای آن، صفحه‌ی شما را با ?token=… باز کند. توکن را بخوانید و کار را با SDK تمام کنید:

لینکفراخوانی با توکن
تأیید ایمیلverifyEmail(token)
بازیابی رمزresetPassword(token, newPassword)

صفحه‌ی خودتان راهی است برای اینکه کاربر از اول تا آخر درون اپ یا سایت شما بماند؛ در این حالت از continueUrl استفاده نمی‌شود.

لینک تأیید به‌طور پیش‌فرض ۲۴ ساعت و لینک بازیابی ۳۰ دقیقه کار می‌کند؛ در قالب‌های ایمیل تغییرشان دهید. هر لینک فقط یک بار کار می‌کند. لینک منقضی یا استفاده‌شده «این پیوند قابل استفاده نیست» را نشان می‌دهد: لینک تازه بفرستید (resendVerification، sendEmailVerification یا sendPasswordReset).

امن از پایه#

  • باز کردن لینک چیزی را تغییر نمی‌دهد. صفحه فقط یک دکمه یا فرم نشان می‌دهد و کار وقتی انجام می‌شود که کاربر آن را بزند. اسکنر ایمیل یا پیش‌نمایش لینک که لینک را باز می‌کند نمی‌تواند آن را مصرف کند.
  • آدرس ادامه دو بار بررسی می‌شود: هنگام ارسال ایمیل و دوباره در خود صفحه، با آدرس‌های لینک شما. دست‌کاری لینک نمی‌تواند کاربران را به سایت دیگری بفرستد.
  • آدرس‌های لینک به‌صورت آدرس مقایسه می‌شوند، نه متن: همان scheme، میزبان و پورت، و مسیری درون آدرس. https://example.com اجازه‌ی https://example.com/welcome را می‌دهد، ولی هرگز https://example.com.other.net را نه.
  • صفحه‌ها هیچ اسکریپتی اجرا نمی‌کنند و چیزی از جای دیگر بار نمی‌کنند، درون frame قرار نمی‌گیرند و هرگز کش نمی‌شوند.
  • بازیابی رمز همه‌ی نشست‌های کاربر را روی همه‌ی دستگاه‌ها پایان می‌دهد.

خطاها#

کدکی
INVALID_INPUTredirectUrl یا continueUrl زیر یکی از آدرس‌های لینک شما نیست.
EMAIL_NOT_VERIFIEDورود پیش از تأیید ایمیل (وقتی پروژه آن را می‌خواهد): resendVerification را پیشنهاد دهید.
TOKEN_INVALIDصفحه‌ی خودتان توکنی فرستاده که منقضی یا استفاده شده است.
RATE_LIMITEDایمیل‌های زیادی در زمان کوتاه به یک آدرس.

قدم‌های بعدی#

این صفحه مفید بود؟
گزارش مشکل

به‌روزرسانی: ۲۵ آبان ۱۴۰۵