---
title: "صفحه‌های ایمیل میزبانی‌شده"
description: "صفحه‌های خودِ ابرووا احراز هویت برای لینک‌های تأیید ایمیل و بازیابی رمز، مثل e-mail action handler در Firebase: بدون صفحه یا کد در اپ شما، با دکمه‌ی ادامه برای بازگشت به اپ، و لینک‌های یک‌بارمصرفی که اسکنر ایمیل نمی‌تواند مصرفشان کند."
product: auth
language: fa
url: https://abrova.ir/docs/auth/hosted-pages
updated: 2026-11-16
---

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

صفحه‌های خودِ ابرووا احراز هویت برای لینک‌های تأیید ایمیل و بازیابی رمز، مثل 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=…` (زبان ایمیل، تا صفحه هم به همان زبان باشد) در ایمیل می‌گذارد. نام هیچ اپی در آن‌ها نیست و کلیدی لازم ندارند: توکن به ابرووا احراز هویت می‌گوید مال کدام پروژه است.

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

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

[صفحه‌ی ورود آماده](https://abrova.ir/docs/auth/sign-in-ui) هم از این صفحه‌ها استفاده می‌کند، مگر اینکه `verifyRedirectUrl` یا `resetRedirectUrl` بدهید.

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

`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` استفاده نمی‌شود.

## لینک‌ها چقدر کار می‌کنند

لینک تأیید به‌طور پیش‌فرض ۲۴ ساعت و لینک بازیابی ۳۰ دقیقه کار می‌کند؛ در [قالب‌های ایمیل](https://abrova.ir/docs/auth/email-templates#link-lifetime) تغییرشان دهید. هر لینک فقط یک بار کار می‌کند. لینک منقضی یا استفاده‌شده «این پیوند قابل استفاده نیست» را نشان می‌دهد: لینک تازه بفرستید (`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` | ایمیل‌های زیادی در زمان کوتاه به یک آدرس. |

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

- [ایمیل و رمز عبور](https://abrova.ir/docs/auth/email-password): ثبت‌نام، ورود، تأیید و بازیابی.
- [صفحه‌ی ورود آماده](https://abrova.ir/docs/auth/sign-in-ui): کل جریان با یک فراخوانی.
- [قالب‌های ایمیل](https://abrova.ir/docs/auth/email-templates): زبان، متن و مدت اعتبار لینک ایمیل‌ها.
