انتقال ورود به سیستم با پیوند ایمیل از «پیوندهای پویای Firebase»‏ (iOS)

اصالت‌سنجی پیوند ایمیل قبلاً به Firebase Dynamic Links متکی بود که در ۲۵ اوت ۲۰۲۵ بسته خواهد شد. راهکار جایگزینی در نسخه 11.8.0+ کیت توسعه نرم‌افزار iOS Firebase Authentication منتشر کرده‌ایم. اگر برنامه‌تان از Firebase Dynamic Links استفاده می‌کند، باید برنامه‌تان را به سیستم جدید Firebase Hosting مبتنی بر سیستم منتقل کنید.

دامنه Firebase Dynamic Links منسوب خود را به دامنه Firebase Hosting انتقال دهید

ازاین‌پس، به‌جای استفاده از دامنه Firebase Dynamic Links، Firebase Authentication از دامنه پیش‌فرض Firebase Hosting برای پروژه شما استفاده خواهد کرد تا پیوندهایی برای کنش‌های پیوند ایمیل و دیگر کنش‌های پیوند خارج از باند در برنامه‌های تلفن همراه ایجاد کند. این یعنی برنامه شما نیز باید به‌روز شود تا از این دامنه پیش‌فرض به‌عنوان دامنه مرتبط برای پیوندهای اصالت‌سنجی ایمیل به برنامه تلفن همراهتان استفاده کند.

می‌توانید دستورالعمل‌های احراز هویت با Firebase بااستفاده از پیوند ایمیل در پلاتفرم‌های Apple را دنبال کنید تا برنامه‌تان را به‌روز کنید و از دامنه پیش‌فرض Firebase Hosting جدید که به‌طور خودکار آماده شده است استفاده کنید.

از دستورالعمل‌های زیر برای مدیریت پیوندهای دامنه جدید و برای دستور دادن به Firebase Authentication برای شروع استفاده از دامنه Firebase Hosting برای تولید پیوندهای برنامه تلفن همراه در آینده استفاده کنید.

اگر می‌خواهید همچنان از هریک از دامنه‌های سفارشی Firebase Hosting خود یا حتی دامنه سفارشی Firebase Dynamic Links خود به‌عنوان دامنه منسوب جدید استفاده کنید، بااستفاده از دستورالعمل‌های بخش سفارشی‌سازی پیوندهای تلفن همراه، مراحل را با دامنه موردنظرتان که می‌خواهید استفاده کنید تطبیق دهید.

  1. دامنه Firebase Hosting را به دامنه منسوب به برنامه‌تان پیوند دهید.

    باید دامنه انتخابی را به‌عنوان «دامنه منسوب» برای پیوندهای برنامه پیکربندی کنید. برای راه‌اندازی حق در برنامه‌تان، برگه امضا و قابلیت‌ها هدف را در Xcode باز کنید و Firebase Hosting دامنه را از مرحله قبلی به قابلیت «دامنه‌های مرتبط» اضافه کنید. اگر از دامنه پیش‌فرض Firebase Hosting استفاده می‌کنید، این مقدار applinks:PROJECT_ID.firebaseapp.com خواهد بود.

    برای اطلاعات بیشتر، پشتیبانی از دامنه‌های منسوب در سایت اسناد Apple را ببینید.

    فایل دامنه منسوب تحت همه دامنه‌های Firebase Hosting شما مستقر شده است. برای دسترسی به آن، به PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association بروید. این فایل AASA می‌تواند رونویسی شود؛ برای اطلاعات بیشتر، ایجاد و میزبانی فایل‌های پیکربندی «پیوندهای جهانی» را ببینید.

  2. پروژه‌تان را پیکربندی کنید تا از پیوندهای جدید استفاده کند.

    وقتی آماده رسیدگی به پیوندهای دامنه جدید شدید، می‌توانید از کیت توسعه نرم‌افزار Firebase Admin برای به‌روزرسانی نحوه تولید پیوندهای ایمیل استفاده کنید و به زیرینه ما دستور دهید که تولید پیوندها را بااستفاده از دامنه جدید Firebase Hosting شروع کند.

    import { getAuth } from 'firebase-admin/auth';

const updateEmailAuthDomain = async () => {
    const updateRequest = {
        mobileLinksConfig: {
            domain: 'HOSTING_DOMAIN',
        },
    };

    const projectConfigManager = getAuth().projectConfigManager();

    try {
        const response = await projectConfigManager.updateProjectConfig(updateRequest);
        // Updated project config
        console.log('Project configuration updated successfully:', response);
    } catch (error) {
        console.error('Error updating the project:', error);
    }
};

  3. پیوند ایمیل را ارسال و پس‌خرید کنید.

    پیوند ورود به سیستم ایمیل را مثل قبل ارسال کنید. وقتی کاربر نهایی روی پیوند کلیک می‌کند، اگر برنامه نصب شده باشد، برای تکمیل ورود به سیستم به برنامه هدایت می‌شود.

می‌توانید از دامنه سفارشی Firebase Hosting استفاده کنید یا دامنه سفارشی Firebase Dynamic Links خودتان را دوباره استفاده کنید تا دامنه پیوندهای تلفن همراه جدیدتان باشد.

استفاده از دامنه سفارشی Firebase Hosting

  1. برای راه‌اندازی دامنه سفارشی، راهنمای Firebase Hosting را دنبال کنید.
  2. دامنه سفارشی را به دامنه منسوب به برنامه پیوند دهید.
  3. پیوند اصالت‌سنجی به نشانی ایمیل کاربر ارسال کنید با شیء ActionCodeSettings به‌روزشده با دامنه سفارشی به‌عنوان linkDomain.
  1. می‌توانید از هریک از دامنه‌های Firebase Dynamic Links به‌عنوان دامنه سفارشی خود استفاده مجدد کنید. بااین‌حال، هرگونه عملکرد Firebase Dynamic Links دیگر پشتیبانی نخواهد شد (برای مثال، اگر برنامه روی دستگاه کاربر نصب نشده باشد، نمی‌توان کاربران را به فروشگاه برنامه هدایت کرد).
  2. پیوند اصالت‌سنجی به نشانی ایمیل کاربر ارسال کنید با شیء ActionCodeSettings به‌روزشده با دامنه سفارشی به‌عنوان linkDomain.