☰ فهرست مستندات · صفحههای ایمیل میزبانیشده
صفحههای ایمیل میزبانیشده
صفحههای خودِ ابرووا احراز هویت برای لینکهای تأیید ایمیل و بازیابی رمز، مثل 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).
- آدرس را در ابرووا احراز هویت › تنظیمات › آدرسهای لینک اضافه کنید، مثلاً
https://example.com/یاmyapp://. در زمان توسعه میتوانیدhttp://localhost:<port>را هم اضافه کنید. - آن را بهعنوان
continueUrlبدهید:
// 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' });// Flutter await AbrovaAuth.instance.signUpWithEmail(email: email, password: password, continueUrl: 'myapp://welcome'); await AbrovaAuth.instance.sendPasswordReset(email, continueUrl: 'myapp://sign-in');
// iOS try await AbrovaAuth.shared.signUp(email: email, password: password, continueURL: "myapp://welcome") try await AbrovaAuth.shared.sendPasswordReset(email: email, continueURL: "myapp://sign-in")
// 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_INPUT | redirectUrl یا continueUrl زیر یکی از آدرسهای لینک شما نیست. |
| EMAIL_NOT_VERIFIED | ورود پیش از تأیید ایمیل (وقتی پروژه آن را میخواهد): resendVerification را پیشنهاد دهید. |
| TOKEN_INVALID | صفحهی خودتان توکنی فرستاده که منقضی یا استفاده شده است. |
| RATE_LIMITED | ایمیلهای زیادی در زمان کوتاه به یک آدرس. |
قدمهای بعدی#
- ایمیل و رمز عبور: ثبتنام، ورود، تأیید و بازیابی.
- صفحهی ورود آماده: کل جریان با یک فراخوانی.
- قالبهای ایمیل: زبان، متن و مدت اعتبار لینک ایمیلها.
بهروزرسانی: ۲۵ آبان ۱۴۰۵