이메일 링크 인증은 이전에 Firebase Dynamic Links를 사용했으며 이 기능은 2025년 8월 25일에 종료됩니다. Firebase Authentication iOS SDK 버전 11.8.0 이상에 대체 솔루션이 게시되었습니다. 앱에서 Firebase Dynamic Links를 사용하는 경우 앱을 새 Firebase Hosting 기반 시스템으로 마이그레이션해야 합니다.
연결된 Firebase Dynamic Links 도메인을 Firebase Hosting 도메인으로 마이그레이션
앞으로 Firebase Authentication은 Firebase Dynamic Links 도메인을 사용하는 대신 프로젝트의 Firebase Hosting 기본 도메인을 사용하여 모바일 앱에서 이메일 링크 및 기타 대역 외 링크 작업의 링크를 만듭니다. 즉, 이 기본 도메인을 모바일 앱의 이메일 인증 링크에 연결된 도메인으로 사용하도록 앱도 업데이트해야 합니다.
다음 안내에 따라 새 도메인의 링크를 처리하고 앞으로 Firebase Authentication에서 Firebase Hosting 도메인을 사용하여 모바일 앱 링크를 생성하도록 지시합니다.
커스텀 Firebase Hosting 도메인 또는 커스텀 Firebase Dynamic Links 도메인을 새 연결 도메인으로 계속 사용하려면 모바일 링크 맞춤설정 섹션의 안내에 따라 사용할 도메인에 맞게 단계를 조정하세요.
Firebase Hosting 도메인을 앱 연결 도메인에 연결합니다.
선택한 도메인을 앱 링크의 연결된 도메인으로 구성해야 합니다. 앱에서 사용 권한을 설정하려면 Xcode에서 대상의 서명 및 기능 탭을 열고 이전 단계의 Firebase Hosting 도메인을 연결된 도메인 기능에 추가합니다. 기본 Firebase Hosting 도메인을 사용하는 경우 applinks:PROJECT_ID.firebaseapp.com입니다.
연결된 도메인 파일이 모든 Firebase Hosting 도메인에 배포되었습니다. 액세스하려면 PROJECT_ID.firebaseapp.com/.well-known/apple-app-site-association으로 이동하세요.
이 AASA 파일은 덮어쓸 수 있습니다. 자세한 내용은 범용 링크 구성 파일 만들기 및 호스팅을 참조하세요.
새 링크를 사용하도록 프로젝트를 구성합니다.
새 도메인 링크를 처리할 준비가 되면 Firebase Admin SDK를 사용하여 이메일 링크 생성 방식을 업데이트하고 백엔드에 새 Firebase Hosting 도메인을 사용하여 링크 생성을 시작하도록 지시할 수 있습니다.
constupdateRequest={mobileLinksConfig:{domain:'HOSTING_DOMAIN'}}constupdateProjectConfig=()=>{projectConfigManager.updateProjectConfig(updateRequest).then((response)=>{// updated project config}).catch((error)=>{console.log('Error updating the project:',error);});}
이메일 링크를 보내고 사용합니다.
이전과 같이 이메일 로그인 링크를 보냅니다. 최종 사용자가 링크를 클릭하면 앱이 설치된 경우 앱으로 리디렉션되어 로그인을 완료하게 됩니다.
모바일 링크 맞춤설정
커스텀 Firebase Hosting 도메인을 사용하거나 커스텀 Firebase Dynamic Links 도메인을 재사용하여 새 모바일 링크 도메인으로 만들 수 있습니다.
[null,null,["최종 업데이트: 2025-08-27(UTC)"],[],[],null,["Email link authentication previously relied on Firebase Dynamic Links, which will be\n[shut down on August 25, 2025](/support/dynamic-links-faq). We've published an\nalternative solution in the Firebase Authentication iOS SDK version 11.8.0+. If your\napp uses Firebase Dynamic Links, you should migrate your app to the new\nFirebase Hosting based system.\n\nMigrate your associated Firebase Dynamic Links domain to a Firebase Hosting domain\n\nMoving forward, rather than using a Firebase Dynamic Links domain, Firebase Authentication\nwill use the Firebase Hosting default domain for your project to create\nlinks for email link and other out-of-band link actions in mobile apps. This\nmeans that your app will also need to be updated to use this default domain as\nthe associated domain for email authentication links to your mobile app.\n\nYou can follow the instructions in\n[Authenticate with Firebase Using Email Link on Apple Platforms](/docs/auth/ios/email-link-auth)\nto update your app to use the new automatically provisioned Firebase Hosting\ndefault domain.\n\nUse the following instructions to handle links from the new domain and to\ninstruct Firebase Authentication to start using the Firebase Hosting domain to\ngenerate mobile app links going forward.\n\nIf you'd like to continue using any of your custom Firebase Hosting domains\nor even your custom Firebase Dynamic Links domain to be your new associated domain,\nusing the instructions in the [Customize Mobile Links](#customize-mobile-links)\nsection, adapt the steps to match the intended domain you'd like to use.\n\n1. **Link Firebase Hosting domain to your app associated domain.**\n\n You'll need to configure the selected domain as an Associated Domain for\n app links. To set up the entitlement in your app, open the target's\n **Signing \\& Capabilities** tab in Xcode and add Firebase Hosting domains\n from the previous step to the Associated Domains capability. If using the\n default Firebase Hosting domain, this will be\n `applinks:`\u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e`.firebaseapp.com`.\n\n See [Supporting associated domains](https://developer.apple.com/documentation/xcode/supporting-associated-domains)\n on Apple's documentation site for more information.\n\n An associated domain file has been deployed under all your\n Firebase Hosting domains. To access it, navigate to\n \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e`.firebaseapp.com/.well-known/apple-app-site-association`.\n This AASA file can be overwritten; see\n [Create and host your Universal Links configuration files](/support/guides/app-links-universal-links#create_and_host_your_universal_links_configuration_files_on_your_new_hosting_domain)\n for more information.\n | **Important:** To ensure a seamless rollback, we recommend keeping your existing intent filter that handles Firebase Dynamic Links while trying out the Firebase Hosting link solution. The Firebase Dynamic Links solution will be available until August 25, 2025.\n2. **Configure your project to use the new links.**\n\n When you're ready to handle the new domain links, you can use the\n [Firebase Admin SDK](/docs/admin/setup) to update how you want email links\n to be generated and instruct our backend to start generating links using the\n new Firebase Hosting domain. \n\n const updateRequest = {\n mobileLinksConfig: {\n domain: 'HOSTING_DOMAIN'\n }\n }\n const updateProjectConfig = () =\u003e {\n projectConfigManager.updateProjectConfig(updateRequest)\n .then((response) =\u003e {\n // updated project config\n }).catch((error) =\u003e {\n console.log('Error updating the project:', error);\n });\n }\n\n | **Important:** To rollback to the Firebase Dynamic Links while implementing and testing the backup solution, you should set the domain back to `FIREBASE_DYNAMIC_LINK`. The Firebase Dynamic Links solution will be available until August 25, 2025.\n3. **Send and redeem the email link.**\n\n Send the email sign-in link as before. When an end user clicks on the link,\n they will be redirected to the app if installed to finish the sign in.\n\nCustomize your mobile links\n\nYou can use a custom Firebase Hosting domain or reuse your custom\nFirebase Dynamic Links domain to be your new mobile links domain.\n\nUse a custom Firebase Hosting domain\n\n1. Follow the [Firebase Hosting guide](/docs/hosting/custom-domain) to set up a custom domain.\n2. Link the custom domain to your app associated domain.\n3. [Send an authentication link to the user's email address](/docs/auth/ios/email-link-auth#send_an_authentication_link_to_the_users_email_address) with an updated `ActionCodeSettings` object with a custom domain as `linkDomain`.\n\nRe-use your custom Firebase Dynamic Links domain\n\n1. You can re-use any of your Firebase Dynamic Links domains as your custom domain. However, any Firebase Dynamic Links functionality will no longer be supported (for example, users cannot be redirected to the app store if app isn't installed on their device).\n2. [Send an authentication link to the user's email address](/docs/auth/ios/email-link-auth#send_an_authentication_link_to_the_users_email_address) with an updated `ActionCodeSettings` object with a custom domain as `linkDomain`."]]